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
Se recomienda usar Visual Studio 2017
Esta documentación está archivada y no tiene mantenimiento.

_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

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

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

string1, string2

Cadenas terminadas en null a comparar.

locale

La configuración regional a utilizar.

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.

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

Rutina de TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsicoll

_stricoll

_mbsicoll

_wcsicoll

Rutina

Encabezado necesario

_stricoll , _stricoll_l

<string.h>

_wcsicoll , _wcsicoll_l

<wchar.h>, <string.h>

_mbsicoll , _mbsicoll_l

<mbstring.h>

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

Mostrar: