_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

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

System_CAPS_ICON_important.jpg Importante

_mbsncoll y _mbsncoll_l no se pueden usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para 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 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 devueltoRelación de string1 y string2
< 0string1 es menor que string2.
0string1 es idéntica a string2.
> 0string1 es mayor que string2.

Cada una de estas funciones devuelve _NLSCMPERROR. Para usar _NLSCMPERROR, incluya STRING.h o MBSTRING.h. _wcsncoll puede producir un error si string1 o string2 contiene códigos de caracteres anchos que están fuera del dominio de la secuencia de intercalació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 en 0 y observe 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 count caracteres de string1 y string2 según la página de códigos que esté en uso. Use estas funciones solo cuando el orden del juego de caracteres y el orden de los caracteres lexicográficos sean distintos en la página de códigos y cuando la diferencia influya en la comparación de cadenas. El orden del conjunto de caracteres depende de la configuración regional. Las versiones de estas funciones que no tienen el sufijo _l usan la configuración regional actual, pero las versiones de estas funciones que tienen el sufijo _l usan la configuración regional que se pasa. Para obtener más información, vea Locale.

Todas estas funciones validan sus parámetros. Si el valor string1 o string2 es un puntero nulo, o count es mayor que INT_MAX, se invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. 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
RutinaEncabezado necesario
_strncoll, _strncoll_l<string.h>
_wcsncoll, _wcsncoll_l<wchar.h> o <string.h>
_mbsncoll, _mbsncoll_l<mbstring.h>

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

System::String::Compare

Configuración regional
Manipulación de cadenas
strcoll (función)
localeconv
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
setlocale, _wsetlocale
strcmp, wcscmp, _mbscmp
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Mostrar: