wcscat, wcscat_s

1) ワイド文字列 src が指す文字列のコピーを、ワイド文字列 dest が指す文字列の末尾に追加します。ワイド文字 src[0] は dest の末尾にあるナルターミネータを置き換えます。結果のワイド文字列はナルターミネートされます。宛先配列が str と dest の内容および終端ナルワイド文字の両方を保持するのに十分な大きさでない場合、動作は未定義です。文字列がオーバーラップしている場合の動作は未定義です。

2) (1) と同様であるが、以下の点が異なる：宛先配列の残りの部分（最後に書き込まれた文字から destsz まで）を不定値で上書きする可能性があり、以下のエラーが実行時に検出され、現在インストールされている constraint handler 関数を呼び出す：

• src または dest がnullポインタである
• destsz がゼロまたは RSIZE_MAX / sizeof ( wchar_t ) より大きい
• dest の先頭 destsz ワイド文字内にnull終端文字がない
• 切り捨てが発生する（ dest の末尾の利用可能な領域が src のすべてのワイド文字（null終端文字を含む）を格納できない）
• ソース文字列と宛先文字列がオーバーラップする

すべての境界チェック付き関数と同様に、 wcscat_s は、実装によって __STDC_LIB_EXT1__ が定義され、かつユーザーが <wchar.h> をインクルードする前に __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義した場合にのみ利用可能であることが保証される。

1) dest のコピーを返す

2) 成功時はゼロを返し、エラー時は非ゼロを返します。また、エラー時には L ' \0 ' を dest [ 0 ] に書き込みます（ただし dest がnullポインタの場合、または destsz がゼロまたは RSIZE_MAX / sizeof ( wchar_t ) より大きい場合を除く）。

#include <wchar.h> 
#include <stdio.h>
#include <locale.h>
int main(void) 
{
    wchar_t str[50] = L"Земля, прощай.";
    wcscat(str, L" ");
    wcscat(str, L"В добрый путь.");
    setlocale(LC_ALL, "en_US.utf8");
    printf("%ls", str);
}

Земля, прощай. В добрый путь.