_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Artículo
04/10/2013

Comparar las cadenas usando la información de configuración regional- concreta.

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

int _stricoll(
   const char *string1,
   const char *string2 
);
int _wcsicoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbsicoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _stricoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

Parámetros

string1, string2
Cadenas terminadas en null a comparar.
locale
La configuración regional a utilizar.

Valor devuelto

Cada una de estas funciones devuelve un valor que indica la relación de string1 a string2*,* como sigue.

Valor devuelto	Relación de string1 y string2
< 0	string1 menos que string2
0	string1 idéntico a string2
> 0	string1 mayor que string2
_NLSCMPERROR	Error.

Cada una de estas funciones devuelve _NLSCMPERROR.Para utilizar _NLSCMPERROR, incluya STRING.H o MBSTRING.H._wcsicoll puede fallar si string1 o string2 contiene códigos de carácter ancho fuera del dominio de la secuencia de ordenación.Cuando se produce un error, _wcsicoll puede establecer errno a EINVAL.Para comprobar si hay un error en una llamada a _wcsicoll, establezca errno a 0 y compruebe errno después de llamar a _wcsicoll.

Comentarios

Cada una de estas funciones realiza una comparación sin distinción entre mayúsculas y minúsculas de string1 y de string2 según la página de códigos actualmente en uso.Estas funciones se deben usar cuando existe una diferencia entre el juego de caracteres petición y el carácter lexicográfico orden en la página de códigos actual y esta diferencia de interés para la comparación de cadenas.

_stricmp diferencia de _stricoll en que la comparación de _stricmp se ve afectada por LC_CTYPE, mientras que la comparación de _stricoll es como las categorías de LC_CTYPE y de LC_COLLATE de la configuración regional.Para obtener más información sobre la categoría de LC_COLLATE, vea setlocale y Categorías de configuración regional.Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional actual; las versiones con el sufijo de _l son idénticas salvo que utilizan la configuración regional pasado en su lugar.Para obtener más información, vea Configuración regional.

Todas estas funciones validan sus parámetros.Si string1 o string2 es punteros de 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