Los datos expuestos en este blog, son solo de índole informativo. Por favor realiza siempre una copia de seguridad antes de realizar cualquier cambio en tu proyecto.
JavaScript: método String localeCompare()
Este tutorial de JavaScript muestra, con sintaxis y ejemplos, cómo usar el método de cadena llamado localeCompare().
describir
En JavaScript, localeCompare() es un método de cadena que compara dos cadenas y devuelve un número que indica qué cadena aparece primero en un orden de clasificación basado en la configuración regional. Debido a que el método localeCompare() es un método del objeto String, debe llamarse a través de una instancia específica de la clase String.
sintaxis
En JavaScript, la sintaxis del método localeCompare() es:
string.localeCompare(compare_string [, locale [, options]]);
parámetro o parámetro
compare_string Es un valor de cadena que se comparará con la cadena de llamada del método localeCompare(). La configuración regional es opcional. Es una etiqueta de idioma BCP 47 o una matriz de dichas etiquetas que se utiliza para determinar el orden de clasificación. La etiqueta de idioma BCP 47 define un idioma que puede contener códigos y extensiones del idioma principal. Si no se proporciona este parámetro, el método localeCompare() utilizará la configuración regional actual del entorno de alojamiento.Opciones
Electivo. Opciones para aplicar al orden de clasificación. Puede ser uno o más de los siguientes:
| valor | describir |
|---|---|
| Caso primero | Determina cómo se maneja el “caso” al ordenar. Puede ser uno de los siguientes valores:
|
| ignorar puntuación | Determina si se ignorará la puntuación. Puede ser uno de los siguientes valores:
|
| comparador de regiones | Determina el algoritmo de coincidencia de configuración regional que se utilizará. Puede ser uno de los siguientes valores:
|
| número | Determina si se utilizará la intercalación numérica. Puede ser uno de los siguientes valores:
|
| Sensibilidad | Determina si se utilizará la intercalación numérica. Puede ser uno de los siguientes valores:
|
| uso | Determina si el método realiza la ordenación o busca cadenas coincidentes. Puede ser uno de los siguientes valores:
|
devolver los bienes
El método localeCompare() devuelve un numero negativo Si la cadena de llamada aparece antes de compare_string en el orden de clasificación.
El método localeCompare() devuelve un un numero positivo Si la cadena de llamada aparece después de compare_string en el orden de clasificación.
El método localeCompare() devuelve 0 Si la cadena de llamada es equivalente a compare_string y, por lo tanto, aparece en la misma posición en el orden de clasificación.
notas
- El método localeCompare() no cambia el valor de la cadena original.
- Según el navegador, el método localeCompare() puede devolver diferentes valores positivos o negativos, como 1, 2, -1 o -2, cuando las cadenas no son equivalentes. Entonces, cuando use este método, asegúrese de probar un valor positivo o negativo, no un número específico como -1.
- El valor 0 se puede probar cuando la cadena de llamada y la cadena de comparación son iguales. Este valor de retorno no difiere entre navegadores.
ejemplo
Veamos un ejemplo de cómo usar el método localeCompare() en JavaScript.
Por ejemplo:
var totn_string = 'TechOnTheNet';
console.log(totn_string.localeCompare('abc'));En este ejemplo, declaramos una variable llamada totn_string, a la que se le asigna el valor de cadena “TechOnTheNet”. Luego llamamos al método localeCompare() de la variable totn_string para comparar este valor de cadena con “abc”.
Para fines de demostración, escribimos la salida del método localeCompare() en el registro de la consola del navegador web para mostrar lo que devuelve el método localeCompare().
Lo siguiente se enviará al registro de la consola del navegador web:
1
En este ejemplo, el método localeCompare() devuelve un valor positivo de 1 porque la cadena ‘TechOnTheNet’ aparece después de ‘abc’ en el orden de clasificación.
Según el navegador, el método localeCompare() puede devolver un valor positivo diferente, como 1 o 2, o cualquier otro valor positivo. No asuma que será el valor de retorno de 1.
Especificar el parámetro de configuración regional
También puede proporcionar una etiqueta de idioma BCP 47 al parámetro de configuración regional para cambiar el orden de clasificación en función de la configuración regional.
Por ejemplo:
var totn_string = 'TechOnTheNet';
console.log(totn_string.localeCompare('xyz','en-US'));Lo siguiente se enviará al registro de la consola del navegador web:
-1
En este ejemplo, el método localeCompare() usa el parámetro “en-US”, que ordena las cadenas usando el inglés estadounidense. El método devuelve un valor negativo de -1 porque la cadena ‘TechOnTheNet’ aparece antes de ‘xyz’ con este orden de clasificación.
Además, tenga en cuenta que, según el navegador, el método localeCompare() puede devolver diferentes valores negativos, como -1 o -2, o cualquier otro valor negativo. No asuma que será el valor de retorno de -1.
Especificar parámetros de opción
A continuación, el método localeCompare() tiene una serie de opciones que puede especificar que afectan el orden de clasificación.
Por ejemplo:
var totn_string = '8';
console.log(totn_string.localeCompare('30'));Lo siguiente se enviará al registro de la consola del navegador web:
1
En este ejemplo, el método localeCompare() devuelve 1 porque el valor de cadena ‘8’ utiliza la ordenación de cadenas después de ’30’.
Pero, ¿y si queremos ordenar numéricamente nuestros valores? Podemos aplicar la ordenación numérica usando el parámetro de opciones de la siguiente manera:
var totn_string = '8';
console.log(totn_string.localeCompare('30', 'en-US', {numeric:"true"}));Lo siguiente se enviará al registro de la consola del navegador web:
-1
El método localeCompare() ahora devuelve -1 porque el valor ‘8’ aparece antes que ’30’ al ordenar los valores numéricamente.