_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l
Compara las cadenas usando la información de configuración regional- concreta.
Importante |
---|
_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 |
_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
Vea también
Referencia
_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l