_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

Artykuł
06/09/2015

Porównuje bajty n dwóch ciągów znaków wielobajtowych przy użyciu informacji na stronie kodowej znaków wielobajtowych.

Ważne
Tego API nie można używać w aplikacjach korzystających ze środowiska wykonawczego Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /ZW.

int _mbsnbcoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _mbsnbcoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);
int _mbsnbicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _mbsnbicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametry

string1, string2
Ciąg do porównania z.
count
Liczba bajtów do porównania.
locale
Ustawienia regionalne do użycia.

Wartość zwracana

Wartość zwracana określa relację z podciągów z string1 i string2.

Wartość zwrócona	Opis
< 0	string1 podciąg mniejszy niż string2 podciąg.
0	string1 podciąg identyczny z string2 podciągiem.
> 0	string1 podciąg większy niż string2 podciąg.

Jeśli string1 lub string2 ma wartość NULL lub count jest większy niż INT_MAX, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, te funkcje zwracają _NLSCMPERROR i ustawiają errno na EINVAL.Aby użyć _NLSCMPERROR włącz String.h lub Mbstring.h.

Uwagi

Każda z tych funkcji porównuje, co najwyżej, pierwsze bajty count w string1 i string2, i zwraca wartość określającą relację między wynikowymi podciągami string1 i string2.Jeżeli bajt końcowy w podciągu string1 lub string2 jest bajtem wiodącym, nie jest objęty porównaniem; te funkcji porównują tylko całe znaki w podciągach._mbsnbicoll jest wersją uwzględniającą wielkości liter _mbsnbcoll.Podobnie jak _mbsnbcmp i _mbsnbicmp, _mbsnbcoll i _mbsnbicoll porównują dwa ciągi znaków wielobajtowych w leksykograficznej kolejności określonej przez wielobajtową stronę kodową używaną obecnie.

W przypadku niektórych stron kodowych i odpowiednich zestawów znaków, kolejności znaków w zestawie znaków mogą różnić się od kolejności leksykograficznej znaków.W ustawieniach regionalnych języka „C”, to nie jest przypadek: kolejność znaków z zestawie znaków ASCII jest taka sama jak w porządku leksykograficznym znaków.Jednak w przypadku niektórych europejskich stron kodu, na przykład znak „a” (wartość 0x61) poprzedza znak „ä” (wartość 0xE4) w zestawie znaków, ale znak „ä” poprzedza znak „a” leksykograficznie.Aby przeprowadzić leksykograficzne porównanie ciągów według bajtów w takim przypadku, należy użyć _mbsnbcoll zamiast _mbsnbcmp; aby wyświetlić tylko ciąg znaków równości, użyj _mbsnbcmp.

Ponieważ funkcje coll zestawiają ciągi leksykograficznie dla celów porównawczych, podczas gdy funkcje cmp po prostu testują dla równości ciągu, funkcje coll są znacznie wolniejsze niż odpowiadające wersje cmp.W związku z tym coll funkcji należy używać tylko wtedy, gdy istnieje różnica pomiędzy kolejnością zestawu znaków i kolejnością znaków leksykograficznych w bieżącej stronie kodowej, a różnica ta ma znaczenie dla porównania.

Wartość wyjściowa jest zależna od konfiguracji ustawień kategorii LC_CTYPE ustawień regionalnych; zobacz setlocale, aby uzyskać więcej informacji.Wersje tych funkcji, które nie mają przyrostka _l używają bieżących ustawień regionalnych dla wszelkich zachowań zależnych od ustawień lokalnych; wersje, które mają przyrostek _l są identyczne, z tą różnicą, że w zamian korzystają z przekazanego parametru ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Regionalne.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE i _MBCS nie zdefiniowany	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tcsncoll	_strncoll	_mbsnbcoll	_wcsncoll
_tcsncoll_l	_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l	_mbsnbcoll_l	_wcsncoll_l
_tcsnicoll	_strnicoll	_mbsnbicoll	_wcsnicoll
_tcsnicoll_l	_strnicoll_l	_mbsnbicoll_l	_wcsnicoll_l