_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artykuł
03/26/2013

Porównuje znaków z dwóch ciągów bez uwzględniania wielkości liter.

Ważne
_mbsnicmpi _mbsnicmp_l nie można używać w aplikacji, których wykonywanie w Środowisko wykonawcze systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsługiwane przez /ZW.

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_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

Wskazuje relację między podciągów, w następujący sposób.

Zwracana wartość	Opis
< 0	string1podciąg jest mniejsza niż string2 podciągu.
0	string1podciąg jest identyczny z string2 podciągu.
> 0	string1podciąg jest większa niż string2 podciągu.

Na błąd _mbsnicmp zwraca _NLSCMPERROR, który jest zdefiniowany w ciągu.H i MBSTRING.H.

Uwagi

_strnicmp Funkcja leksykograficznym porównuje, co najwyżej pierwszy count znaków z string1 i string2.Porównanie jest wykonywane bez uwzględniania wielkości liter; _strnicmpjest ona rozróżniana wielkość liter do strncmp.Porównanie kończy się, jeśli kończącego znaku null zostanie osiągnięty w albo ciąg przed count znaki są porównywane.Jeśli ciągi są równe kończącego znaku null osiągnięciu w albo ciąg przed count znaki są porównywane, krótszego ciągu jest mniejszy.

Znaki od 91 do 96 w tabeli ASCII ('[', ' \', ']', ' ^', '_', i ''') oceny mniejsza, niż jakakolwiek znak alfabetu.Ta kolejność jest identyczna z stricmp.

_wcsnicmpi _mbsnicmp szerokich znaków i znaków wielobajtowych wersje _strnicmp.Argumenty i wartości zwracanej przez _wcsnicmp są ciągami szerokich znaków; tych z _mbsnicmp są ciągami znaków wielobajtowych._mbsnicmprozpoznaje sekwencje znaków wielobajtowych, zgodnie z bieżącej strony kodowej wielobajtowych i zwraca _NLSCMPERROR na błąd.Aby uzyskać więcej informacji, zobacz Strony kodowe.Zmienia tych trzech funkcji zachowanie takich samych nazwach.Funkcje te ulegają zmianie ustawień regionalnych — wersje, które nie mają _l sufiks użyć bieżących ustawień regionalnych dla ich zachowanie zależne od ustawień lokalnych; wersje, które mają _l sufiks zamiast tego użyć ustawień regionalnych, który jest przekazywana.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, 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