_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Článek
06/09/2015

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

Důležité
_mbsnicoll a _mbsnicoll_l nelze použít v aplikacích, které jsou spouštěny v modulu 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ězec zakončený null pro srovnání
count
Počet znaků, které mají být porovnány.
locale
Použité národní prostředí.

Vrácená hodnota

Každá z těchto funkcí vrací hodnotu, která označuje vztah mezi podřetězci string1 a string2*,* takto.

Návratová hodnota	Vztah řetězec1 k řetězec2
< 0	string1 menší než string2
0	string1 shodné s string2
> 0	string1 větší než string2

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

Poznámky

Každá z těchto funkcí provádí porovnávání bez ohledu na velikost písmen prvních count znaků v string1 a string2 podle kódové stránky.Tyto funkce by měly být používány pouze v případě, že existuje rozdíl mezi pořadím znakové sady a lexikografickým pořadím znaků v znakové stránce a tento rozdíl je relevantní pro porovnání řetězců.Verze těchto funkcí bez přípony _l používají aktuální národní prostředí a znakovou stránku.Verze s příponou _l jsou stejné s tím rozdílem, že používají předané národní prostředí.Další informace naleznete v tématu Národní prostředí.

Všechny tyto funkce ověřují své parametry.Pokud je string1 nebo string2 ukazatel s hodnotou null, nebo pokud je počet větší než INT_MAX, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v tématu Ověření parametru.Pokud provádění může pokračovat, vrátí tyto funkce _NLSCMPERROR a nastaví errno na EINVAL**.**

Rutinní mapování obecného textu