Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

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

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

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.

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.

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

Rutina TCHAR.H

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsnccoll

_strncoll

_mbsncoll

_wcsncoll

_tcsncoll

_strncoll

_mbsnbcoll

_wcsncoll

Rutina

Encabezado necesario

_strncoll , _strncoll_l

<string.h>

_wcsncoll , _wcsncoll_l

<wchar.h> o <string.h>

_mbsncoll , _mbsncoll_l

<mbstring.h>

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft