Методът на JavaScript String localeCompare () проверява дали даден низ идва преди, след или е същият като другия низ в ред на сортиране.
Синтаксисът на localeCompare()
метода е:
str.localeCompare(compareStr, locales, options)
Тук str
е низ.
localeCompare () Параметри
В localeCompare()
метода се в:
- compareStr - низът, спрямо който
str
се сравнява. - локали и опции (по избор) - Тези аргументи персонализират функцията, като определят какви конвенции за форматиране да се използват.
Връща стойност от localeCompare ()
- Връща отрицателно число (-1), ако референтният низ е сортиран преди compareStr.
- Връща 0, ако два низа са еквивалентни.
- Връща положително число (1), ако референтният низ е сортиран след compareStr.
Забележка : Тъй като върнатите отрицателни и положителни цели числа варират в различните браузъри, не разчитайте на точни стойности -1 или 1 .
Пример 1: Използване на 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
Изход
1 -1 0
Пример 2: Използване на localeCompare () с локали и опции
// 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
Изход
-1 -1 1 -1 1