Guide de reference du langage ActionScript 2.0 - PowWeb

La fonctionnalité ajoutée à Flash Player 8 permet de spécifier une option de tri différente pour
chaque champ lors d'un tri selon plusieurs champs. Dans Flash Player 8, le paramètre
options accepte un tableau d'options de tri de telle sorte que chaque option de tri correspond
à un champ de tri dans le paramètre fieldName. L'exemple suivant trie le champ de tri
principal, a, selon un tri décroissant, le deuxième champ de tri, b, selon un tri numérique et le
troisième champ de tri, c, selon un tri non sensible à la casse :
Array.sortOn (["a", "b", "c"], [Array.DESCENDING, Array.NUMERIC,
Array.CASEINSENSITIVE]);
Remarque : Les tableaux fieldName et options doivent contenir le même nombre d'éléments
; sinon, le tableau options est ignoré. En outre, les options Array.UNIQUESORT et
Array.RETURNINDEXEDARRAY ne peuvent être utilisées qu'en tant que premier élément du
tableau, sinon elles sont ignorées.
Disponibilité : ActionScript 1.0 ; Flash Player 6
Paramètres
fieldName:Object - Une chaîne identifiant un champ à utiliser en tant que valeur de tri ou
un tableau dans lequel le premier élément représente le champ de tri principal, le deuxième le
champ de tri secondaire, etc.
options:Object [facultatif] - Un ou plusieurs nombres ou noms de constantes définies,
séparés par l'opérateur bitwise OR (|), ce qui remplace le comportement de tri. Les valeurs
suivantes sont valides pour le paramètre options :
■ Array.CASEINSENSITIVE ou 1
■ Array.DESCENDING ou 2
■ Array.UNIQUESORT ou 4
■ Array.RETURNINDEXEDARRAY ou 8
■ Array.NUMERIC ou 16
Les conseils de code sont activés si vous utilisez le format chaîne de l'indicateur (par exemple,
DESCENDING) au lieu du format numérique (2).
Renvoie
Array - La valeur de renvoi dépend du fait que vous transmettiez ou non des paramètres :
■ Si vous spécifiez une valeur de 4 ou Array.UNIQUESORT pour le paramètre options et si
au moins deux éléments triés ont des champs de tri identiques, la valeur 0 est renvoyée et
le tableau n'est pas modifié.
266 Chapitre 2: Classes ActionScript