_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l

Yerel ayara özgü bilgileri kullanarak dizeleri karşılaştırır.

Önemli notÖnemli

_mbsncoll ve _mbsncoll_l, Windows Çalışma Zamanı içinde yürütülen uygulamalarda kullanılamazlar.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

Parametreler

  • string1, string2
    Karşılaştırmak için null ile sonlandırılmış dizeler.

  • count
    Karşılaştırmak için karakter sayısı.

  • locale
    Kullanılacak yerel ayar.

Dönüş Değeri

Bu işlevlerden her biri bu nedenle arasındaki ilişkiyi gösteren bir değeri döndürür string1 ve string2, aşağıdaki gibi.

Dönüş değeri

dize1'in dize2 ile ilişkisi

< 0

string1, string2 değerinden küçüktür.

0

string1aynı string2.

> 0

string1değeri string2 değerinden daha büyüktür.

Bu işlevlerin her biri, _NLSCMPERROR öğesini döndürür.Kullanmak için _NLSCMPERROR, STRING.h veya MBSTRING.h içerir._wcsncollya da, başarısız string1 veya string2 harmanlama sırası etki alanı dışında olan geniş karakter kodlarını içerir.Bir hata oluştuğunda, _wcsncollerrno'yu EINVAL olarak ayarlayabilir.Yapılan çağrı sırasında hata denetlemek için _wcsncoll, belirlenen errno 0 ve errno ardından _wcsncoll.

Notlar

Bu işlevlerden her biri ilk büyük küçük harfe duyarlı bir karşılaştırma yapar count alanına string1 ve string2, şu anda kullanımda olan kod sayfası göre.Bu işlevler yalnızca kod sayfası karakter kümesi sırası ve lexicographic karakter sırası arasında fark olduğunda, bu farkın dize karşılaştırma için ilgi olduğunda kullanın.Karakter kümesi yerel ayara bağımlı sırasıdır.Yoksa bu işlevlerin sürümleri _l sonek kullanımı geçerli yerel ayarı, ancak olan sürümleri _l son geçirilen yerel ayar kullan.Daha fazla bilgi için bkz. Yerel Ayar.

Bu işlevlerin tümü kendi parametrelerini doğrular.Ya da, string1 veya string2 bir null işaretçi veya count daha büyük INT_MAX, açıklandığı gibi geçersiz bir parametre işleyicisi çağrılır Parametre Doğrulama.Yürütmenin devam etmesine izin verilirse, bu işlevler _NLSCMPERROR döndürür ve errno öğesini EINVAL olarak ayarlar.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı

_UNICODE & _MBCS tanımlanmamış

_MBCS tanımlanmış

_UNICODE tanımlanmış

_tcsnccoll

_strncoll

_mbsncoll

_wcsncoll

_tcsncoll

_strncoll

_mbsnbcoll

_wcsncoll

Gereksinimler

Yordam

Gerekli başlık

_strncoll, _strncoll_l

<string.h>

_wcsncoll, _wcsncoll_l

<wchar.h> veya <string.h>

_mbsncoll, _mbsncoll_l

<mbstring.h>

Ek uyumluluk bilgileri için bkz. Uyumluluk.

.NET Framework Eşdeğeri

System::String::Compare

Ayrıca bkz.

Başvuru

Yerel Ayar

Dize Düzenlemesi (CRT)

strcoll İşlevleri

localeconv

_mbsnbcoll, _mbsnbcoll_l, _mbsnbicoll, _mbsnbicoll_l

setlocale, _wsetlocale

strcmp, wcscmp, _mbscmp

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l