Ejemplos de los métodos de Array

Valor que devuelve el método:

Nueva longitud de la matriz:

Matriz actual:

Métodos que modifican la matriz

Los métodos que presento a continuación modifican la matriz inicial, que en nuestro caso va a ser ésta:

    var musas = new Array();
            musas[0] = "Calíope";
            musas[1] = "Erato";
            musas[2] = "Clío";
            musas[3] = "Melpómene";
            musas[4] = "Urania";
            musas[5] = "Talía";
            musas[6] = "Polimnia";    
            

En el panel lateral muestro el valor que devuelve el método cuando se invoca, el valor que adquiere la propiedad length, y el aspecto que presentaría la matriz alterada.

pop

musas.pop()

Poco más que decir. pop() no admite parámetros.

push

musas.push('Euterpe')

Entre los paréntesis se pueden añadir tantos valores como se quiera añadir a la matriz, separados por comas (,).

reverse

musas.reverse()

reverse() tampoco admite parámetros.

shift

musas.shift()

shift() funciona como pop(), pero extrayendo de la matriz el primer elemento.

Como se ve, todos los índices de la matriz se actualizan.

sort

musas.sort()

sort() ordena los elementos de la matriz, tal y como ordena los nombres de archivo un ordenador, es decir:

• Los valores como los de esta matriz se ordenan por orden alfabético.
• Si la matriz consiste en una serie de números, estos se ordenan según las cifras más a la izquierda, de menor a mayor. Así, por ejemplo, una matriz que consista en 200,35,40,1, no se ordenará según el valor de las cifras —1,35,40,200—, sino que sort() devolverá 1,200,35,40.

splice

musas.splice(2,1,'Terpsícore')

splice() es un método especial, cuyo comportamiento depende de los parámetros que se le asignen:

• El primer parámetro es un natural que representa el índice desde el que tiene que empezar a modificar la matriz.
• El segundo es otro natural que indica el número de elementos que debe eliminar o sustituir, contando el inicial (por ello un valor de 0 no modifica nada en absoluto).
• Tras estos dos parámetros, se puede incluir una lista de elementos separados por comas:
  • Si no se incluye ningún elemento, splice() simplemente elimina tantos elementos como se han indicado en el segundo parámetro, tomando como índice inicial el primer parámetro.
  • Si se incluyen menos elementos que el valor del segundo parámetro, rellena los «huecos» disponibles hasta quedarse sin valores, y elimina los que faltan.
  • Si se incluyen más elementos que el valor del segundo parámetro, primero elimina los indicados, y luego inserta todos los elementos proporcionados entre el anterior y el posterior a la sección eliminada. Sin embargo, en este caso splice() no devuelve la ´parte de la matriz seccionada como en los anteriores, sino la nueva longitud.

Compruébelo:

musas.splice(2,2)

musas.splice(2,2,'Terpsícore')

musas.splice(2,2,'Terpsícore','Otra Terpsícore','Otra Terpsícore más')

unshift

musas.unshift('Orfeo','Tamiris')

Como parámetros se puede proporcionar a unshift() una serie de elementos separados por comas, que se añaden al principio de la matriz. Los índices se actualizan en consecuencia, y el método devuelve la nueva longitud.

Métodos que no modifican la matriz

Estos métodos devuelven una representación de la matriz, pero no la modifican.

Vamos a emplear las dos matrices siguientes:

    var titanes = new Array();
        titanes[0] = "Ceo";
        titanes[1] = "Hiperión";
        titanes[2] = "Océano";
        titanes[3] = "Crono";
        titanes[4] = "Japeto";
        titanes[5] = "Crío";
        
    var titanides = new Array();
        titanides[0] = "Febe";
        titanides[1] = "Mnemosine";
        titanides[2] = "Rea";
        titanides[3] = "Temis";
        titanides[4] = "Tetis";
        titanides[5] = "Tea";
            

concat

titanes.concat(titanides)

En este caso he concatenado la segunda matriz a la primera, pero se pueden encadenar una serie de elementos separados por comas, o incluso varias matrices.

Como se puede ver, sin embargo, la matriz titanes no ha sido alterada.

join

titanes.join()

Empleado sin un parámetro, join() devuelve una mera cadena en la que los valores de la matriz están separados por comas. Sin embargo, se puede especificar una cadena que sirva como separador:

titanes.join('-')

slice

titanides.slice(2,4)

slice() extraé una copia de una sección especificada de una matriz, aunque a diferencia de splice() no la modifica.

Para este método el primer parámetro es obligatorio y el segundo opcional:

• Definidos ambos naturales, el primero es el índice desde el que debe comenzarse la copia (se incluye ese elemento en la misma), y el segundo el índice en el que debe detenerse (y este elemento que no se incluye).
• Definido sólo uno, cuenta como el índice desde el que comenzar la copia, que abarcará los elementos hasta el final de la matriz.

titanides.slice(2)

toString

titanides.toString()

Este método es similar a join(), sólo que no admite parámetros, y que el resultado es un objeto String, con sus propias propiedades y métodos.

Localizar un valor en una matriz

Por último, recojo dos métodos muy útiles para localizar valores en una matriz.

    var moiras = new Array();
        moiras[0] = "Cloto";
        moiras[1] = "Laquesis";
        moiras[2] = "Atropo";
        moiras[3] = "Cloto";
            

indexOf

moiras.indexOf('Cloto')

Devuelve el índice del primer elemento que coincide con el parámetro proporcionado.

Si no se da coincidencia, devuelve -1:

moiras.indexOf('Selene')

lastIndexOf

moiras.lastIndexOf('Cloto')

Devuelve el índice del último elemento que coincide con el parámetro proporcionado.

Si no se da coincidencia, también devuelve -1:

moiras.lastIndexOf('Selene')

En realidad estos dos métodos son un poco limitados, pero son útiles precisamente cuando se está comprobando la no existencia de un elemento en una matriz.