Metoda JavaScript String localeCompare () sprawdza, czy dany ciąg występuje przed, po lub jest taki sam jak inny ciąg w kolejności sortowania.
Składnia localeCompare()
metody to:
str.localeCompare(compareStr, locales, options)
Tutaj str
jest sznurek.
localeCompare () Parametry
localeCompare()
Sposób odbywa się:
- compareStr - ciąg, z którym
str
jest porównywany. - ustawienia regionalne i opcje (opcjonalne) - te argumenty dostosowują funkcję, określając konwencje formatowania, które mają być używane.
Wartość zwracana z localeCompare ()
- Zwraca liczbę ujemną (-1), jeśli ciąg referencyjny jest posortowany przed porównaniemStr.
- Zwraca 0, jeśli dwa ciągi są równoważne.
- Zwraca liczbę dodatnią (1), jeśli ciąg odniesienia jest posortowany po parametrze compareStr.
Uwaga : ponieważ zwracane ujemne i dodatnie liczby całkowite różnią się w zależności od przeglądarki, nie należy polegać na dokładnych wartościach -1 lub 1 .
Przykład 1: Używanie 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
Wynik
1 -1 0
Przykład 2: Używanie localeCompare () z ustawieniami narodowymi i opcjami
// 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
Wynik
-1 -1 1 -1 1