funciones de strcoll

Cada una de las funciones de strcoll y de wcscoll compara dos cadenas según el valor de la categoría de LC_COLLATE de la página de códigos de la configuración regional actualmente en uso.Cada una de las funciones de _mbscoll compara dos cadenas según la página de códigos multibyte actualmente en uso.Utilice las funciones de coll para las comparaciones de cadenas 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 actual y esta diferencia de interés para la comparación.Utilice las funciones correspondientes de cmp para probar únicamente para la igualdad de la cadena.

funciones de strcoll

SBCS

Unicode

MBCS

Descripción

strcoll

wcscoll

_mbscoll

Collate dos cadenas

_stricoll

_wcsicoll

_mbsicoll

Collate dos cadenas (sin distinción entre mayúsculas y minúsculas)

_strncoll

_wcsncoll

_mbsncoll

Collate los primeros caracteres de count de dos cadenas

_strnicoll

_wcsnicoll

_mbsnicoll

Collate los primeros caracteres de count de dos cadenas (sin distinción entre mayúsculas y minúsculas)

Comentarios

Las versiones de caracteres (SBCS) de un solo byte de estas funciones (strcoll, stricoll, _strncoll, y _strnicoll) se comparan string1 y string2 según el valor de la categoría de LC_COLLATE de la configuración regional actual.Estas funciones se diferencian de las funciones correspondientes de strcmp en que las funciones de strcoll utilizan la información de página de códigos de la configuración regional que proporciona secuencias de ordenación.Para las comparaciones de cadenas en configuraciones regionales en las que el juego de caracteres order y difiere el orden lexicográfico de caracteres, las funciones de strcoll se deben utilizar en lugar de las funciones correspondientes de strcmp .Para obtener más información sobre LC_COLLATE, vea setlocale.

Para algunas páginas de códigos y juegos de caracteres correspondientes, el orden de los caracteres del juego de caracteres puede diferir del orden lexicográfico de caracteres.En la configuración regional “c”, éste no es el caso: el orden de los caracteres del juego de caracteres ASCII es el mismo que el orden lexicográfico de caracteres.Sin embargo, en algunas páginas de códigos europeas, por ejemplo, el carácter “a” (valor 0x61) precede el carácter “ä” (valor 0xE4) en el juego de caracteres, pero el carácter “ä” precede el carácter “a” lexicográficamente.Para realizar una comparación lexicográfica en una instancia de, utilice strcoll en lugar de strcmp.Alternativamente, puede utilizar strxfrm en cadenas originales, utiliza strcmp en las cadenas resultantes.

strcoll, stricoll, _strncoll, y de _strnicoll cadenas de caracteres multibyte ID automáticamente según la página de códigos de la configuración regional actualmente en uso, al igual que sus homólogos de caracteres anchos (Unicode).Las versiones (MBCS) de caracteres multibyte de estas funciones, sin embargo, intercalan cadenas de caracteres de la página de códigos multibyte actualmente en uso.

Dado que las funciones de coll intercalan cadenas lexicográficamente para la comparación, mientras que las funciones de cmp prueban simplemente para la igualdad de la cadena, las funciones de coll son mucho más lentas que las versiones correspondientes de cmp .Por consiguiente, las funciones de coll deben utilizar 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 actual y esta diferencia de interés para la comparación de cadenas.

Vea también

Referencia

Configuración regional

Manipulación de cadenas (CRT)

localeconv

_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

setlocale, _wsetlocale

strcmp, wcscmp, _mbscmp

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l