_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_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
_mbsnicolli _mbsnicoll_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 _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
Zakończony zerem ciągów do porównania
count
Liczba znaków do porównania
locale
Ustawienia regionalne używane.

Wartość zwracana

Każda z tych funkcji zwraca wartość określającą relację podciągów z string1 i 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

Każdej z tych funkcji zwraca _NLSCMPERROR.Aby użyć _NLSCMPERROR, to albo ciąg.H lub MBSTRING.H._wcsnicollmoż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, _wcsnicoll może ustalić errno do EINVAL.Aby sprawdzić, czy błąd w wywołaniu _wcsnicoll, zestaw errno na 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 pierwszego count znaków w string1 i string2 zgodnie ze stroną kodową.Tych funkcji można używać tylko wtedy, gdy istnieje różnica między znak ustawić kolejność i kolejność znaków leksykograficznych w stronie kodowej oraz różnica ta ma znaczenie dla porównania ciągów.Wersje te funkcje, bez _l sufiks strona bieżące ustawienia regionalne i kodu.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 jest pusty wskaźnik, lub jeśli liczba jest większa niż INT_MAX, 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