_strncoll
, _wcsncoll
, _mbsncoll
, , _strncoll_l
, _wcsncoll_l
, _mbsncoll_l
Yerel ayara özgü bilgileri kullanarak dizeleri karşılaştırır.
Önemli
_mbsncoll
ve _mbsncoll_l
Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
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 olarak sonlandırılan dizeler.
count
Karşılaştıracak karakter sayısı.
locale
Kullanılacak yerel ayar.
Dönüş değeri
Bu işlevlerin her biri, ve string2
alt dizelerinin string1
ilişkisini gösteren bir değer döndürür.
Dönüş değeri | string1 ile ilişkisistring2 |
---|---|
< 0 | string1 değerinden string2 küçüktür. |
0 | string1 ile string2 aynıdır. |
> 0 | string1 değerinden string2 büyüktür. |
Bu işlevlerin her biri döndürür _NLSCMPERROR
. kullanmak _NLSCMPERROR
için STRING.h veya MBSTRING.h ekleyin. _wcsncoll
veya harmanlama dizisinin etki alanı dışında olan geniş karakter kodları içeriyorsa başarısız string1
string2
olabilir. Bir hata oluştuğunda olarak _wcsncoll
ayarlanabilir errno
EINVAL
. çağrısında _wcsncoll
hata olup olmadığını denetlemek için 0 olarak ayarlayın errno
ve ardından aramadan _wcsncoll
sonra denetleyinerrno
.
Açıklamalar
Bu işlevlerin her biri, şu anda kullanımda olan kod sayfasına göre ve string2
içindeki string1
ilk count
karakterlerin büyük/küçük harfe duyarlı karşılaştırmasını gerçekleştirir. Bu işlevleri yalnızca, karakter kümesi sırası ile kod sayfasındaki sözcüksel karakter sırası arasında bir fark olduğunda ve bu fark dize karşılaştırması için önemli olduğunda kullanın. Karakter kümesi sırası yerel ayara bağlıdır. Bu işlevlerin son ekine sahip _l
olmayan sürümleri geçerli yerel ayarı kullanır, ancak son eki olan _l
sürümler geçirilen yerel ayarı kullanır. Daha fazla bilgi için bkz . Yerel Ayar.
Bu işlevlerin tümü parametrelerini doğrular. string1
string2
Veya bir null işaretçiyse veya count
değerinden INT_MAX
büyükse, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler döndürülerek _NLSCMPERROR
olarak EINVAL
ayarlanırerrno
.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.
Genel metin yordamı eşlemeleri
TCHAR.H yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_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> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Ayrıca bkz.
Yerel ayar
Dize işleme
strcoll
iş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