O método JavaScript String localeCompare () verifica se uma determinada string vem antes, depois ou é igual a outra string na ordem de classificação.
A sintaxe do localeCompare()método é:
str.localeCompare(compareStr, locales, options)
Aqui strestá uma corda.
Parâmetros localeCompare ()
O localeCompare()método inclui:
- compareStr - a string com a qual
stré comparado. - locales e opções (opcional) - Esses argumentos personalizam a função especificando quais convenções de formatação usar.
Valor de retorno de localeCompare ()
- Retorna um número negativo (-1) se a string de referência for classificada antes de compareStr.
- Retorna 0 se duas strings forem equivalentes.
- Retorna um número positivo (1) se a string de referência for classificada após compareStr.
Observação : como os números inteiros negativos e positivos retornados variam entre os navegadores, não confie nos valores exatos -1 ou 1 .
Exemplo 1: Usando 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
Resultado
1 -1 0
Exemplo 2: Usando localeCompare () com localidades e opções
// 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
Resultado
-1 -1 1 -1 1
