_mbsnbicmp, _mbsnbicmp_l

Artykuł
03/26/2013

Porównuje n bajtów dwa ciągi znaków wielobajtowych, bez uwzględnienia wielkości liter.

Ważne
Ten interfejs API 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 _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

Parametry

string1, string2
Zakończony zerem ciągów do porównania.
count
Liczba bajtów do porównania.

Wartość zwracana

Zwracana wartość wskazuje relację między podciągów.

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

Na błąd _mbsnbcmp zwraca _NLSCMPERROR, który jest zdefiniowany w String.h i Mbstring.h.

Uwagi

_mbsnbicmp Funkcja leksykograficznym porównuje, co najwyżej pierwszy count bajtów string1 i string2.Porównanie jest wykonywane bez uwzględniania wielkości liter; _mbsnbcmpjest ona rozróżniana wielkość liter do _mbsnbicmp.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.

_mbsnbicmpjest podobny do _mbsnicmp, z tym, że porównuje ciągi bajtów, a nie według znaków.

Dwa ciągi zawierające znaki znajdujące się między "Z" i "" w tabeli ASCII ('[', ' \', ']', ' ^', '_', i ''') porównać różnie w zależności od tego, w ich przypadku.Na przykład, dwa ciągi "ABCDE"i"ABCD^" Porównanie jednym ze sposobów, jeśli wynikiem porównania jest małymi literami ("abcde" > "abcd^") and the other way ("ABCDE" < "ABCD^") jeżeli jest to wielkie litery.

_mbsnbicmprozpoznaje sekwencje znaków wielobajtowych, zgodnie z Strona kodowa wielobajtowych aktualnie w użyciu.Nie jest on zagrożony bieżących ustawień regionalnych.

Jeśli każda string1 lub string2 jest pusty wskaźnik, _mbsnbicmp wywołuje program obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może w dalszym ciągu, funkcja zwraca _NLSCMPERROR i ustawia errno do EINVAL.

Tekst rodzajowy rutynowych mapowania