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.

strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l

Comparar las cadenas utilizando la configuración regional actual o categoría especificada del estado de la conversión de LC_CTYPE.

Nota importante Importante

_mbscoll y _mbscoll_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 strcoll(
   const char *string1,
   const char *string2 
);
int wcscoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbscoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _strcoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale 
);
int wcscoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale 
);
int _mbscoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale 
);

string1, string2

Cadenas terminadas en null a comparar.

locale

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

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

Cada una de estas funciones realiza una comparación con 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.

Todas estas funciones validan sus parámetros. Si string1 o string2 es un puntero null, o si count es mayor que INT_MAX, 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.

Comparación de las dos cadenas es una operación configuración regional- dependiente como cada configuración regional tiene reglas diferentes para ordenar los caracteres. Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional del subproceso actual para este comportamiento configuración regional- dependiente; las versiones con el sufijo de _l son idénticas a la función correspondiente sin el sufijo salvo que utilizan la configuración regional pasado como parámetro en lugar de la configuración regional actual. Para obtener más información, vea Configuración regional.

Asignaciones de la rutina de Genérico- texto

Rutina de TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcscoll

strcoll

_mbscoll

wcscoll

Rutina

Encabezado necesario

strcoll

<string.h>

wcscoll

<wchar.h>, <string.h>

_mbscoll , _mbscoll_l

<mbstring.h>

_strcoll_l

<string.h>

_wcscoll_l

<wchar.h>, <string.h>

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

Mostrar: