Die Methode JavaScript String localeCompare () prüft, ob eine bestimmte Zeichenfolge vor, nach oder in der Sortierreihenfolge mit einer anderen Zeichenfolge identisch ist.
Die Syntax der localeCompare()
Methode lautet:
str.localeCompare(compareStr, locales, options)
Hier str
ist eine Zeichenfolge.
localeCompare () -Parameter
Die localeCompare()
Methode umfasst:
- compareStr - Die Zeichenfolge, mit der
str
verglichen wird. - Gebietsschemas und Optionen (optional) - Diese Argumente passen die Funktion an, indem sie angeben, welche Formatierungskonventionen verwendet werden sollen.
Rückgabewert von localeCompare ()
- Gibt eine negative Zahl (-1) zurück, wenn die Referenzzeichenfolge vor compareStr sortiert ist.
- Gibt 0 zurück, wenn zwei Zeichenfolgen gleichwertig sind.
- Gibt die positive Zahl (1) zurück, wenn die Referenzzeichenfolge nach compareStr sortiert ist.
Hinweis : Da zurückgegebene negative und positive Ganzzahlen zwischen den Browsern variieren, sollten Sie sich nicht auf exakte Werte -1 oder 1 verlassen .
Beispiel 1: Verwenden von localeCompare ()
// letter 'h' comes after 'c' let result = "h".localeCompare("c"); console.log(result); // 1 // letter 'a' comes before 'c', so 'after' comes before 'car' let result1 = "after".localeCompare("car"); console.log(result1); // words 'JavaScript' & 'JavaScript' are equivalent let result2 = "JavaScript".localeCompare("JavaScript"); console.log(result2); // 0
Ausgabe
1 -1 0
Beispiel 2: Verwenden von localeCompare () mit Gebietsschemas und Optionen
// using locale let value1 = "ä".localeCompare("z", "de"); console.log(value1); // a negative value: in German, ä sorts before z let value2 = "ä".localeCompare("z", "sv"); console.log(value2); // a positive value: in Swedish, ä sorts after z // default console.log("5".localeCompare("40")); // 1 // using options let value3 = "5".localeCompare("40", undefined, ( numeric: true )); console.log(value3); // a negative value let value4 = "Cliché".localeCompare("café", "fr", ( ignorePunctuation: true )); console.log(value4); // a positive value
Ausgabe
-1 -1 1 -1 1