_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Artykuł
03/26/2013

Służy do porównywania ciągów znaków, wykorzystując informacje specyficzne dla danej lokalizacji.

Ważne
_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