_mbsnbcat _mbsnbcat_l

發行項
03/26/2013

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

重要

這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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 函式，附加至多，第一個 count 位元組至 dest的 src 。如果在 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 結尾的字串。 innull 結尾字串不能超過目的緩衝區的大小。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

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

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

泛用文字常式對應