Función StrCmpNCW (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. La comparación distingue mayúsculas de minúsculas.
Sintaxis
int StrCmpNCW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR pszStr2,
int nChar
);
Parámetros
[in] pszStr1
Tipo: LPCTSTR de
Puntero a la primera cadena terminada en NULL que se va a comparar.
[in] pszStr2
Tipo: LPCTSTR de
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 esa a la que apunta pszStr1 es alfabéticamente mayor que la cadena tomada de esa a la que apunta pszStr2. Devuelve un valor negativo si la cadena tomada de esa a la que apunta pszStr1 es alfabéticamente menor que la cadena tomada de esa a la que apunta pszStr2.
Observaciones
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 está comparando 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 esas versiones de Windows que no incluyen StrCmpNC en Shlwapi.h, se debe llamar a la versión individual anSI o Unicode de esta función directamente 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 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
shlwapi.h |
| biblioteca de |
Shlwapi.lib |
| DLL de |
Shlwapi.dll (versión 5.0 o posterior) |
Consulte también
de