JS метод String.localeCompare()

Загальний опис

правити

Порада

автор: Bond правити

Порада

Використовуйте метод localeCompare() для порівняння рядків у відповідності з локальними правилами сортування. Це особливо корисно, коли вам потрібно впорядковувати дані, які містять символи специфічних мов, таких як акценти, умлаути чи інші спеціальні символи.

автор: Bond правити

Порада

При роботі з великими наборами даних краще спочатку визначити критерії сортування, а потім виконати сортування, щоб оптимізувати продуктивність. Це дозволяє уникнути повторного виклику localeCompare() для кожної пари порівнянь, що може бути часозатратним для великих обсягів даних.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

localeCompare(compareString)
localeCompare(compareString, locales)
localeCompare(compareString, locales, options)

Параметри

compareString

Рядок, з яким порівнюється початковий рядок. Всі значення автоматично перетворюються на рядки, тому пропуск цього аргументу або передача undefined призведе до порівняння з рядком "undefined", що, як правило, не є бажаним.

автор: Bond

правити

locales

Рядок з тегом мови BCP 47 або масив таких рядків. Відповідає параметру locales конструктора Intl.Collator(). Дозволяє вказати локалізацію для порівняння, що впливає на правила сортування і порівняння.

автор: Bond

правити

options

Об'єкт, який налаштовує формат виведення. Відповідає параметру options конструктора Intl.Collator(). Може включати такі налаштування, як чутливість до регістру та акцентів, вибір між числовим і нумеричним порівнянням тощо.

автор: Bond

правити

Повернення

number

Повертає числове значення, яке вказує на взаємне розташування двох рядків у порядку сортування з урахуванням локальних особливостей. Якщо перший рядок (referenceStr) слід розміщувати перед другим (compareString), метод повертає від'ємне число. Якщо перший рядок слід розміщувати після другого, метод повертає додатне число. У випадку, коли рядки еквівалентні, повертається 0.

автор: Bond

правити

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	1	1	3	7	12	5.5

Підтримка: мобільні переглядачі

Переглядач
	4.4	18	4	1

Підтримка: серверні переглядачі

Переглядач
	0.10.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

// Створюємо два рядки для порівняння
let germanString1 = "Straße";
let germanString2 = "strasse";

// Порівнюємо рядки з врахуванням локалі та чутливості до регістру
let comparisonResult = germanString1.localeCompare(germanString2, 'de', { sensitivity: 'base' });

console.log(comparisonResult); // Виводить: 0, оскільки в німецькій мові ці рядки вважаються еквівалентними

<header>
  <h2 class="title">String.prototype.localeCompare()</h2>
  <p class="description">Порівнює два рядки з урахуванням локалізації.</p>
</header>
<main>
  <div class="result">
    <input type="text" id="string1" placeholder="Введіть перший рядок...">
    <input type="text" id="string2" placeholder="Введіть другий рядок...">
    <select id="localeSelector">
      <option value="en">English</option>
      <option value="uk">Українська</option>
      <option value="pl">Polski</option>
    </select>
    <button onclick="compareStrings()">Порівняти</button>
    <p id="compareResult">Результат порівняння: <span id="comparison">-</span></p>
  </div>
</main>

body {
  font-size: 16px;
  line-height: 1.5;
  font-family: monospace;
}

header {
  background-color: #f1f1f1;
  margin-bottom: 25px;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

header h2.title {
  padding-bottom: 15px;
  border-bottom: 1px solid #999;
}

header p.description {
  font-style: italic;
  color: #222;
}

.result {
  background-color: #f8f8f8;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

input[type="text"], select {
  margin: 10px 0;
  padding: 5px;
  width: 80%;
}

button {
  cursor: pointer;
  padding: 5px 10px;
  margin-bottom: 10px;
}

#compareResult {
  margin-top: 10px;
}

function compareStrings() {
  var string1 = document.getElementById('string1').value;
  var string2 = document.getElementById('string2').value;
  var locale = document.getElementById('localeSelector').value;
  var comparisonResult = string1.localeCompare(string2, locale);
  document.getElementById('comparison').textContent = comparisonResult.toString();
}
//# sourceURL=pen.js

// Створюємо два рядки для порівняння
let string1 = "абрикос";
let string2 = "банан";

// Порівнюємо рядки
let comparisonResult = string1.localeCompare(string2);

console.log(comparisonResult); // Виводить: -1, оскільки "абрикос" йде перед "банан"