_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Článek
03/26/2013

Porovnání řetězců pomocí informací specifických pro národní prostředí.

Důležité
_mbsicolla _mbsicoll_l nelze použít v aplikacích, které jsou spuštěny v systému Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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
Řetězce zakončené znakem null pro porovnání.
locale
Národní prostředí pro použití.

Vrácená hodnota

Každá z těchto funkcí vrací hodnotu určující vztah mezi string1 na string2*,* takto.

Vrácená hodnota	Vztah řetězec1 k řetězec2
< 0	string1menší nežstring2
0	string1shodné sstring2
> 0	string1větší nežstring2
_NLSCMPERROR	Vyskytla se chyba.

Každá z těchto funkcí vrací _NLSCMPERROR.To use _NLSCMPERROR, include either STRING.H or MBSTRING.H._wcsicollmůže selhat, pokud buď string1 nebo string2 obsahuje kódy širokého znaku mimo doménu pořadí řazení.Dojde-li k chybě, _wcsicoll mohou errno na EINVAL.Chcete-li vyhledat chyby na volání _wcsicoll, nastavte errno 0 a pak zkontrolujte errno po volání _wcsicoll.

Poznámky

Každá z těchto funkcí se provádí porovnávání z string1 a string2 podle kódu stránky aktuálně používán.Tyto funkce by měla sloužit pouze v případě, že existuje rozdíl mezi znakem objednávky a objednávky lexicographic znak v aktuální znakové stránky a tento rozdíl má význam pro porovnávání řetězců.

_stricmpse liší od _stricoll v tom, že _stricmp je ovlivněn porovnání LC_CTYPE, že _stricoll srovnání podle LC_CTYPE a LC_COLLATE kategorie národní prostředí.Další informace o LC_COLLATE kategorie, viz setlocale a Kategorie národního prostředí.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí; verze s _l s tím rozdílem, že používají národní prostředí, místo něho předán shodná přípona.Další informace naleznete v tématu Národní prostředí.

Všechny tyto funkce ověření jejich parametrů.Pokud string1 nebo string2 jsou NULL je vyvolán ukazatelů, obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, tyto funkce vracejí _NLSCMPERROR a errno na EINVAL.

Mapování rutiny obecného textu