A-C > Array.sortOn
A-C > Array.sortOn |
|
Array.sortOn
Disponibilité
Flash Player 6.
Usage
Array.sortOn(nomDeChamp)
Paramètres
nomDeChamp Une chaîne qui identifie un champ dans un élément du tableau à utiliser comme valeur de tri.
Renvoie
Rien.
Description
Méthode ; trie les éléments d'un tableau en fonction d'un champ du tableau. Si aucun paramètre nomDeChamp n'est transmis, la fonction échoue. Si plusieurs paramètres nomDeChamp sont transmis, le premier champ est converti en une valeur chaîne et les autres paramètres sont ignorés.
Si l'un des éléments comparés ne contient pas le champ spécifié dans le paramètre nomDeChamp, le tri s'effectue par défaut selon le comportement de la méthode Array.sort.
Exemple
L'exemple suivant crée un tableau et le trie en fonction du champ ville :
var monTableau = new Array();
monTableau.push( { nom: "bob", ville: "omaha", codePostal: 68144 } );
monTableau.push( { nom: "greg", ville: "kansas city", codePostal: 72345 } );
monTableau.push( { nom: "chris", ville: "burlingame", codePostal: 94010 } );
monTableau.sortOn("ville");
// a le résultat suivant :
monTableau[0] = nom: "chris", ville: "burlingame", codePostal: 94010
monTableau[1] = nom: "greg", ville: "kansas city", codePostal: 72345
monTableau[2] = nom: "bob", ville: "omaha", codePostal: 68144
Voir aussi
|