_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

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

Nota importanteImportante

_mbsncoll y _mbsncoll_l no se pueden utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones CRT no compatibles 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 a comparar.

  • count
    Número de caracteres que se va a comparar.

  • locale
    La configuración regional a utilizar.

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éntico 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 a 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 _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

_tcsnccoll

_strncoll

_mbsncoll

_wcsncoll

_tcsncoll

_strncoll

_mbsnbcoll

_wcsncoll

Requisitos

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.

Equivalente en .NET Framework

System::String::Compare

Vea también

Referencia

Configuración regional

Manipulación de cadenas (CRT)

funciones de strcoll

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