sort, méthode
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()
{
// Create an array.
var a = new Array("4", "11", "2", "10", "3", "1");
// Sort in ascending ASCII order.
// The array will contain 1,10,11,2,3,4.
a.sort();
// Sort the array elements numerically.
// Use a function that compares array elements.
// The array will contain 1,2,3,4,10,11.
a.sort(CompareForSort);
}
// This function is used by the sort method
// to sort array elements numerically.
// It accepts two string arguments that
// contain numbers.
function CompareForSort(param1, param2)
{
var first = parseInt(param1);
var second = parseInt(param2);
if (first == second)
return 0;
if (first < second)
return -1;
else
return 1;
}