_mbsnbcat, _mbsnbcat_l

Makale
03/26/2013

En fazla ilk append n bayt sayısı olarak başka bir çok baytlı karakter dizesi.Bu işlevlerin daha güvenli sürümlerinde kullanılabilir; see _mbsnbcat_s, _mbsnbcat_s_l.

Önemli
Bu API, Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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
Çok baytlı karakter hedef boşlukla sonlandırılmış dize.
src
Biten kaynak çok baytlı karakter dizesi.
count
Bayt sayısı src eklemek için dest.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

_mbsnbcatHedef dize için bir işaretçi döndürür.Hiçbir değer döndürmeyen bir hatayı göstermek için ayrılmıştır.

Notlar

_mbsnbcat İşlev ekler, en çok, ilk count bayt src için dest.Yoksa null karakteri hemen öncesindeki bayt dest dosyanın ilk baytı bir ön bayt olup src bu ön bayt üzerine yazar.Aksi halde, dosyanın ilk baytı src , sondaki boş karakter üzerine yazar dest.Bir null bayt olarak görünüyorsa, src önce count bayt eklenir, _mbsnbcat alınan tüm baytlar ekler src, null karakteri kadar.count Uzunluğundan daha büyük src, uzunluğu, src yerine kullanılan count.Sonuç dizesi boş karakter ile sonlandırılır.Kopyalama, üst üste dizeler arasında yer alıyorsa, davranışı tanımsızdır.

Çıkış değeri ayarı tarafından etkilenen LC_CTYPE ; bölgesel ayar kategorisi bkz: setlocale daha fazla bilgi için._mbsnbcat İşlev sürümünü kullanan yerel bu yerel ayara bağımlı davranışı; _mbsnbcat_l dışında bunun yerine geçirilen yerel ayar parametresi kullandıkları sürüm aynıdır.Daha fazla bilgi için bkz. Yerel ayar.

Güvenlik notu null sonlandırılmış bir dize kullanın.Null sonlandırılmış bir dize hedef arabelleğin boyutunu aşmamalıdır.Daha fazla bilgi için bkz: Kaçınma arabelleğin taşmasına neden.

dest Veya src olan NULL, işlev içinde tanımlandığı gibi bir geçersiz parametre hatası oluşturacak Parametre doğrulama.Hata işlenmiş ise işlev verir EINVAL ve errno için EINVAL.

Bu işlevleri C++'da, bu işlevlerin daha yeni ve güvenli karşılıkları çağırmak şablon aşırı yükleme vardır.Daha fazla bilgi için bkz. Güvenli şablon aşırı yükleme.

Genel metin eşlemeleri yordamına girildi