Objet Array

Article
08/10/2011

Assure la prise en charge de tableaux expando de tous types de données. Le constructeur Array se présente sous trois formes.

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

Arguments

size
Facultatif. Taille du tableau. Les tableaux étant en base zéro, les éléments créés auront des index allant de zéro jusqu'à size -1.
varargs
Facultatif. Tableau typé qui contient tous les paramètres passés au constructeur. Ces paramètres sont utilisés comme premiers éléments du tableau.
array
Facultatif. Tableau à copier vers le tableau en cours de construction.

Notes

Si un seul argument est passé au constructeur Array et que cet argument est un nombre, il doit s'agir d'un nombre entier non signé de 32 bits (tout entier inférieur à environ quatre milliards). La valeur passée est la taille du tableau. Si la valeur est un nombre inférieur à zéro ou n'est pas un entier, une erreur d'exécution se produit.

Il est possible de passer une variable de type de données System.Array au constructeur Array. Vous obtenez un tableau JScript qui est une copie du tableau d'entrée. System.Array ne peut avoir qu'une seule dimension.

Si une seule valeur est passée au constructeur Array et qu'il ne s'agit pas d'un nombre ni d'un tableau, la propriété length est définie à 1, et la valeur du premier élément du tableau (élément 0) devient l'unique argument transmis. Si plusieurs arguments sont passés au constructeur, la longueur du tableau est définie au nombre d'arguments et ces arguments constitueront les premiers éléments du nouveau tableau.

Notez que les tableaux JScript sont des tableaux d'analyse. En d'autres termes, vous pouvez allouer à un tableau plusieurs éléments, mais seuls ceux qui contiennent effectivement des données auront une existence. Cela réduit la quantité de mémoire utilisée par le tableau.

L'objet Array interagit avec le type de données System.Array. Dès lors, un objet Array peut appeler les méthodes et propriétés du type de données System.Array et à l'inverse, un type de données System.Array peut appeler les méthodes et propriétés de l'objet Array. Par ailleurs, les objets Array sont acceptés par des fonctions qui utilisent des types de données System.Array et inversement. Pour plus d'informations, consultez Array, membres.

Lorsqu'un objet Array est passé à une fonction qui accepte le type de données System.Array ou que des méthodes System.Array sont appelées à partir d'un objet Array, le contenu de l'objet Array est copié. Ainsi, l'objet Array d'origine ne peut pas être modifié par les méthodes System.Array ni s'il est passé à une fonction qui accepte une méthode System.Array. Seules les méthodes Array non destructives peuvent être appelées sur System.Array.

Conseil

L'utilisation d'objets Array est pratique lorsque vous souhaitez obtenir une pile générique ou une liste d'éléments sans vous soucier des performances. Dans tous les autres cas, il est préférable d'utiliser les tableaux typés comme types de données. Un tableau typé, qui offre la plupart des fonctionnalités de l'objet Array, aide à fournir également la sécurité de type, de meilleures performances et une interaction plus grande avec d'autres langages.

Notes

L'objet Array interagit avec le type de données du .NET Framework System.Array dans JScript. En revanche, d'autres langages CLS (Common Language Specification) ne peuvent pas utiliser l'objet Array dans la mesure où JScript .NET est le seul langage à fournir l'objet ; il n'est pas dérivé d'un type du .NET Framework. En conséquence, lors de l'annotation de type des paramètres et des types de retour des méthodes conformes à CLS, assurez-vous d'utiliser le type de données System.Array plutôt que l'objet Array. Vous pouvez néanmoins utiliser l'objet Array pour annoter le type d'identificateurs autres que des paramètres et des types de retour. Pour plus d'informations, consultez Écriture d'un code conforme CLS.

Exemple

Les éléments individuels du tableau sont accessibles à l'aide de la notation [ ]. Par exemple :

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

Les tableaux de Microsoft JScript étant en base zéro, la dernière instruction de l'exemple précédent accède au cinquième élément du tableau. Cet élément contient la valeur 4.