strcat_s，wcscat_s _mbscat_s

附加字串。這些是 strcat，wcscat _mbscat 的安全性增強版本，如 安全性功能，則在 CRT 中 中所述。

重要事項
_mbscat_s 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

errno_t strcat_s(
   char *strDestination,
   size_t numberOfElements,
   const char *strSource 
);
errno_t wcscat_s(
   wchar_t *strDestination,
   size_t numberOfElements,
   const wchar_t *strSource 
);
errno_t _mbscat_s(
   unsigned char *strDestination,
   size_t numberOfElements,
   const unsigned char *strSource 
);
template <size_t size>
errno_t strcat_s(
   char (&strDestination)[size],
   const char *strSource 
); // C++ only
template <size_t size>
errno_t wcscat_s(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource 
); // C++ only
template <size_t size>
errno_t _mbscat_s(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource 
); // C++ only

參數

• strDestination
  innull 結尾字串的目的緩衝區。

• numberOfElements
  目的資料緩衝區的大小。

• strSource
  innull 結尾字串的來源緩衝區。

傳回值

零，如果成功;在失敗時的錯誤碼。

錯誤情況

strDestination	numberOfElements	strSource	傳回值	strDestination的內容。
NULL 或未結束	any	any	EINVAL	無法修改
any	any	NULL	EINVAL	strDestination[0 個] 設定為 0
any	0、太小	any	ERANGE	strDestination[0 個] 設定為 0

備註

strcat_s 函式會將 strSource 附加至 strDestination 並結束的 null 字元的結果字串。strSource 的初始字元覆寫 strDestination結束的 null 字元。如果來源和目的資料重疊， strcat_s 行為是未定義。

請注意第二個參數是緩衝區的總數，而非剩餘大小:

char buf[16];
strcpy_s(buf, 16, "Start");
strcat_s(buf, 16, " End");               // Correct
strcat_s(buf, 16 – strlen(buf), " End"); // Incorrect

wcscat_s 和 _mbscat_s 是 strcat_s 的寬字元和多位元組字元版本。wcscat_s 的參數和回傳值是寬字元字串，而 _mbscat_s 則是多位元組字元字串。這三個函式其餘部分的運作相同。

如果 strDestination 為 null 指標或不是以 null 結束，或者，如果 strSource 是 NULL 指標，或者，如果目的字串太小，無效的參數叫用處理常式，如 參數驗證中所述。如果執行允許繼續執行，這些函式傳回 EINVAL 並將 errno 設為 EINVAL。

在 C++ 中，使用這些函式由範本多載簡化;多載會推斷緩衝區長度 (自動排除指定大小引數)，也可以用它們較新，安全對應自動取代舊，不安全的函式。如需詳細資訊，請參閱安全範本多載。

這些函式的偵錯版本會先填入 0xFD 緩衝區。若要停用此行為，請使用 _CrtSetDebugFillThreshold 。

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcscat_s	strcat_s	_mbscat_s	wcscat_s

需求

程序	必要的標頭檔
strcat_s	<string.h>
wcscat_s	<string.h> 或 <wchar.h>
_mbscat_s	<mbstring.h>

如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。

範例

請參閱 strcpy_s，wcscpy_s _mbscpy_s中的程式碼範例。

.NET Framework 對等用法

System::String::Concat

請參閱

參考

字串操作 (CRT)

strncat、 _strncat_l、 wcsncat、 wcsncat_l、 _mbsncat _mbsncat_l

strncmp、 wcsncmp、 _mbsncmp、 _mbsncmp_l

strncpy、 _strncpy_l、 wcsncpy、 _wcsncpy_l、 _mbsncpy、 _mbsncpy_l

_strnicmp、 _wcsnicmp、 _mbsnicmp、 _strnicmp_l、 _wcsnicmp_l、 _mbsnicmp_l

strrchr、 wcsrchr、 _mbsrchr、 _mbsrchr_l

strspn、 wcsspn、 _mbsspn、 _mbsspn_l