Función StrCmpNCA (shlwapi.h)
Compara un número especificado de caracteres desde el principio de dos 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 StrCmpNCA(
[in] LPCSTR pszStr1,
[in] LPCSTR pszStr2,
int nChar
);
Parámetros
[in] pszStr1
Tipo: LPCTSTR
Puntero a la primera cadena terminada en null que se va a comparar.
[in] pszStr2
Tipo: LPCTSTR
Puntero a la segunda cadena terminada en null que se va a comparar.
nChar
Tipo: int
Número de caracteres desde el principio de cada cadena que se va a comparar.
Valor devuelto
Tipo: int
Devuelve cero si las subcadenas son idénticas. Devuelve un valor positivo si la cadena tomada de la que apunta pszStr1 es alfabéticamente mayor que la cadena tomada de la que apunta pszStr2. Devuelve un valor negativo si la cadena tomada de la que apunta pszStr1 es alfabéticamente menor que la cadena tomada de la que apunta pszStr2.
Comentarios
Tenga en cuenta que StrCmpNC 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, supongamos que pszStr1="abczb", pszStr2="abcdefg" y compara los cuatro primeros caracteres de cada uno. StrCmpNC determina que el primer carácter desigual está en la posición cuatro ("z" en pszStr1 y "d" en pszStr2) 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 StrCmpNC en Shlwapi.h, se debe llamar directamente a la versión individual de ANSI o Unicode de esta función desde Shlwapi.dll. StrCmpNCA es ordinal 151 y StrCmpNCW es ordinal 152.
Nota:
El encabezado shlwapi.h define StrCmpNC 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
| 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) |