Función lstrcmpW (winbase.h)

Artículo
08/27/2023

Compara dos cadenas de caracteres. En la comparación se distinguen mayúsculas de minúsculas.

Para realizar una comparación que no distingue mayúsculas de minúsculas, use la función lstrcmpi .

Sintaxis

int lstrcmpW(
  [in] LPCWSTR lpString1,
  [in] LPCWSTR lpString2
);

Parámetros

[in] lpString1

Tipo: LPCTSTR

Primera cadena terminada en NULL que se va a comparar.

[in] lpString2

Tipo: LPCTSTR

Segunda cadena terminada en NULL que se va a comparar.

Valor devuelto

Tipo: int

Si la cadena a la que apunta lpString1 es menor que la cadena a la que apunta lpString2, el valor devuelto es negativo. Si la cadena a la que apunta lpString1 es mayor que la cadena a la que apunta lpString2, el valor devuelto es positivo. Si las cadenas son iguales, el valor devuelto es cero.

Comentarios

La función lstrcmp compara dos cadenas comprobando los primeros caracteres entre sí, los segundos caracteres entre sí, etc. hasta que encuentra una desigualdad o alcanza los extremos de las cadenas.

Tenga en cuenta que los parámetros lpString1 y lpString2 deben terminar en null; de lo contrario, la comparación de cadenas puede ser incorrecta.

La función llama a CompareStringEx, utilizando la configuración regional del subproceso actual y resta 2 del resultado, para mantener las convenciones en tiempo de ejecución de C para comparar cadenas.

El idioma (configuración regional del usuario) seleccionado por el usuario en el momento de la instalación, o a través de Panel de control, determina qué cadena es mayor (o si las cadenas son las mismas). Si no se selecciona ningún idioma (configuración regional de usuario), el sistema realiza la comparación mediante valores predeterminados.

Con una versión de juego de caracteres de doble byte (DBCS) del sistema, esta función puede comparar dos cadenas DBCS.

La función lstrcmp usa una ordenación de palabras, en lugar de una ordenación de cadena. Una ordenación de palabras trata guiones y apóstrofos de forma diferente a los demás símbolos que no son alfanuméricos, con el fin de garantizar que las palabras como "coop" y "co-op" permanezcan juntas dentro de una lista ordenada. Para obtener una explicación detallada de las ordenes de palabras y las ordenación de cadenas, consulte Control de la ordenación en sus aplicaciones.

Comentarios de seguridad

Consulte Consideraciones de seguridad: Características internacionales para conocer las consideraciones de seguridad relacionadas con la elección de funciones de comparación.

Nota

El encabezado winbase.h define lstrcmp como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll