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

_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

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

Nota importante Importante

_mbsnicoll y _mbsnicoll_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 _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_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 van 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 string2, como se indica a continuación.

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 usar _NLSCMPERROR, incluya STRING.H o MBSTRING.H. _wcsnicoll puede producir un error si string1 o string2 contiene códigos de caracteres anchos fuera del dominio de la secuencia de intercalación. Cuando se produce un error, _wcsnicoll puede establecer errno en EINVAL. Para comprobar si hay un error en una llamada a _wcsnicoll, establezca errno en 0 y observe errno después de llamar a _wcsnicoll.

Cada una de estas funciones realiza una comparación sin distinción entre mayúsculas y minúsculas de los primeros count caracteres de string1 y string2 según la página de códigos. Estas funciones solo se deben usar cuando el orden del juego de caracteres y el orden de los caracteres lexicográficos son distintos en la página de códigos, y la diferencia influye en la comparación de cadenas. Las versiones de estas funciones sin el sufijo _l usan la configuración regional y la página de códigos actuales. Las versiones con el sufijo _l son idénticas, salvo que usan 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 nulo, o si el recuento es mayor que INT_MAX, se invoca el controlador de parámetros no válidos, 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

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

Rutina

Encabezado necesario

_strnicoll , _strnicoll_l

<string.h>

_wcsnicoll , _wcsnicoll_l

<wchar.h> o <string.h>

_mbsnicoll , _mbsnicoll_l

<mbstring.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft