Metóda JavaScript String localeCompare () kontroluje, či je daný reťazec pred, za alebo či je rovnaký ako iný reťazec v poradí zoradenia.
Syntax localeCompare()
metódy je:
str.localeCompare(compareStr, locales, options)
Tu str
je reťazec.
parametre localeCompare ()
localeCompare()
Metóda berie v:
- compareStr - Reťazec, s ktorým
str
sa porovnáva. - miestne nastavenia a možnosti (voliteľné) - Tieto argumenty prispôsobujú funkciu určením toho, aké konvencie formátovania sa majú použiť.
Vrátiť hodnotu z localeCompare ()
- Vráti záporné číslo (-1), ak je referenčný reťazec zoradený pred porovnávaním Str.
- Vráti 0, ak sú dva reťazce rovnocenné.
- Vráti kladné číslo (1), ak je referenčný reťazec zoradený po porovnani Str.
Poznámka : Pretože vrátené záporné a kladné celé čísla sa v jednotlivých prehliadačoch líšia, nespoliehajte sa na presné hodnoty -1 alebo 1 .
Príklad 1: Používanie 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
Výkon
1 -1 0
Príklad 2: Použitie localeCompare () s miestnymi nastaveniami a možnosťami
// 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
Výkon
-1 -1 1 -1 1