_mbsnbicmp, _mbsnbicmp_l

Artykuł
06/09/2015

Porównuje n bajtów znaków wielobajtowych dwa ciągi i ignoruje wielkość liter.

Ważne
Ten interfejs API nie można używać w aplikacji, które są wykonywane w środowiska wykonawczego systemu Windows.Aby uzyskać więcej informacji, zobacz funkcji CRT nie obsługują /ZW.

int _mbsnbicmp(    const unsigned char *string1,    const unsigned char *string2,    size_t count  );

Parametry

string1, string2
Ciągi zerem do porównania.
count
Liczba bajtów do porównania.

Wartość zwracana

Wartość zwracana wskazuje relację między podciągów.

Wartość zwracana	Opis
< 0	string1substring mniej niż string2 podciągu.
0	string1taka sama, jak SUBSTRING string2 podciągu.
> 0	string1substring równy string2 podciągu.

W przypadku błędu _mbsnbcmp zwraca _NLSCMPERROR, która została zdefiniowana w String.h i Mbstring.h.

Uwagi

_mbsnbicmp Funkcji wykonuje {numer porządkowy porównanie co najwyżej pierwszego count bajtów string1 i string2.Porównanie odbywa się za pomocą konwersji każdy znak na małe litery; _mbsnbcmp jest uwzględniana wielkość liter w nieco _mbsnbicmp.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.

_mbsnbicmp jest podobny do _mbsnicmp, z tą różnicą, że do porównywania ciągów count bajtów zamiast według znaków.

Dwa ciągi zawierający znaki znajdujące się między "Z" i "" w tabeli ASCII ("[", "\", "]", "^", "_" i "") porównania inaczej, w zależności od ich przypadku.Na przykład dwa ciągi "ABCDE"i"ABCD^" porównanie jeden ze sposobów, jeśli wynikiem porównania jest małe litery ("abcde" > "abcd^") i w inny sposób ("ABCDE" < "ABCD^") w przypadku wielkich liter.

_mbsnbicmprozpoznaje sekwencje znaków wielobajtowych zgodnie z strony kodowej wielobajtowych aktualnie w użyciu.Nie dotyczy ona bieżących ustawień regionalnych.

Jeśli jedna z metod string1 lub string2 wskaźnik null, _mbsnbicmp wywołuje program obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli jest dozwolone wykonywanie, aby kontynuować, funkcja zwraca _NLSCMPERROR i ustawia errno do EINVAL.

Mapowania procedur zwykłego tekstu