_mbsnbcat, _mbsnbcat_l

Makale
06/09/2015

En fazla, bir çok baytlı karakterli dizenin ilk n baytlarını bir diğerine ekler.Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. _mbsnbcat_s, _mbsnbcat_s_l.

Önemli
Bu API, Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

unsigned char *_mbsnbcat(
   unsigned char *dest,
   const unsigned char *src,
   size_t count 
);
unsigned char *_mbsnbcat_l(
   unsigned char *dest,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char *_mbsnbcat(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsnbcat_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Parametreler

dest
Null ile sonlandırılmış çok baytlı karakter hedef dizesi.
src
Null ile sonlandırılmış çok baytlı karakter kaynak dizesi.
count
dest hedefinin sonuna eklenecek src kaynaklı bayt sayısı.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

_mbsnbcat hedef dizeye bir işaretçi döndür.Bir hata gösterecek bir dönüş değeri ayrılmamış.

Notlar

_mbsnbcat işlevi, src dizesinin en çok count baytını dest dizesine ekler.dest içinde bayt null karakterden hemen sonra geliyorsa bir ön bayttır; src ilk baytı bu ön baytın üzerine yazılır.Aksi takdirde, src parametresinin ilk baytı dest sonlandırıcı null karakterinin üzerine yazılır.count baytları eklenmeden önce src içinde bir boş bayt görünürse, _mbsnbcatsrc öğesindeki tüm baytları boş karaktere kadar ekler.count uzunluğu src uzunluğundan büyükse, count yerine src uzunluğu kullanılır.Sonuç dizesi boş bir karakter ile sonlandırılır.Çakışan dizeler arasında kopyalama yer alırsa davranış tanımsızdır.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarından etkilenir; daha fazla bilgi için, bkz. setlocale.İşlevin _mbsnbcat sürümü yerel ayara bağımlı bu davranış için geçerli yerel ayarı kullanır; _mbsnbcat_l sürümü, yerel ayar parametresinin işleve geçilmesi dışında aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Güvenlik Notu Null ile sonlandırılmış bir dize kullanın.Null ile sonlandırılmış dize hedef arabelleğinin boyutunu aşamaz.Daha fazla bilgi için, bkz. Arabellek Taşmalarını Önleme.

dest veya srcNULL ise, işlev Parametre Doğrulama konusunda açıklanan şekilde geçersiz bir parametre üretecektir.Hata işlenirse, işlev EINVAL değerini döndürür ve errno değişkenini EINVAL olarak ayarlar.

C++ dilinde, bu işlevlerin daha yeni ve güvenli karşıtlarını başlatan şablon aşırı yüklemeleri vardır.Daha fazla bilgi için bkz. Güvenli Şablon Aşırı Yüklemeleri.

Genel Metin Yordam Eşleşmeleri