A-C > Array.sort

Array.sort

Disponibilité

Flash Player 5.

Usage

monTableau.sort([fonctionDeComparaison])

Paramètres

fonctionDeComparaison Une fonction de comparaison facultative utilisée pour déterminer l'ordre de tri des éléments d'un tableau. Pour des éléments A et B donnés, le paramètre fonctionDeComparaison peut avoir l'une des trois valeurs suivantes :

	-1 si A apparaît avant B dans la séquence triée
	0 si A = B
	1 si A apparaît après B dans la séquence triée

Renvoie

Rien.

Description

Méthode ; trie le tableau en place sans en faire de copie. Si vous omettez le paramètre fonctionDeComparaison, Flash trie les éléments en place avec l'opérateur de comparaison <.

Exemple

L'exemple suivant utilise Array.sort sans spécifier le paramètre fonctionDeComparaison :

var fruits = ["oranges", "pommes", "fraises", "ananas", "cerises"];
trace(fruits.join());
fruits.sort();
trace(fruits.join());

Résultat :

oranges,pommes,fraises,ananas,cerises
displays pommes,cerises,oranges,ananas,fraises

L'exemple suivant utilise Array.sort avec une fonction de tri spécifiée.

var motsDePasse = [
   "gary:machin",
   "mike:chose",
   "john:snafu",
   "steve:yuck",
   "daniel:1234"
 ];
 function order (a, b) {
   // entrées du formulaire à trier
   // nom:motDePasse
   // trier avec uniquement la partie nom
   // de l'entrée comme clé.
   var nom1 = a.split(':')[0];
   var nom2 = b.split(':')[0];
   if (nom1 < nom2) {
     return -1;
   } else if (nom1 > nom2) {
     return 1;
   } else {
     return 0;
   }
 }
 for (var i=0; i< motDePasse.length; i++) {
   trace (motsDePasse.join());
 }
 motsDePasse.sort(order);
 trace ("Trié :");
 for (var i=0; i< motDePasse.length; i++) {
   trace (motsDePasse.join());
 }

L'exécution du script précédent affiche les résultats suivants dans la fenêtre Sortie.

daniel:1234
gary:machin
john:snafu
mike:chose
steve:yuck