o método Sort

Retorna um Array o objeto com os elementos classificados.

function sort(sortFunction : Function ) : Array

Argumentos

  • sortFunction
    Opcional. Nome da função usada para determinar a ordem dos elementos.

Comentários

O classificação método classifica o Array objeto no local; não é nova Array objeto é criado durante a execução.

Se você fornecer uma função de sortFunction argumento, ele deve retornar um dos seguintes valores:

  • Um valor negativo se o primeiro argumento passado é menor que o segundo argumento.

  • Zero se os dois argumentos são equivalentes.

  • Um valor positivo se o primeiro argumento é maior que o segundo argumento.

Se a sortFunction argumento for omitido, os elementos são classificados em ordem de caracteres ASCII, crescente.

Exemplo

O exemplo a seguir ilustra o uso de classificação método.

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; 
}

Requisitos

Versão 2

Se aplica A:

Objeto Array

Consulte também

Outros recursos

Objetos (Visual Studio - JScript)