_mbsnbcat、_mbsnbcat_l

發行項
06/09/2015

最多附加第一個 n 位元組的多位元組字元字串到另一個。更多這些函式的可用安全版本，請參閱 _mbsnbcat_s、_mbsnbcat_s_l。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 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中。如果在 Null 字元之前的位元組在 dest 是前導位元組，初始位元組 src 覆寫這個前導位元組。否則，初始位元組 src 覆寫 dest結束的 null 字元。如果 null 位元組出現在 src ， count 附加前，位元組附加_mbsnbcat 從 src中的所有位元組，由 null 字元。如果 count 大於 src 的長度，長度為 src 而非 count 的。結果字串是以 NULL 字元結束。如果在重疊的字串之間執行複製，則行為是未定義的。

輸出值受地區設定的LC_CTYPE 分類設定所影響。如需詳細資訊，請參閱 setlocale 。使用目前地區設定地區設定相關行為的_mbsnbcat版本；_mbsnbcat_l版本除了傳遞不同的地區設定參數外都一樣。如需詳細資訊，請參閱地區設定。

Security Note 使用 null 結尾的字串。 null 結尾字串不能超過目的緩衝區的大小。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

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

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

一般文字常式對應