Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Compara los caracteres de dos cadenas sin tener en cuenta el caso.

Nota importante Importante

_mbsnicmp y _mbsnicmp_l no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones CRT no compatibles con /ZW.

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

string1, string2

Cadenas terminadas en null a comparar.

count

Número de caracteres que se va a comparar.

locale

Configuración regional a utilizar.

Indica la relación entre las subcadenas, como sigue.

Valor devuelto

Descripción

< 0

la subcadena de string1 es menor que la de string2.

0

la subcadena de string1 es idéntica a la subcadena de string2.

> 0

la subcadena de string1 es mayor que la de string2.

En un error, _mbsnicmp devuelve _NLSCMPERROR, que se define en STRING.H y MBSTRING.H.

La función de _strnicmp lexicográficamente compara, como máximo, los primeros caracteres de count de string1 y string2. La comparación se realiza sin tener en cuenta el caso; _strnicmp es una versión sin distinción entre mayúsculas y minúsculas de strncmp. Finaliza la comparación si un carácter null de terminación se consigue en cualquier cadena antes de que se comparan los caracteres de count. Si las cadenas son iguales cuando un carácter null de terminación se consigue en cualquier cadena antes de que se comparan los caracteres de count, la cadena más corta es menos.

Los caracteres a partir de 91 a 96 de la tabla ASCII (“[”, “\”, “]”, “^”, “_”, y '“") se evalúan como menos que cualquier carácter alfabético. Esto de ordenación es idéntico al de stricmp.

_wcsnicmp y _mbsnicmp son versiones de caracteres anchos y de multibyte- carácter de _strnicmp. Los argumentos y el valor devuelto de _wcsnicmp son cadenas de caracteres; las de _mbsnicmp son cadenas de multibyte- carácter. _mbsnicmp reconoce secuencias de multibyte- carácter según la página de códigos actual multibyte y devuelve _NLSCMPERROR en un error. Para obtener más información, vea Páginas de códigos. Estas tres funciones se comportan exactamente igual de otra manera. Estas funciones se ven afectadas por las versiones de valor (de la configuración regional que no tienen el uso del sufijo de _l la configuración regional actual para su comportamiento configuración regional- dependiente; las versiones que tienen el sufijo de _l en su lugar utilice la configuración regional que se pasa. Para obtener más información, vea Configuración regional.

Todas estas funciones validan sus parámetros. Si string1 o string2 es un puntero NULL, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones _NLSCMPERROR return y errno determinado a EINVAL.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

Rutina

Encabezado necesario

_strnicmp , _strnicmp_l

<string.h>

_wcsnicmp , _wcsnicmp_l

<string.h> o <wchar.h>

_mbsnicmp , _mbsnicmp_l

<mbstring.h>

Para obtener información adicional de compatibilidad, vea Compatibilidad.

Vea el ejemplo para strncmp.

Mostrar: