¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l
div
EOF
Collapse the table of content
Expand the table of content
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

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

Nota importante Importante

_mbsnicoll y _mbsnicoll_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 _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 a comparar

count

Número de caracteres a comparar

locale

La configuración regional a utilizar.

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 menos que string2

0

string1 idéntico a string2

> 0

string1 mayor que string2

Cada una de estas funciones devuelve _NLSCMPERROR. Para utilizar _NLSCMPERROR, incluya STRING.H o MBSTRING.H. _wcsnicoll 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, _wcsnicoll puede establecer errno a EINVAL. Para comprobar si hay un error en una llamada a _wcsnicoll, establezca errno a 0 y compruebe 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 caracteres de count en string1 y string2 según la página de códigos. 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 y esta diferencia de interés para la comparación de cadenas. Las versiones de estas funciones sin el sufijo de _l utilizan la configuración regional y la página de códigos 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 un puntero NULL, o si el número 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.

Asignaciones de la rutina de Genérico- texto

Rutina de 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 información adicional de compatibilidad, vea Compatibilidad en la Introducción.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft