Array (Objeto)

Artículo
10/07/2008

Actualización: noviembre 2007

Proporciona compatibilidad con matrices expando de cualquier tipo de datos. Existen tres formas del constructor Array:

function Array( [size : int] )
function Array( [... varargs : Object[]] ) 
function Array( [array : System.Array )

Argumentos

size
Opcional. Se refiere al tamaño de la matriz. Como las matrices tienen base cero, los elementos creados tendrán índices desde cero hasta size -1.
varargs
Opcional. Matriz con tipo que contiene todos los parámetros pasados al constructor. Estos parámetros se utilizan como primeros elementos de la matriz.
array
Opcional. Matriz que se copiará a la matriz que se va a construir.

Comentarios

Si sólo se pasa un argumento al constructor Array y, además, es un número, deberá ser un entero de 32 bits sin signo (cualquier entero por debajo de cuatro mil millones, aproximadamente). El valor que se pase será el tamaño de la matriz. Si el valor es un número menor que cero o no es un entero, se producirá un error en tiempo de ejecución.

Se puede pasar una variable de tipo de datos System.Array al constructor Array, con lo que se generará una matriz JScript que será copia de la matriz de entrada. System.Array deberá tener una sola dimensión.

Si se pasa un único valor al constructor Array y no es un número ni una matriz, la propiedad length de la matriz se definirá como 1 y el valor del primer elemento de la matriz (elemento 0) se convertirá en el único argumento pasado. Si se pasan varios argumentos al constructor, la longitud de la matriz se establecerá en el número de argumentos y estos argumentos serán los primeros elementos de la nueva matriz.

Tenga en cuenta que las matrices JScript son matrices dispersas, es decir, que aunque se pueda asignar una matriz con muchos elementos, sólo existirán aquellos que realmente contengan datos. Esto reduce la cantidad de memoria utilizada por la matriz.

El objeto Array interactúa con el tipo de datos System.Array. Por tanto, un objeto Array puede llamar a los métodos y propiedades del tipo de datos System.Array; asimismo, un tipo de datos System.Array puede llamar a los métodos y propiedades del objeto Array. Más aún, los objetos Array son aceptados por funciones que toman tipos de datos System.Array y viceversa. Para obtener más información, vea Miembros de matrices.

Cuando se pasa un objeto Array a una función que toma un método System.Array o cuando se llama a métodos System.Array desde un objeto Array, se copia el contenido del objeto Array. Por tanto, el objeto Array no se puede modificar con los métodos System.Array, ni tampoco pasándolo a una función que acepte un método System.Array. Desde System.Array sólo se puede llamar a los métodos Array no destructivos.

Sugerencia:
Los objetos Array son cómodos cuando se desea una pila genérica o una lista de elementos y el rendimiento no es una prioridad. En los demás contextos, se deben utilizar los tipos de datos de matriz con tipo. Una matriz con tipo, cuya funcionalidad es muy similar a la del objeto Array, ayuda también a proporcionar seguridad de tipos, mejoras en el rendimiento y una mejor interacción con otros lenguajes.

Los objetos Array son cómodos cuando se desea una pila genérica o una lista de elementos y el rendimiento no es una prioridad. En los demás contextos, se deben utilizar los tipos de datos de matriz con tipo. Una matriz con tipo, cuya funcionalidad es muy similar a la del objeto Array, ayuda también a proporcionar seguridad de tipos, mejoras en el rendimiento y una mejor interacción con otros lenguajes.

Nota:
El objeto Array interopera con el tipo de datos System.Array de .NET Framework en JScript. Sin embargo, otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes) no pueden utilizar el objeto Array porque sólo lo proporciona JScript; no deriva de un tipo de .NET Framework. Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos compatibles con CLS, asegúrese de utilizar el tipo de datos System.Array en lugar del objeto Array. Sin embargo, puede utilizar el objeto Array para anotar el tipo de identificadores que no sean parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código compatible con CLS.

El objeto Array interopera con el tipo de datos System.Array de .NET Framework en JScript. Sin embargo, otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes) no pueden utilizar el objeto Array porque sólo lo proporciona JScript; no deriva de un tipo de .NET Framework. Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos compatibles con CLS, asegúrese de utilizar el tipo de datos System.Array en lugar del objeto Array. Sin embargo, puede utilizar el objeto Array para anotar el tipo de identificadores que no sean parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código compatible con CLS.

Ejemplo

Se puede tener acceso a elementos concretos de la matriz utilizando la notación [ ]. Por ejemplo:

var my_array = new Array();
for (var i = 0; i < 10; i++) {
   my_array[i] = i;
}
var x = my_array[4];

Dado que las matrices en Microsoft JScript tienen base cero, la instrucción final del ejemplo anterior toma el quinto elemento de la matriz. Ese elemento contiene el valor 4.