Метод JavaScript String localeCompare () перевіряє, чи заданий рядок постає перед, після або таким самим, як інший рядок у порядку сортування.
Синтаксис localeCompare()
методу:
str.localeCompare(compareStr, locales, options)
Ось str
рядок.
localeCompare () Параметри
localeCompare()
Метод приймає в:
- compareStr - рядок, з яким
str
порівнюється. - локалі та параметри (необов’язково) - Ці аргументи налаштовують функцію, вказуючи, які правила форматування використовувати.
Повернути значення з localeCompare ()
- Повертає від'ємне число (-1), якщо посилальний рядок відсортовано перед порівняннямStr.
- Повертає 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