Función StrCmpCA (shlwapi.h)
Compara las cadenas mediante reglas de intercalación en tiempo de ejecución (ASCII) de C. En la comparación se distinguen mayúsculas de minúsculas.
Sintaxis
int StrCmpCA(
[out] LPCSTR pszStr1,
[out] LPCSTR pszStr2
);
Parámetros
[out] pszStr1
Tipo: LPCSTR
Puntero a la primera cadena terminada en null que se va a comparar.
[out] pszStr2
Tipo: LPCSTR
Puntero a la segunda cadena terminada en null que se va a comparar.
Valor devuelto
Tipo: int
Devuelve cero si las cadenas son idénticas. Devuelve un valor positivo si la cadena a la que apunta lpStr1 es alfabéticamente mayor que la que apunta lpStr2. Devuelve un valor negativo si la cadena a la que apunta lpStr1 es alfabéticamente menor que la que apunta lpStr2.
Comentarios
Se recomienda encarecidamente usar la función CompareString en lugar de esta función. StrCmpC se diseñó para comparar cadenas canónicas. Estas cadenas no están localizadas y solo constan de caracteres por debajo del valor ASCII 128. Por lo tanto, no funcionará correctamente con un juego de caracteres de doble byte (DBCS) u otros datos de varios caracteres.
Esta función busca los primeros caracteres distintos y devuelve un número positivo si el carácter de la primera cadena es mayor que el carácter del segundo, un número negativo si es menor o cero si son iguales. Por ejemplo, si lpStr1="abczb" y lpStr2="abcdefg", StrCmpC determina que el primer carácter desigual está en la posición cuatro ("z" en lpStr1 y "d" en lpStr2) y devuelve un valor positivo, ya que el código ASCII de "z" es mayor que el código ASCII para "d".
Para las versiones de Windows que no incluyen StrCmpC en Shlwapi.h, se debe llamar a la versión individual de ANSI o Unicode de esta función directamente desde Shlwapi.dll. StrCmpCA es ordinal 155 y StrCmpCW es ordinal 156.
Nota
El encabezado shlwapi.h define StrCmpC 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shlwapi.h |
| Library | Shlwapi.lib |
| Archivo DLL | Shlwapi.dll (versión 5.0 o posterior) |