_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artículo
04/10/2013

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

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
);

Parámetros

string1, string2
Cadenas terminadas en null a comparar.
count
Número de caracteres que se va a comparar.
locale
Configuración regional a utilizar.

Valor devuelto

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.

Comentarios

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