_mbsnbcat, _mbsnbcat_l

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

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。

語法

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 結束的字串不得超過目的緩衝區的大小。 如需詳細資訊，請參閱 避免緩衝區滿溢 。

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

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

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

泛型文字常式對應

Tchar.h 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

需求

常式	必要的標頭
_mbsnbcat	<mbstring.h>
_mbsnbcat_l	<mbstring.h>

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

另請參閱

字串操作
_mbsnbcmp, _mbsnbcmp_l
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
_mbsnbcpy, _mbsnbcpy_l
_mbsnbicmp, _mbsnbicmp_l
_mbsnbset, _mbsnbset_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
_mbsnbcat_s, _mbsnbcat_s_l