_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l

Artykuł
06/09/2015

Porównuje ciągi przy użyciu informacji specyficznych dla danej lokalizacji.

Ważne
_mbsnicoll i _mbsnicoll_l nie można używać w aplikacjach korzystających ze środowiska wykonawczego systemu Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /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
Ciągi zakończone wartością null do porównania.
count
Liczba znaków do porównania
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda z tych funkcji zwraca wartość wskazującą, związek podciągów string1 i string2*,* w następujący sposób.

Wartość zwrócona	Relacja ciąg1 do ciąg2
< 0	string1 mniejszy niż string2
0	string1 identyczne z string2
> 0	string1 większy niż string2

Każda z tych funkcji zwraca _NLSCMPERROR.Aby użyć _NLSCMPERROR włącz STRING.H lub MBSTRING.H._wcsnicoll może się nie powieść, jeśli string1 lub string2 zawiera kody znaków dwubajtowych spoza domeny sekwencji sortowania.Gdy wystąpi błąd, _wcsnicoll może ustawić errno jako EINVAL.Aby sprawdzić pod kątem wystąpienia błędu w wywołaniu _wcsnicoll, ustaw errno na wartość 0, a następnie sprawdź errno po wywołaniu _wcsnicoll**.**

Uwagi

Każda z tych funkcji wykonuje porównania bez uwzględniania wielkości liter pierwszych znaków count w string1 i string2 zgodnie ze stroną kodową.Te funkcje powinny być używane tylko wtedy, gdy istnieje różnica pomiędzy kolejnością zestawu znaków i kolejnością znaków leksykograficznych w bieżącej stronie kodowej, a różnica ta ma znaczenie dla porównania ciągu.Wersje tej funkcje bez _l sufiksa używa bieżących ustawień regionalnych i kodu strony.Wersje z_l sufiksem są identyczne z tym, że używają one ustawień regionalnych przekazanych w zamian.Aby uzyskać więcej informacji, zobacz Regionalne.

Wszystkie te funkcje sprawdzają poprawność swoich parametrów.Jeśli string1 lub string2 jest wskaźnikiem typu null, lub liczba wystąpień jest większa od INT_MAX, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru .Jeśli wykonanie może być kontynuowane, te funkcje zwracają _NLSCMPERROR i ustawiają errno jako EINVAL**.**

Rutynowe mapowania zwykłego tekstu