wcscpy, wcscpy_s

ヘッダー `<wchar.h>` で定義
	(1)
wchar_t* wcscpy( wchar_t* dest, const wchar_t* src );			(C95 以降) (C99まで)
wchar_t* wcscpy( wchar_t* restrict dest, const wchar_t* restrict src );			(C99以降)
errno_t wcscpy_s( wchar_t* restrict dest, rsize_t destsz, const wchar_t* restrict src );		(2)	(C11 以降)

1) src が指すワイド文字列（終端のヌルワイド文字を含む）を、dest が指すワイド文字列配列にコピーします。 dest 配列が十分に大きくない場合、動作は未定義です。文字列が重複する場合、動作は未定義です。

2) (1) と同じですが、宛先配列の残りを未指定の値で上書きする可能性があり、次のエラーは実行時に検出され、現在インストールされている制約ハンドラー関数が呼び出されます。

src または dest がヌルポインタである
destsz がゼロまたは RSIZE_MAX / sizeof(wchar_t) より大きい場合。
destsz が wcsnlen_s(src, destsz) 以下の場合。つまり、切り捨てが発生する場合。
ソース文字列と宛先文字列の間に重複が発生する場合

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

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    wchar_t* src = L"犬 means dog";
//  src[0] = L'狗' ; // this would be undefined behavior
    wchar_t dst[wcslen(src) + 1]; // +1 for the null terminator
    wcscpy(dst, src);
    dst[0] = L'狗'; // OK
 
    setlocale(LC_ALL, "en_US.utf8");
    printf("src = %ls\ndst = %ls\n", src, dst);
}

出力

src = 犬 means dog
dst = 狗 means dog

[編集] 参考文献

C23標準 (ISO/IEC 9899:2024)

7.29.4.1.2 wcscpy 関数 (p: TBD)

K.3.9.2.1.1 wcscpy_s 関数 (p: TBD)

C17標準 (ISO/IEC 9899:2018)

7.29.4.1.2 wcscpy 関数 (p: TBD)

K.3.9.2.1.1 wcscpy_s 関数 (p: TBD)

C11標準 (ISO/IEC 9899:2011)

7.29.4.1.2 wcscpy 関数 (p: 430)

K.3.9.2.1.1 wcscpy_s 関数 (p: 639)

C99標準 (ISO/IEC 9899:1999)

7.24.4.1.2 wcscpy 関数 (p: 376)

[編集] 関連項目

wcsncpywcsncpy_s (C95)(C11)	ある文字列から別の文字列へ、指定された数のワイド文字をコピーする (関数) [編集]
wmemcpywmemcpy_s (C95)(C11)	オーバーラップしていない2つの配列間で、指定された数のワイド文字をコピーする (関数) [編集]
strcpystrcpy_s (C11)	ある文字列を別の文字列にコピーする (関数) [編集]
C++ ドキュメント wcscpy

コンパイラサポート
言語
ヘッダー
型サポート
プログラムユーティリティ
可変長引数関数のサポート
エラーハンドリング
動的メモリ管理
文字列ライブラリ
アルゴリズム
数値
日付と時刻のユーティリティ
入出力サポート
ローカライゼーションサポート
並行処理サポート (C11)
技術仕様
シンボルインデックス

cppreference.com

名前空間

変種

表示

操作

wcscpy, wcscpy_s

目次

[編集] パラメータ

[編集] 戻り値

[編集] 例

[編集] 参考文献

[編集] 関連項目

ナビゲーション

ツールボックス

dest	-	コピー先のワイド文字配列へのポインタ
src	-	コピー元のヌル終端ワイド文字列へのポインタ
destsz	-	書き込む最大文字数。通常は宛先バッファのサイズ。