wcscat() — ワイド文字ストリングの連結

形式

#include <wchar.h>
wchar_t *wcscat(wchar_t *string1, const wchar_t *string2);

言語レベル

XPG4

スレッド・セーフ

はい

ワイド文字関数

詳しくは、 ワイド文字 を参照してください。

説明

wcscat() 関数は、 string2 によって指し示されるストリングのコピーを、 string1によって指し示されるストリングの末尾に追加します。

wcscat() 関数は、ヌル終了 wchar_t ストリングに対して作動します。 この関数のストリング引数には、ストリングの終わりを示す wchar_t ヌル文字 が入っていなければなりません。 境界検査は実行されません。

戻り値

wcscat() 関数は、連結された string1へのポインターを戻します。

例

この例では、 wcscat() 関数を使用してワイド文字ストリング "computer program" を作成します。
#include <stdio.h>
#include <wchar.h>
 
#define SIZE 40
 
 
int main(void)
{
  wchar_t buffer1[SIZE] = L"computer";
  wchar_t * string      = L" program";
  wchar_t * ptr;
 
  ptr = wcscat( buffer1, string );
  printf( "buffer1 = %ls\n", buffer1 );
 
}
 
/****************  Output should be similar to:  ******************
 
buffer1 = computer program
******************************************************************/

関連情報