sort-Methode

Gibt ein Array-Objekt mit sortierten Elementen zurück.

function sort(sortFunction : Function ) : Array

Argumente

  • sortFunction
    Optional. Der Name der Funktion für die Bestimmung der Reihenfolge der Elemente.

Hinweise

Die sort-Methode sortiert innerhalb des Array-Objekts. Während der Ausführung wird kein neues Array-Objekt erstellt.

Wenn Sie eine Funktion im sortFunction-Argument angeben, muss diese einen der folgenden Werte zurückgeben:

  • Einen negativen Wert, wenn das erste übergebene Argument kleiner als das zweite ist.

  • Null, wenn beide Argumente gleichwertig sind.

  • Einen positiven Wert, wenn das erste Argument größer als das zweite ist.

Ohne Angabe des sortFunction-Arguments werden die Elemente in aufsteigender ASCII-Zeichenreihenfolge sortiert.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der sort-Methode.

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

Anforderungen

Version 2

Betrifft:

Array-Objekt

Siehe auch

Weitere Ressourcen

Objekte (Visual Studio - JScript)