strcat、wcscat、_mbscatstrcat, wcscat, _mbscat

文字列を追加します。Appends a string. これらの関数にはセキュリティが強化されたバージョンがあります、「strcat_s、wcscat_s、_mbscat_s」をご覧ください。More secure versions of these functions are available; see strcat_s, wcscat_s, _mbscat_s.

重要

_mbscat_sは、Windows ランタイムで実行されるアプリケーションでは使用できません。_mbscat_s cannot be used in applications that execute in the Windows Runtime. 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。For more information, see CRT functions not supported in Universal Windows Platform apps.

構文Syntax

char *strcat(
   char *strDestination,
   const char *strSource
);
wchar_t *wcscat(
   wchar_t *strDestination,
   const wchar_t *strSource
);
unsigned char *_mbscat(
   unsigned char *strDestination,
   const unsigned char *strSource
);
template <size_t size>
char *strcat(
   char (&strDestination)[size],
   const char *strSource
); // C++ only
template <size_t size>
wchar_t *wcscat(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource
); // C++ only
template <size_t size>
unsigned char *_mbscat(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource
); // C++ only

パラメーターParameters

strDestinationstrDestination
NULL で終わる追加先の文字列。Null-terminated destination string.

strSourcestrSource
NULL で終わる元の文字列。Null-terminated source string.

戻り値Return Value

これらの各関数は、変換先文字列 (strdestination) を返します。Each of these functions returns the destination string (strDestination). エラーを示す戻り値は予約されていません。No return value is reserved to indicate an error.

RemarksRemarks

Strcat関数は、 Strsourcestrsourceに追加し、結果の文字列を null 文字で終了します。The strcat function appends strSource to strDestination and terminates the resulting string with a null character. Strsourceの最初の文字は、 strsourceの終端の null 文字を上書きします。The initial character of strSource overwrites the terminating null character of strDestination. コピー元とコピー先の文字列が重なり合っている場合、 strcatの動作は未定義です。The behavior of strcat is undefined if the source and destination strings overlap.

重要

Strcatstrdestinationを追加する前に、 strdestinationに十分な領域があるかどうかを確認しないため、バッファーオーバーランの可能性があります。Because strcat does not check for sufficient space in strDestination before appending strSource, it is a potential cause of buffer overruns. 代わりに strncat の使用を検討してください。Consider using strncat instead.

wcscat_mbscatは、 strcatのワイド文字バージョンとマルチバイト文字バージョンです。wcscat and _mbscat are wide-character and multibyte-character versions of strcat. Wcscatの引数と戻り値はワイド文字列です。これらの _mbscatはマルチバイト文字列です。The arguments and return value of wcscat are wide-character strings; those of _mbscat are multibyte-character strings. それ以外では、これらの関数の動作は同じです。These three functions behave identically otherwise.

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. 詳細については、「 Secure Template Overloads」を参照してください。For more information, see Secure Template Overloads.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_tcscat_tcscat strcatstrcat _mbscat_mbscat wcscatwcscat

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
strcatstrcat <string.h><string.h>
wcscatwcscat <string.h> または <wchar.h><string.h> or <wchar.h>
_mbscat_mbscat <mbstring.h><mbstring.h>

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

strcpy に関する記事の例をご覧ください。See the example for strcpy.

関連項目See also

文字列操作String Manipulation
strncat、_strncat_l、wcsncat、_wcsncat_l、_mbsncat、_mbsncat_lstrncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp、wcsncmp、_mbsncmp、_mbsncmp_lstrncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy、_strncpy_l、wcsncpy、_wcsncpy_l、_mbsncpy、_mbsncpy_lstrncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr、wcsrchr、_mbsrchr、_mbsrchr_lstrrchr, wcsrchr, _mbsrchr, _mbsrchr_l
strspn、wcsspn、_mbsspn、_mbsspn_lstrspn, wcsspn, _mbsspn, _mbsspn_l