_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

Artykuł
06/09/2015

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óre są wykonywane w Środowisko wykonawcze systemu Windows.Aby uzyskać więcej informacji, zobacz funkcji CRT nie obsługują /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
Ciągi zerem do porównania.
count
Liczba znaków do porównania.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

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

Wartość zwracana	Opis
< 0	string1ciąg podrzędny jest mniejsza niż string2 podciągu.
0	string1ciąg podrzędny jest taka sama, jak string2 podciągu.
> 0	string1ciąg podrzędny jest większy niż string2 podciągu.

Na błąd sprawdzania poprawności parametru, te funkcje zwracają _NLSCMPERROR, która została zdefiniowana w < string.h > i < mbstring.h >.

Uwagi

_strnicmp Funkcji ordinally porównuje, co najwyżej pierwszy count znaków string1 i string2.Porównanie jest wykonywane bez uwzględniania wielkości liter konwertując każdy znak na małe litery._strnicmpjest to wersja bez uwzględniania wielkości liter strncmp.Porównanie kończy się po osiągnięciu kończącego znaku null w obu parametrach przed count znaki są porównywane.Jeśli ciągi są takie same po kończącego znaku null osiągnięciu w obu parametrach przed count znaki są porównywane, mniej ciąg jest wcześniejsza.

Znaki z 91 do 96 w tabeli ASCII ("[", "\", "]", "^", "_", i "") oceń jako mniej niż jakakolwiek alfabetu.Ta kolejność jest identyczna ze stricmp.

_wcsnicmpi _mbsnicmp są wersjami całego znaku i znaków wielobajtowych _strnicmp.Argumenty _wcsnicmp są ciągami znaków wide; te _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.Te trzy funkcje zachowują się tak samo w przeciwnym razie.Te funkcje zależą od ustawień regionalnych — wersje, które nie mają _l sufiks użycia bieżących ustawień regionalnych w celu ich działanie zależne od ustawień regionalnych; wersje, które mają _l sufiksu zamiast użycia locale przekazanego pakietu.Aby uzyskać więcej informacji, zobacz Regionalne.

Wszystkie te funkcje sprawdza poprawność ich parametrów.Jeśli jedna z metod string1 lub string2 wskaźnik null, program obsługi nieprawidłowy parametr zostanie wywołany, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli jest dozwolone wykonywanie, aby kontynuować, te funkcje zwracają _NLSCMPERROR i ustawić errno do EINVAL.

Mapowania procedur zwykłego tekstu