مетод localeCompare() رشته JavaScript

تعریف و استفاده

localeCompare() این روش دو رشته را در محیط زبانی فعلی مقایسه می‌کند.

localeCompare() این روش توالی مرتب‌سازی را برمی‌گرداند -1و1 یا 0این نشان‌دهنده قبل، بعد یا برابر است.

زبان محلی بر اساس تنظیمات زبان مرورگر است.

مثال

مثال 1

مقایسه "ab" و "cd":

let text1 = "ab";
let text2 = "cd";
let result = text1.localeCompare(text2);

آزمایش کنید

مثال 2

let text1 = "cd";
let text2 = "ab";
let result = text1.localeCompare(text2);

آزمایش کنید

مثال 3

let text1 = "ab";
let text2 = "ab";
let result = text1.localeCompare(text2);

مثال 4

آزمایش کنید

let text1 = "A";
let text2 = "a";
let result = text1.localeCompare(text2);

آزمایش کنید

قانون

string.localeCompare(target)

پارامتر

پارامتر توضیح
target لازم. رشته‌ای که باید مقایسه شود.

اعداد بازگشتی

نوع توضیح
عدد

سه مقدار یکی از این‌ها:

  • -1، اگر رشته در پیش از target قرار دارد
  • 　0، اگر دو رشته برابر هستند
  • 　1، اگر رشته در پس از target قرار دارد

جزئیات فنی

اعداد بازگشتی

اعداد بازمی‌گردانند که نتایج مقایسه را نشان می‌دهند.

اگر string کمتر target، در این صورت localeCompare() اعداد کمتر از 0 برمی‌گرداند.

اگر string بزرگتر target، در این صورت این روش عددی بزرگتر از 0 برمی‌گرداند.

اگر دو رشته برابر باشند یا بر اساس قوانین مرتب‌سازی محلی تفاوتی نداشته باشند، این روش عددی برابر با 0 برمی‌گرداند.

توضیح

را < و > وقتی این عملگرها به یک رشته اعمال می‌شوند، آنها فقط با استفاده از کدگذاری Unicode کاراکترها رشته‌ها را مقایسه می‌کنند و به قوانین مرتب‌سازی محلی توجه نمی‌کنند. توالی تولید شده ممکن است درست نباشد. به عنوان مثال، در زبان اسپانیایی، کاراکتر "ch" معمولاً به عنوان کاراکتری بین "c" و "d" در توالی قرار می‌گیرد.

localeCompare() این روش مقایسه توالی کلمات را فراهم می‌کند که با قوانین مرتب‌سازی محلی پیش‌فرض سازگار است. استاندارد ECMAScript نحوه انجام مقایسه‌های محلی خاص را تعیین نمی‌کند، بلکه فقط می‌گوید که این تابع باید از قوانین مرتب‌سازی پیش‌فرض سیستم‌عامل استفاده کند.

پشتیبانی مرورگر

localeCompare() ویژگی‌های ECMAScript1 (ES1) است.

همه مرورگرها به طور کامل از ES1 (JavaScript 1997) پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

رشته JavaScript

روش‌های رشته JavaScript

جستجوی رشته JavaScript