Array.prototype.length

Resumen

La propiedad length representa un entero de 32 bits, sin signo, que especifica el número de elementos en una matriz unidimensional.

Sintaxis

arr.length

Descripción

El valor de la propiedad length es un entero con signo positivo y con valor menor a 2 a la 32 potencia (2³²).

Puedes establecer la propiedad length para truncar una matriz unidimensional en cualquier momento. Cuando extiendes una matriz unidimensional cambiando su propiedad length, el número de elementos reales no aumenta; por ejemplo, si estableces length a 3 cuando en el momento era 2, la matriz unidimensional sigue conteniendo 2 elementos. Así, la propiedad length no dice nada sobre el número de valores definidos en una matriz unidimensional. Ver también Relación entre length y las propiedades numéricas.

Ejemplos

Ejemplo: Iterando sobre una matriz unidimensional

En el siguiente ejemplo, iteramos sobre la matriz unidimensional numbers utilizando la propiedad length para saber cuántos elementos tiene. El valor en cada elemento es entonces duplicado.

var numbers = [1, 2, 3, 4, 5];

for (var i = 0; i < numbers.length; i++) {
  numbers[i] *= 2;
}
// numbers is now [2, 4, 6, 8, 10]

Ejemplo: Acortando una matriz unidimensional

El siguiente ejemplo acorta al la matriz unidimensional statesUS a una longitud de 50 si la longitud actual es mayor que 50.

if (statesUS.length > 50) {
  statesUS.length = 50;
}

Especificaciones

Compatibilidad de Navegadores

Ver también

• Array