_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Artículo
06/09/2015

Compara cadenas usando información específica de la configuración regional.

Importante

_mbsncoll y _mbsncoll_l no se pueden usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones de CRT no admitidas con /ZW.

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parámetros

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

Valor devuelto

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

Valor devuelto	Relación de string1 y string2
< 0	string1 es menor que string2.
0	string1 es idéntica a string2.
> 0	string1 es mayor que string2.

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

Comentarios

Cada una de estas funciones realiza una comparación con distinción entre mayúsculas y minúsculas de los primeros caracteres de count en string1 y string2, según la página de códigos que está actualmente en uso. Utilice estas funciones 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 y, cuando esta diferencia de interés para la comparación de cadenas. El orden de juego de caracteres es configuración regional- dependiente. Las versiones de estas funciones que no tienen el uso del sufijo de _l la configuración regional actual, únicamente las versiones con el uso del sufijo de _l 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, o 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 devuelven _NLSCMPERROR y establecen errno en EINVAL.

Asignaciones de rutina de texto genérico