_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l
Służy do porównywania ciągów znaków, wykorzystując informacje specyficzne dla danej lokalizacji.
![]() |
---|
_mbsicolli _mbsicoll_l nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW. |
int _stricoll(
const char *string1,
const char *string2
);
int _wcsicoll(
const wchar_t *string1,
const wchar_t *string2
);
int _mbsicoll(
const unsigned char *string1,
const unsigned char *string2
);
int _stricoll_l(
const char *string1,
const char *string2,
_locale_t locale
);
int _wcsicoll_l(
const wchar_t *string1,
const wchar_t *string2,
_locale_t locale
);
int _mbsicoll_l(
const unsigned char *string1,
const unsigned char *string2,
_locale_t locale
);
Parametry
string1, string2
Zakończony zerem ciągów do porównania.locale
Ustawienia regionalne używane.
Wartość zwracana
Każda z tych funkcji zwraca wartość określającą relację z string1 do string2*,* się następujące zmiany.
Zwracana wartość |
Relacja ciąg1 do ciąg2 |
---|---|
< 0 |
string1mniej niżstring2 |
0 |
string1identycznestring2 |
> 0 |
string1większa niżstring2 |
_NLSCMPERROR |
Wystąpił błąd. |
Każdej z tych funkcji zwraca _NLSCMPERROR.To use _NLSCMPERROR, include either STRING.H or MBSTRING.H._wcsicollmoże się nie powieść, jeśli każda string1 lub string2 zawiera kody szerokich znaków spoza domeny sekwencji sortowania.Gdy wystąpi błąd, _wcsicoll może ustalić errno do EINVAL.Aby sprawdzić, czy błąd w wywołaniu _wcsicoll, zestaw errno na 0, a następnie sprawdź errno po wywołaniu _wcsicoll.
Uwagi
Każda z tych funkcji wykonuje porównania bez uwzględniania wielkości liter string1 i string2 zgodnie z obecnie używanej strony kodowej.Tych funkcji można używać tylko wtedy, gdy istnieje różnica między znak w porządku leksykograficznym znak w bieżącej strony kodowej i różnica ta ma znaczenie dla porównania ciągów.
_stricmpróżni się od _stricoll w tym _stricmp porównanie jest zagrożony LC_CTYPE, podczas gdy _stricoll porównanie jest według LC_CTYPE i LC_COLLATE kategorie określone w ustawieniach regionalnych.Więcej informacji na temat LC_COLLATE kategorii, zobacz setlocale i Kategorii.Wersje te funkcje, bez _l sufiks Użyj bieżących ustawień regionalnych; wersje z _l sufiks są identyczne z tym, że używają ustawień regionalnych, przekazany w zamian.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.
Wszystkie te funkcje sprawdzania poprawności ich parametrów.Jeśli każda string1 lub string2 są NULL wskaźniki, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje te zwracają _NLSCMPERROR i errno do EINVAL.
Tekst rodzajowy rutynowych mapowania
TCHAR.Rozpoczęto wykonywanie procedury h |
_UNICODE & _MBCS nie zdefiniowany |
_MBCS, definicja |
_UNICODE, definicja |
---|---|---|---|
_tcsicoll |
_stricoll |
_mbsicoll |
_wcsicoll |
Wymagania
Rozpoczęto wykonywanie procedury |
Wymaganego nagłówka |
---|---|
_stricoll, _stricoll_l |
<string.h> |
_wcsicoll, _wcsicoll_l |
<wchar.h>, <string.h> |
_mbsicoll, _mbsicoll_l |
<mbstring.h> |
Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.
Odpowiednik w programie .NET Framework
Zobacz też
Informacje
_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