_mbsnbcat, _mbsnbcat_l

最多會將一個多位元組位元元串的前 n 個字節附加至另一個字節字串。 這些函式已有更安全的版本可用，請參閱 _mbsnbcat_s、_mbsnbcat_s_l。

語法

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

參數

dest
以 null 終止的多位元組字元目的字串。

src
以 null 終止的多位元組字元來源字串。

count
要從 src 附加至 dest 的位元組數。

locale
要使用的地區設定。

傳回值

_mbsnbcat 會傳回目的字元字串的指標。 未保留表示錯誤的傳回值。

備註

_mbsnbcat 函式最多會將 src 的前 count 個位元組附加至 dest。 如果緊接在 dest 中之 Null 字元之前的位元組是前導位元組，則 src 的初始位元組會覆寫此前導位元組。 否則，src 的初始位元組會覆寫 dest 之結束的 null 字元。 如果在已附加 count 個位元組之前，於 src 出現 null 位元組，則 _mbsnbcat 會附加 src 之中直到該 null 字元為止的所有位元組。 如果 count 大於 src 的長度，則會使用 src 的長度來取代 count。 此產生的字串會以 Null 字元結束。 如果在重疊的字串之間執行複製，則行為是未定義的。

輸出值會受到設定地區設定之 LC_CTYPE 類別設定的影響。 如需詳細資訊，請參閱setlocale。 這個函式的 _mbsnbcat 版本會針對此與地區設定相關的行為使用目前的地區設定；_mbsnbcat_l 版本與其相同，只不過它們會改用傳入的地區設定參數。 如需詳細資訊，請參閱 Locale。

安全性提示：使用以 Null 結束的字串。 以 Null 結束的字串不得超過目的緩衝區的大小。 如需詳細資訊，請參閱 Avoiding Buffer Overruns (避免緩衝區滿溢)。

如果 dest 或 src 為 NULL，函式將會產生無效的參數錯誤，如參數驗證中所述。 如果已處理此錯誤，則此函式會傳回 EINVAL，並將 errno 設定為 EINVAL。

在 C++ 中，這些函式具有樣板多載，可以叫用這些函式的更新且安全的對應版本。 如需詳細資訊，請參閱安全範本多載。

根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

一般文字常式對應

需求

如需相容性詳細資訊，請參閱相容性。

另請參閱

字串操作
_mbsnbcmp, _mbsnbcmp_l
_strncnt、、_wcsncnt_mbsnbcnt、_mbsnbcnt_l、、_mbsnccnt、_mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncat、、_strncat_lwcsncat、_wcsncat_l、、_mbsncat、_mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l