lstrcmp

La función lstrcmp compara dos cadenas de caracteres. La comparación distingue mayúsculas de minúsculas.

Sintaxis

int lstrcmp(
    LPCTSTR lpString1,  // dirección de la primera cadena
    LPCTSTR lpString2   // dirección de la segunda cadena
   );

Parámetros

lpString1: apunta a la primera cadena terminada en nulo a comparar.

lpString2: apunta a la segunda cadena terminada en nulo a comparar.

Valor de retorno

Si la función tiene éxito y la cadena apuntada por lpString1 es menor que la cadena apuntada por lpString2, el valor de retorno es negativo; si la cadena apuntada por lpString1 es mayor que la apuntada por lpString2, es positivo. Si las cadenas son iguales, el valor de retorno es cero.

Observaciones

La función lstrcmp compara dos cadenas verificando los primeros caracteres entre ellos, los segundos, y sucesivamente hasta encontrar una desigualdad o el final de una de las cadenas.

La función devuelve la diferencia entre los valores de los primeros caracteres no iguales si los encuentra. Por ejemplo, lstrcmp determina que "abcz" es mayor que "abcdefg" y devuelve la diferencia entre z y d.

El lenguaje (localización) seleccionado por el usuario durante la instalación, o mediante el Panel de Control, determina qúe cadena es mayor (o si las cadenas son la misma). Si no se ha seleccionado un lenguaje, Windows realiza la comparación usando los valores por defecto. En las funciones de lenguaje del Windows de Estados Unidos (y también en español), los caracteres en mayúscula tienen valores más bajos que los caracteres en minúscula.

Con la versión de Windows de caracteres de doble byte (DBCS), esta función compara dos cadenas DBCS.

La versión Win32 de la función lstrcmp usa un ordenamiento de palabra (word sort), en lugar de un ordenamiento de cadena (string sort). Un ordenamiento de palabra trata los guiones y los apóstrofes de un modo diferente que el resto de los símbolos no alfanuméricos, para asegurar que palabras como "coop" y "co-op" estarán juntas en una lista ordenada. En versiones de 16 bits de Windows, lstrcmp usa ordenamiento de cadena. Para una explicación más detallada sobre ordenamientos de palabra y de cadena, ver la sección de Observaciones de la referencia de la función CompareString.