Partager via


sort, méthode

Mise à jour : novembre 2007

Retourne un objet Array dans lequel les éléments sont triés.

function sort(sortFunction : Function ) : Array

Arguments

  • sortFunction
    Facultatif. Nom de la fonction employée pour déterminer l'ordre des éléments.

Notes

La méthode sort trie l'objet Array existant. Aucun nouvel objet Array n'est créé pendant l'exécution.

Si vous indiquez une fonction dans l'argument sortFunction, elle doit retourner l'une des valeurs suivantes :

  • Une valeur négative si le premier argument passé est inférieur au deuxième argument.

  • La valeur zéro si les deux arguments sont équivalents.

  • Une valeur positive si le premier argument est supérieur au deuxième argument.

Si l'argument sortFunction est omis, les éléments sont triés par ordre croissant, selon l'ordre des caractères ASCII.

Exemple

L'exemple ci-dessous illustre l'utilisation de la méthode sort.

function SortDemo(){
   var a, l;                       //Declare variables.
   a = new Array("X" ,"y" ,"d", "Z", "v","m","r");
   l = a.sort();                   //Sort the array.
   return(l);                      //Return sorted array.
}

Configuration requise

Version 2

S'applique à :

Array, objet

Voir aussi

Autres ressources

Objets (JScript)