Méthode localeCompare() de String JavaScript

Définition et utilisation

localeCompare() La méthode compare deux chaînes de caractères dans l'environnement de langue actuel.

localeCompare() La méthode retourne l'ordre de tri -1et1 ou 0（représentant avant, après ou égal).

L'environnement de langue actuel est basé sur la configuration de langue du navigateur.

Exemple

Exemple 1

Comparaison de "ab" et "cd" :

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

Essayez-le vous-même

Exemple 2

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

Essayez-le vous-même

Exemple 3

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

Exemple 4

Essayez-le vous-même

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

Essayez-le vous-même

syntaxe

string.localeCompare(target)

paramètres

paramètres description
target obligatoire. La chaîne de caractères à comparer.

valeur de retour

type description
numérique

3 valeurs parmi :

  • -1, si la chaîne de caractères est classée avant target
  • 　0, si les deux chaînes de caractères sont égales
  • 　1, si la chaîne de caractères est classée après target

détails techniques

valeur de retour

retourne le nombre indiquant le résultat de la comparaison.

si string inférieur targetalors localeCompare() retourne un nombre inférieur à 0.

si string supérieur targetsinon, cette méthode retourne un nombre supérieur à 0.

Si deux chaînes de caractères sont égales ou sans différence selon la règle de tri locale, cette méthode retourne 0.

explication

mettre < et > Lorsque les opérateurs s'appliquent aux chaînes de caractères, ils comparent les chaînes de caractères uniquement à l'aide de la codage Unicode des caractères, sans tenir compte des règles de tri locales. L'ordre généré de cette manière n'est pas nécessairement correct. Par exemple, en espagnol, les caractères "ch" sont généralement classés entre les lettres "c" et "d" pour le tri.

localeCompare() La méthode fournie par le comparateur de chaînes prend en compte la règle de tri locale par défaut. Le standard ECMAscript ne spécifie pas comment effectuer une comparaison locale spécifique, il ne stipule que cette fonction utilise les règles de tri fournies par le système d'exploitation de base.

prise en charge par les navigateurs

localeCompare() c'est une caractéristique de ECMAScript1 (ES1).

Tous les navigateurs prennent en charge intégralement ES1 (JavaScript 1997) :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support Support Support Support Support Support

Pages connexes

Chaîne JavaScript

Méthodes de chaîne JavaScript

Recherche de chaîne JavaScript