_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Článek
03/26/2013

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

Důležité
_mbsnicolla _mbsnicoll_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 _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametry

string1, string2
Řetězce zakončené znakem null k porovnání
count
Počet znaků k porovnání
locale
Národní prostředí pro použití.

Vrácená hodnota

Každá z těchto funkcí vrací hodnotu označující vztah podřetězce string1 a string2*,* takto.

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

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

Poznámky

Každá z těchto funkcí se provádí porovnávání první count znaků v string1 a string2 podle kódu stránky.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 kódu stránky a tento rozdíl má význam pro porovnávání řetězců.Verze těchto funkcí, aniž by _l příponu použít aktuální národní prostředí a kód stránky.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 je ukazatel s hodnotou null, nebo pokud je větší než počet INT_MAX, je vyvolána 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