Vector  - AS3

Indique si la propriété length du vecteur peut être modifiée. Si la valeur est définie sur true, la propriété length ne peut pas être modifiée. Cela signifie que les opérations suivantes ne sont pas autorisées lorsque fixed est true :

• réglage direct de la propriété length ;
• attribution d’une valeur à la position d’index length ;
• appel d’une méthode qui modifie la propriété length, notamment :
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (si l’appel de la méthode splice() change la propriété length du vecteur).

Plage des index disponibles dans le vecteur. Une occurrence de Vector a des positions d’index jusqu’à la valeur length (mais sans l’inclure).

Chaque élément du vecteur possède toujours une valeur qui correspond à une occurrence du type de base ou à la valeur null. Lorsque la propriété length est définie sur une valeur supérieure à sa valeur précédente, d’autres éléments sont créés et remplis avec la valeur par défaut correspondant au type de base (null pour les types de référence).

Lorsque la propriété length est définie sur une valeur inférieure à sa valeur précédente, tous les éléments à des positions d’index supérieures ou égales à la nouvelle valeur length sont supprimés du vecteur.

Crée un vecteur avec le type de base spécifié.

Lorsque vous appelez le constructeur Vector<T>(), spécifiez le type de base à l’aide de la syntaxe de paramètres de type. La syntaxe de paramètres de type est une séquence constituée d’un point (.), d’un chevron gauche (<), du nom de la classe, puis d’un chevron droit (>), comme l’indique l’exemple suivant :

     var v:Vector.<String> = new Vector.<String>();
     

Pour créer une occurrence de Vector à partir d’un tableau ou d’un autre vecteur (notamment avec un type de base différent), utilisez la fonction globale Vector().

Pour créer une occurrence de Vector préremplie, utilisez la syntaxe suivante au lieu d’utiliser les paramètres spécifiés ci-dessous :

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

Les informations ci-dessous s’appliquent à la syntaxe suivante :

• Elle est prise en charge dans Flash Professional CS5 et versions ultérieures, Flash Builder 4 et versions ultérieures, et Flex 4 et versions ultérieures.
• La virgule à droite est facultative.
• Les éléments vides dans le tableau ne sont pas pris en charge ; une instruction telle que var v:Vector.<int> = new <int>[0,,2,] renvoie une erreur de compilateur.
• Vous ne pouvez pas spécifier de longueur par défaut pour l’occurrence de Vector. Au lieu de cela, la longueur est identique au nombre d’éléments dans la liste d’initialisation.
• Vous ne pouvez pas indiquer si l’occurrence de Vector a une longueur fixe. Utilisez plutôt la propriété fixed.
• Une perte de données ou des erreurs peuvent se produire si les éléments transmis en tant que valeurs ne correspondent pas au type spécifié. Par exemple :

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

Eléments de l’API associés

Concatène les vecteurs spécifiés dans la liste des paramètres avec les éléments contenus dans ce vecteur et crée un nouveau vecteur. Les vecteurs dans la liste des paramètres doivent avoir le même type de base ou sous-type que ce vecteur. Si vous ne transmettez aucun paramètre, le vecteur renvoyé est une duplication (clone simple) du vecteur d’origine.

Paramètres

Plus d’exemples

Exécute une fonction de test sur chaque élément du vecteur jusqu’à ce que l’un d’eux renvoie false pour la fonction spécifiée. Cette méthode vous permet de déterminer si tous les éléments d’un vecteur répondent à un critère défini, tel que des valeurs inférieures à un nombre spécifique.

Avec cette méthode, le second paramètre, thisObject, doit être réglé sur null si le premier paramètre, callback, est une fermeture de méthode. C’est ainsi que cette méthode est le plus souvent utilisée.

Néanmoins, supposons que vous créiez une fonction sur une image du scénario principal à l’aide de Flash Professional et que vous souhaitiez qu’elle soit appelée dans un contexte this différent :

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Supposons que vous utilisiez ensuite la méthode every() sur un vecteur appelé myVector :

    myVector.every(myFunction, someObject);
    

Etant donné que myFunction appartient à la classe principale du fichier SWF, elle ne peut pas être exécutée dans un contexte this différent. Les moteurs d’exécution de Flash renvoient un exception lors de l’exécution de ce code. Pour éviter le renvoi de cette erreur d’exécution, affectez la fonction à une variable, comme suit :

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

Paramètres

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Eléments de l’API associés

Exécute une fonction de test sur chaque élément du vecteur et construit un nouveau vecteur contenant tous les éléments qui renvoient true pour la fonction spécifiée. Si un élément renvoie false, il ne figure pas dans le vecteur résultant. Le type de base du vecteur renvoyé correspond à celui du vecteur pour lequel la méthode est appelée.

Avec cette méthode, le second paramètre, thisObject, doit être réglé sur null si le premier paramètre, callback, est une fermeture de méthode. C’est ainsi que cette méthode est le plus souvent utilisée.

Néanmoins, supposons que vous créiez une fonction sur une image du scénario principal à l’aide de Flash Professional et que vous souhaitiez qu’elle soit appelée dans un contexte this différent :

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Supposons que vous utilisiez ensuite la méthode filter() sur un vecteur appelé myVector :

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

Etant donné que myFunction appartient à la classe principale du fichier SWF, elle ne peut pas être exécutée dans un contexte this différent. Les moteurs d’exécution de Flash renvoient un exception lors de l’exécution de ce code. Pour éviter le renvoi de cette erreur d’exécution, affectez la fonction à une variable, comme suit :

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

Paramètres

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

Eléments de l’API associés

Exécute une fonction sur chaque élément du vecteur.

Avec cette méthode, le second paramètre, thisObject, doit être réglé sur null si le premier paramètre, callback, est une fermeture de méthode. C’est ainsi que cette méthode est le plus souvent utilisée.

Néanmoins, supposons que vous créiez une fonction sur une image du scénario principal à l’aide de Flash Professional et que vous souhaitiez qu’elle soit appelée dans un contexte this différent :

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

Supposons que vous utilisiez ensuite la méthode forEach() sur un vecteur appelé myVector :

     myVector.forEach(myFunction, someObject);
     

Etant donné que myFunction appartient à la classe principale du fichier SWF, elle ne peut pas être exécutée dans un contexte this différent. Les moteurs d’exécution de Flash renvoient un exception lors de l’exécution de ce code. Pour éviter le renvoi de cette erreur d’exécution, affectez la fonction à une variable, comme suit :

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

Paramètres

function callback(item:T, index:int, vector:Vector.<T>):void;

Recherche un élément dans le vecteur et renvoie la position d’index de l’élément. L’élément est comparé aux éléments du vecteur à l’aide de l’égalité stricte (===).

Paramètres

Eléments de l’API associés

Insertion d’un élément unique dans le Vecteur. Cette méthode modifie le vecteur sans faire de copie.

Paramètres

Convertit les éléments d’un vecteur en chaînes, insère le séparateur spécifié entre les éléments, les concatène, puis renvoie la chaîne obtenue. Un vecteur imbriqué est toujours séparé par une virgule (,) et non pas par le séparateur transmis à la méthode join().

Paramètres

Plus d’exemples

Eléments de l’API associés

Recherche un élément dans le vecteur, en travaillant à rebours à partir de la position d’index spécifiée, puis renvoie la position d’index de l’élément correspondant. L’élément est comparé aux éléments du vecteur à l’aide de l’égalité stricte (===).

Paramètres

Eléments de l’API associés

Exécute une fonction sur chaque élément du vecteur, puis renvoie un nouveau vecteur avec les éléments correspondants aux résultats de l’appel de fonction sur chaque élément de ce vecteur. Le vecteur résultant possède le même type de base et la même propriété length que le vecteur d’origine. L’élément qui occupe la position d’index i dans le vecteur obtenu est le résultat de l’appel de l’élément qui occupe la position d’index i dans le vecteur d’origine.

Avec cette méthode, le second paramètre, thisObject, doit être réglé sur null si le premier paramètre, callback, est une fermeture de méthode. C’est ainsi que cette méthode est le plus souvent utilisée.

Néanmoins, supposons que vous créiez une fonction sur une image du scénario principal à l’aide de Flash Professional et que vous souhaitiez qu’elle soit appelée dans un contexte this différent :

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

Supposons que vous utilisiez ensuite la méthode map() sur un vecteur appelé myVector :

     myVector.map(myFunction, someObject);
     

Etant donné que myFunction appartient à la classe principale du fichier SWF, elle ne peut pas être exécutée dans un contexte this différent. Les moteurs d’exécution de Flash renvoient un exception lors de l’exécution de ce code. Pour éviter le renvoi de cette erreur d’exécution, affectez la fonction à une variable, comme suit :

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

Paramètres

function callback(item:T, index:int, vector:Vector.<T>):T;

Eléments de l’API associés

Supprime le dernier élément du vecteur et renvoie cet élément. La propriété length du vecteur est diminuée d’une unité lorsque cette fonction est appelée.

Plus d’exemples

Eléments de l’API associés

Ajoute un ou plusieurs éléments à la fin d’un vecteur et renvoie la nouvelle longueur du vecteur.

Etant donné que cette fonction peut accepter plusieurs arguments, le type de données des arguments n’est pas vérifié au moment de la compilation, même en mode strict. En revanche, si un argument n’étant pas une occurrence du type de base est transmis, une exception se produit au moment de l’exécution.

Paramètres

Plus d’exemples

Eléments de l’API associés

Suppression d’un élément unique du Vecteur. Cette méthode modifie le vecteur sans faire de copie.

Paramètres

Inverse l’ordre les éléments dans le vecteur. Cette méthode modifie le vecteur pour lequel elle est appelée.

Plus d’exemples

Supprime le premier élément du vecteur et renvoie cet élément. Les éléments restants du vecteur sont décalés de leur position d’origine, i, vers i -1.

Plus d’exemples

Eléments de l’API associés

Renvoie un nouveau vecteur constitué d’un éventail d’éléments issus du vecteur d’origine, sans modifier ce dernier. Le vecteur renvoyé inclut l’élément startIndex et tous les éléments, excepté l’élément endIndex.

Si vous ne transmettez aucun paramètre, le nouveau vecteur est une duplication (clone simple) du vecteur d’origine. Si vous transmettez une valeur de 0 pour les deux paramètres, un nouveau vecteur vide de même type que le vecteur d’origine est créé.

Paramètres

Plus d’exemples

Exécute une fonction de test sur chaque élément du vecteur jusqu’à ce que l’un d’eux renvoie true. Cette méthode vous permet de déterminer si un élément du vecteur répond au critère défini, tel qu’une valeur inférieure à un nombre spécifique.

Avec cette méthode, le second paramètre, thisObject, doit être réglé sur null si le premier paramètre, callback, est une fermeture de méthode. C’est ainsi que cette méthode est le plus souvent utilisée.

Néanmoins, supposons que vous créiez une fonction sur une image du scénario principal et que vous souhaitiez qu’elle soit appelée dans un contexte this différent :

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Supposons que vous utilisiez ensuite la méthode some() sur un vecteur appelé myVector :

     myVector.some(myFunction, someObject);
     

Etant donné que myFunction appartient à la classe principale du fichier SWF, elle ne peut pas être exécutée dans un contexte this différent. Les moteurs d’exécution de Flash renvoient un exception lors de l’exécution de ce code. Pour éviter le renvoi de cette erreur d’exécution, affectez la fonction à une variable, comme suit :

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

Paramètres

function callback(item:T, index:int, vector:Vector.<T>):Boolean

Eléments de l’API associés

Trie les éléments dans l’objet vectoriel, et renvoie également un objet vectoriel trié. Cette méthode effectue le tri selon le paramètre sortBehavior, qui est soit une fonction qui compare deux valeurs, soit un ensemble d’options de tri.

Cette méthode prend un seul paramètre parmi les paramètres suivants :

• une fonction qui prend deux arguments du type de base (T) du vecteur et renvoie un nombre :

  function compare(x:T, y:T):Number {}

  La logique de la fonction est que, selon deux éléments x et y, la fonction renvoie l’une des trois valeurs suivantes :

  • un nombre négatif, si x apparaît avant y dans la séquence triée ;
  • 0, si x équivaut à y ;
  • un nombre positif, si x apparaît après y dans la séquence triée.

• un nombre qui est un argument OR au niveau du bit des valeurs suivantes :
  • 1 ou Array.CASEINSENSITIVE
  • 2 ou Array.DESCENDING
  • 4 ou Array.UNIQUESORT
  • 8 ou Array.RETURNINDEXEDARRAY
  • 16 ou Array.NUMERIC

  Si cette valeur est égale à 0, le tri fonctionne de la façon suivante :

  • Le tri tient compte de la casse (Z précède a).
  • Le tri est ascendant (a précède b).
  • Le tableau est modifié afin de refléter l’ordre de tri ; les éléments multiples dont les champs de tri sont identiques sont placés consécutivement dans le tableau trié dans un ordre quelconque.
  • Tous les éléments, quel que soit leur type de données, sont triés comme s’il s’agissait de chaînes : ainsi, 100 précède 99 car « 1 » est une valeur de chaîne inférieure à « 9 ».

Paramètres

Plus d’exemples

Eléments de l’API associés

Ajoute et supprime des éléments dans un vecteur. Cette méthode modifie le vecteur sans faire de copie.

Remarque : pour annuler cette méthode dans une sous-classe de Vector, utilisez ...args pour les paramètres, comme indiqué dans l’exemple ci-dessous :

     public override function splice(...args) {
       // your statements here
     }
     

Paramètres

Plus d’exemples

Renvoie une chaîne représentant les éléments du vecteur spécifié. Chaque élément du vecteur, de la position d’index 0 à la position d’index la plus élevée, est converti en chaîne concaténée et séparé par des virgules. Dans l’implémentation d’ActionScript 3.0, cette méthode renvoie la même valeur que la méthode Vector.toString().

Eléments de l’API associés

Renvoie une chaîne représentant les éléments du vecteur. Chaque élément du vecteur, de la position d’index 0 à la position d’index la plus élevée, est converti en chaîne concaténée et séparé par des virgules. Pour spécifier un séparateur personnalisé, utilisez la méthode Vector.join().

Plus d’exemples

Eléments de l’API associés

Ajoute un ou plusieurs éléments du début d’un vecteur et renvoie la nouvelle longueur du vecteur. Les autres éléments du vecteur sont décalés de leur position d’origine, i, vers i + le nombre de nouveaux éléments.

Etant donné que cette fonction peut accepter plusieurs arguments, le type de données des arguments n’est pas vérifié au moment de la compilation, même en mode strict. En revanche, si un argument n’étant pas une occurrence du type de base est transmis, une exception se produit au moment de l’exécution.

Paramètres

Plus d’exemples

Eléments de l’API associés