Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
Niveau supérieur 

Vector  - AS3

PackageNiveau supérieur
Classepublic dynamic class Vector
HéritageVector Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

La classe Vector vous permet d’accéder à un vecteur et de le manipuler ; un vecteur est un tableau dont les éléments possèdent tous le même type de données. Le type de données des éléments d’un vecteur est appelé le type de base du vecteur. Le type de base peut correspondre à n’importe quelle classe, notamment aux classes intégrées et aux classes personnalisées. Le type de base est spécifié lorsque vous déclarez la variable d’un vecteur et lorsque vous créez une occurrence en appelant le constructeur de classe.

Tout comme pour un tableau, vous pouvez utiliser l’opérateur d’accès au tableau ([]) pour définir ou récupérer la valeur d’un élément Vector. Plusieurs méthodes d’un objet Vector fournissent également des mécanismes permettant de définir et de récupérer les valeurs des éléments. Parmi ces méthodes figurent, notamment : push(), pop(), shift(), unshift(). Les propriétés et les méthodes d’un object Vector sont similaires, voire dans certains cas identiques, aux propriétés et aux méthodes d’un objet Array. Dans la plupart des cas où vous utilisez un objet Array dont tous les éléments possèdent le même type de données, il est préférable d’utiliser une occurrence de l’objet Vector. Toutefois, les occurrences de l’objet Vector sont des tableaux denses. En d’autres termes, ils doivent posséder une valeur (ou être définis sur une valeur null) dans chaque index. Les occurrences d’Array n’ont pas cette même restriction.

Le type de base du vecteur est spécifié à l’aide d’une syntaxe de paramètres de type postfix. 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 :

Dans la première ligne de cet exemple, la variable v est déclarée comme l’occurrence d’un objet Vector.<String>. En d’autres termes, elle représente un vecteur (un tableau) ne pouvant contenir que des occurrences de String et duquel seules des occurrences de String peuvent être récupérées. La deuxième ligne construit une occurrence du même type de vecteur (c’est-à-dire d’un vecteur dont les éléments sont tous des objets String) et l’affecte à v.

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

Une variable déclarée avec le type de données Vector.<T> peut stocker uniquement une occurrence de Vector construite avec le même type de base T. Par exemple, il est impossible d’affecter un vecteur construit en appelant new Vector.<String>() à une variable déclarée avec le type de données Vector.<int>. Les types de base doivent correspondre exactement. Par exemple, le code suivant ne se compile pas, car le type de base de l’objet n’est pas le même que le type de base déclaré de la variable (même si Sprite est une sous-classe de DisplayObject) :

 // This code doesn't compile even though Sprite is a DisplayObject subclass
 var v:Vector.<DisplayObject> = new Vector.<Sprite>();
 

Pour convertir un objet Vector avec un type de base T en un objet Vector d’une super-classe de T, utilisez la fonction globale Vector().

Outre la restriction concernant le type de données, la classe Vector possède d’autres restrictions qui la distinguent de la classe Array :

  • Un vecteur est un tableau dense. Contrairement à un tableau, qui peut posséder des valeurs dans les index 0 et 7 même s’il n’existe aucune valeur dans les positions 1 à 6, un vecteur doit posséder une valeur (ou la valeur null) dans chaque index.
  • La longueur d’un vecteur peut éventuellement être fixe ; en d’autres termes, le nombre d’éléments qu’il contient est invariable.
  • L’accès aux éléments d’un vecteur est défini par ses limites. Vous ne pouvez jamais lire une valeur d’un index supérieur à celui de l’élément final (longueur - 1). Vous ne pouvez jamais définir une valeur avec un index supérieur à l’index final actuel (en d’autres termes, vous pouvez définir une valeur uniquement à l’index existant où à une [longueur] d’index).

Grâce à ses restrictions, un vecteur présente trois avantages principaux par rapport à une occurrence d’Array dont les éléments sont tous des occurrences d’une seule classe :

  • Performances : l’accès à l’élément de tableau et son itération sont beaucoup plus rapides lorsque vous utilisez une occurrence de Vector que lorsque vous utilisez une occurrence d’Array.
  • Sécurité des types : en mode strict, le compilateur peut identifier les erreurs de type de données. Parmi ces erreurs, citons l’affectation d’un type de valeur incorrect à un vecteur ou l’attente d’un type de données incompatible lors de la lecture d’une valeur à partir du vecteur. Notez cependant que lorsque vous utilisez la méthode push() ou unshift() pour ajouter des valeurs à un vecteur, les types de données des arguments ne sont pas vérifiés au moment de la compilation. Ils sont vérifiés au moment de l’exécution.
  • Fiabilité : la vérification de plage du moteur d’exécution (ou la vérification des vecteurs de longueur fixe) augmente de façon significative la fiabilité sur les tableaux.

Plus d’exemples

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  fixed : Boolean
Indique si la propriété length du vecteur peut être modifiée.
Vector
  length : uint
Plage des index disponibles dans le vecteur.
Vector
Méthodes publiques
 MéthodeDéfini par
  
Vector(length:uint = 0, fixed:Boolean = false)
Crée un vecteur avec le type de base spécifié.
Vector
  
concat(... args):Vector.<T>
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.
Vector
  
every(callback:Function, thisObject:Object = null):Boolean
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.
Vector
  
filter(callback:Function, thisObject:Object = null):Vector.<T>
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.
Vector
  
forEach(callback:Function, thisObject:Object = null):void
Exécute une fonction sur chaque élément du vecteur.
Vector
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
  
indexOf(searchElement:T, fromIndex:int = 0):int
Recherche un élément dans le vecteur et renvoie la position d’index de l’élément.
Vector
  
insertAt(index:int, element:T):void
Insertion d’un élément unique dans le Vecteur.
Vector
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
join(sep:String = ","):String
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.
Vector
  
lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
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.
Vector
  
map(callback:Function, thisObject:Object = null):Vector.<T>
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.
Vector
  
pop():T
Supprime le dernier élément du vecteur et renvoie cet élément.
Vector
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
push(... args):uint
Ajoute un ou plusieurs éléments à la fin d’un vecteur et renvoie la nouvelle longueur du vecteur.
Vector
  
removeAt(index:int):T
Suppression d’un élément unique du Vecteur.
Vector
  
Inverse l’ordre les éléments dans le vecteur.
Vector
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
shift():T
Supprime le premier élément du vecteur et renvoie cet élément.
Vector
  
slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
Renvoie un nouveau vecteur constitué d’un éventail d’éléments issus du vecteur d’origine, sans modifier ce dernier.
Vector
  
some(callback:Function, thisObject:Object = null):Boolean
Exécute une fonction de test sur chaque élément du vecteur jusqu’à ce que l’un d’eux renvoie true.
Vector
  
sort(sortBehavior:*):Vector.<T>
Trie les éléments dans l’objet vectoriel, et renvoie également un objet vectoriel trié.
Vector
  
splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>
Ajoute et supprime des éléments dans un vecteur.
Vector
  
Renvoie une chaîne représentant les éléments du vecteur spécifié.
Vector
  
Renvoie une chaîne représentant les éléments du vecteur.
Vector
  
Ajoute un ou plusieurs éléments du début d’un vecteur et renvoie la nouvelle longueur du vecteur.
Vector
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

fixed

propriété
fixed:Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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).



Implémentation
    public function get fixed():Boolean
    public function set fixed(value:Boolean):void

length

propriété 
length:uint

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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.



Implémentation
    public function get length():uint
    public function set length(value:uint):void

Valeur émise
RangeError — Si cette propriété est modifiée alors que fixed est true.
 
RangeError — Si cette propriété est définie sur une valeur supérieure à l’index maximal autorisé (232).
Détails du constructeur

Vector

()Constructeur
public function Vector(length:uint = 0, fixed:Boolean = false)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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
         

Paramètres
length:uint (default = 0) — Longueur initiale (nombre d’éléments) du vecteur. Si ce paramètre est supérieur à zéro, les éléments de vecteur spécifiés sont créés et renseignés avec la valeur par défaut correspondant au type de base (null pour les types de référence).
 
fixed:Boolean (default = false) — Indique si la longueur du vecteur est fixe (true) ou si elle peut être modifiée (false). Il est également possible de définir cette valeur à l’aide de la propriété fixed.

Eléments de l’API associés

Détails de la méthode

concat

()méthode
AS3 function concat(... args):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Zéro ou plusieurs vecteurs de type de base ou de sous-type de ce vecteur.

Valeur renvoyée
Vector.<T> — Un vecteur avec le même type de base que ce vecteur qui contient les éléments correspondants, suivis des éléments des objets Vector dans la liste des paramètres.

Valeur émise
TypeError — Si un argument n’est pas un vecteur de type de base ou ne peut pas être converti en un vecteur de type de base.

Plus d’exemples

every

()méthode 
AS3 function every(callback:Function, thisObject:Object = null):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Fonction à exécuter sur chaque élément du vecteur. Cette fonction est invoquée avec trois arguments : l’élément actuel du vecteur, l’index de l’élément et l’objet Vector :
function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

La fonction de rappel doit renvoyer une valeur booléenne.

 
thisObject:Object (default = null) — Objet auquel se réfère l’identifiant this dans le rappel lorsque la fonction est appelée.

Valeur renvoyée
Boolean — Une valeur boléenne true si la fonction spécifiée renvoie true lorsqu’elle est appelée sur tous les éléments dans le vecteur, false dans tous les autres cas.

Eléments de l’API associés

filter

()méthode 
AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Fonction à exécuter sur chaque élément du vecteur. Cette fonction est invoquée avec trois arguments : l’élément actuel du vecteur, l’index de l’élément et l’objet Vector :
function callback(item:T, index:int, vector:Vector.<T>):Boolean;
 
thisObject:Object (default = null) — Objet auquel se réfère l’identifiant this dans le rappel lorsque la fonction est appelée.

Valeur renvoyée
Vector.<T> — Un nouveau vecteur qui contient tous les éléments du vecteur d’origine pour lequel la fonction callback a renvoyé true.

Eléments de l’API associés

forEach

()méthode 
AS3 function forEach(callback:Function, thisObject:Object = null):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Fonction à exécuter sur chaque élément du vecteur. Cette fonction est invoquée avec trois arguments : l’élément actuel du vecteur, l’index de l’élément et l’objet Vector :
function callback(item:T, index:int, vector:Vector.<T>):void;

Toute valeur renvoyée depuis l’appel de fonction est supprimée.

 
thisObject:Object (default = null) — Objet auquel se réfère l’identifiant this dans le rappel lorsque la fonction est appelée.

indexOf

()méthode 
AS3 function indexOf(searchElement:T, fromIndex:int = 0):int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

searchElement:T — Elément à rechercher dans le vecteur.
 
fromIndex:int (default = 0) — Emplacement dans le vecteur à partir duquel débuter la recherche d’élément. Si ce paramètre est négatif, il est considéré comme length + fromIndex. Cela signifie que la recherche commence à partir des éléments -fromIndex jusqu’à la fin, puis continue à partir de cette position jusqu’à la fin du vecteur.

Valeur renvoyée
int — Une position d’index commençant à zéro de l’élément du vecteur. Si l’argument searchElement n’est pas détecté, la valeur renvoyée est -1.

Eléments de l’API associés

insertAt

()méthode 
AS3 function insertAt(index:int, element:T):void

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 19, AIR 19

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

Paramètres

index:int — Nombre entier spécifiant la position du Vecteur où l’élément doit être inséré. Vous pouvez utiliser un entier négatif pour définir une position par rapport à la fin du vecteur (par exemple, la valeur -1 représente le dernier élément du vecteur).
 
element:T


Valeur émise
RangeError — Si cette méthode est appelée alors que fixed est true.

join

()méthode 
AS3 function join(sep:String = ","):String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

sep:String (default = ",") — Caractère ou chaîne séparant les éléments du vecteur dans la chaîne renvoyée. Si vous omettez ce paramètre, une virgule est utilisée en tant que séparateur par défaut.

Valeur renvoyée
String — Chaîne composée des éléments d’un vecteur convertis en chaînes et séparés par la chaîne spécifiée.

Plus d’exemples

Eléments de l’API associés

lastIndexOf

()méthode 
AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

searchElement:T — Elément à rechercher dans le vecteur.
 
fromIndex:int (default = 0x7fffffff) — Emplacement dans le vecteur à partir duquel débuter la recherche d’élément. La valeur par défaut correspond à la valeur d’index maximale autorisée, ce qui signifie que la recherche commence à partir du dernier élément du vecteur.

Si ce paramètre est négatif, il est considéré comme length + fromIndex. Cela signifie que la recherche commence à partir des éléments -fromIndex jusqu’à la fin, puis continue à partir de cette position jusqu’à l’index 0.

Valeur renvoyée
int — Une position d’index commençant à zéro de l’élément du vecteur. Si l’argument searchElement n’est pas détecté, la valeur renvoyée est -1.

Eléments de l’API associés

map

()méthode 
AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Fonction à exécuter sur chaque élément du vecteur. Cette fonction est invoquée avec trois arguments : l’élément actuel du vecteur, l’index de l’élément et l’objet Vector :
function callback(item:T, index:int, vector:Vector.<T>):T;
 
thisObject:Object (default = null) — Objet auquel se réfère l’identifiant this dans le rappel lorsque la fonction est appelée.

Valeur renvoyée
Vector.<T> — Un nouveau vecteur qui contient les résultats de l’appel de la 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.

Eléments de l’API associés

pop

()méthode 
AS3 function pop():T

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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.

Valeur renvoyée
T — Valeur du dernier élément dans le vecteur spécifié.

Valeur émise
RangeError — Si cette méthode est appelée alors que fixed est true.

Plus d’exemples

Eléments de l’API associés

push

()méthode 
AS3 function push(... args):uint

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Une ou plusieurs valeurs à ajouter au vecteur.

Valeur renvoyée
uint — La longueur du vecteur une fois les éléments ajoutés.

Valeur émise
TypeError — Si un argument n’est pas une occurrence du type de base T du vecteur.
 
RangeError — Si cette méthode est appelée alors que fixed est true.

Plus d’exemples

Eléments de l’API associés

removeAt

()méthode 
AS3 function removeAt(index:int):T

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 19, AIR 19

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

Paramètres

index:int — Nombre entier spécifiant l’index de l’élément dans le Vecteur qui doit être supprimé. Vous pouvez utiliser un entier négatif pour définir une position par rapport à la fin du vecteur (par exemple, la valeur -1 représente le dernier élément du vecteur).

Valeur renvoyée
T — L’élément qui a été supprimé du vecteur d’origine.

Valeur émise
RangeError — Si l’argument Index spécifie un index à supprimer qui se trouve en dehors des limites du Vecteur.
 
RangeError — Si cette méthode est appelée alors que fixed est true.

reverse

()méthode 
AS3 function reverse():Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

Valeur renvoyée
Vector.<T> — Le vecteur avec les éléments dans l’ordre inverse.

Plus d’exemples

shift

()méthode 
AS3 function shift():T

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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.

Valeur renvoyée
T — Le premier élément dans le vecteur.

Valeur émise
RangeError — Si la propriété fixed est définie sur true.

Plus d’exemples

Eléments de l’API associés

slice

()méthode 
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

startIndex:int (default = 0) — Nombre spécifiant l’index du point de départ pour la découpe. Si startIndex est un nombre négatif, le point de départ se trouve à la fin du vecteur, où la valeur -1 correspond au dernier élément.
 
endIndex:int (default = 16777215) — Nombre spécifiant l’index du point d’arrivée pour la découpe. Si vous omettez ce paramètre, la découpe inclut tous les éléments, du point de départ à la fin du vecteur. Si endIndex est un nombre négatif, le point d’arrivée spécifié se trouve à la fin du vecteur, où la valeur -1 correspond au dernier élément.

Valeur renvoyée
Vector.<T> — un vecteur constitué d’un éventail d’éléments issus du vecteur d’origine.

Plus d’exemples

some

()méthode 
AS3 function some(callback:Function, thisObject:Object = null):Boolean

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

callback:Function — Fonction à exécuter sur chaque élément du vecteur. Cette fonction est invoquée avec trois arguments : l’élément actuel du vecteur, l’index de l’élément et l’objet Vector :
function callback(item:T, index:int, vector:Vector.<T>):Boolean

La fonction de rappel doit renvoyer une valeur booléenne.

 
thisObject:Object (default = null) — Objet auquel se réfère l’identifiant this dans le rappel lorsque la fonction est appelée.

Valeur renvoyée
Boolean — Une valeur booléenne true si un élément du vecteur renvoie true pour la fonction spécifiée, false dans tous les autres cas.

Eléments de l’API associés

sort

()méthode 
AS3 function sort(sortBehavior:*):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

sortBehavior:* — Un paramètre Function ou une valeur Number qui détermine le comportement du tri. Un paramètre Function spécifie une méthode de comparaison. Une valeur Number spécifie les options de tri.

Valeur renvoyée
Vector.<T> — Un objet vectoriel, avec les éléments dans le nouvel ordre.

Plus d’exemples

Eléments de l’API associés

splice

()méthode 
AS3 function splice(startIndex:int, deleteCount:uint = 4294967295, ... items):Vector.<T>

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

startIndex:int — Entier spécifiant l’index de la position d’insertion ou de suppression de l’élément dans le vecteur. Vous pouvez utiliser un entier négatif pour définir une position par rapport à la fin du vecteur (par exemple, la valeur -1 représente le dernier élément du vecteur).
 
deleteCount:uint (default = 4294967295) — Entier spécifiant le nombre d’éléments à supprimer. Ce nombre inclut l’élément spécifié dans le paramètre startIndex. Si la valeur est 0, aucun élément n’est supprimé.
 
... items — Liste facultative d’une ou de plusieurs valeurs séparées par une virgule à insérer dans le vecteur à la position spécifiée par le paramètre startIndex.

Valeur renvoyée
Vector.<T> — un vecteur contenant les éléments supprimés du vecteur d’origine.

Valeur émise
RangeError — Si les arguments startIndex et deleteCount spécifient un index à supprimer qui se trouve en dehors des limites du vecteur.
 
RangeError — Si la méthode est appelée alors que la propriété fixed est définie sur true et que l’opération splice() modifie la longueur du vecteur.

Plus d’exemples

toLocaleString

()méthode 
public function toLocaleString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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().

Valeur renvoyée
String — Chaîne d’éléments de vecteur.

Eléments de l’API associés

toString

()méthode 
public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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().

Valeur renvoyée
String — Chaîne d’éléments de vecteur.

Plus d’exemples

Eléments de l’API associés

unshift

()méthode 
AS3 function unshift(... args):uint

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5, Flash Lite 4

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

... args — Une ou plusieurs occurrence du type de base du vecteur à insérer au début du vecteur.

Valeur renvoyée
uint — Entier représentant la nouvelle longueur du vecteur.

Valeur émise
TypeError — Si un argument n’est pas une occurrence du type de base T du vecteur.
 
RangeError — Si cette méthode est appelée alors que fixed est true.

Plus d’exemples

Eléments de l’API associés





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.