Cクイックリファレンス 第2版

strcpy, strcpy_s

563

strcpy()

関数は

src

で指す文字列を

dest

で指す

char

配列にコピーする。

dest

で指す

char

配列が終端ナル文字を含めて文字列格納に十分大きいことを確認するのはプログラマの役

目だ。コピー元とコピー先の配列は重複してはいけない。関数

strcpy()

はポインタ

dest

を

返す。

strcpy()

同様、セキュア関数

strcpy_s()

は

src

文字列を

dest

で指す配列にコピーするが、

オーバーフローの危険を回避する。追加引数

destmax

でコピー先配列のサイズを指定し次の

実行時制約を確認する。

●

ポインタ

src

と

dest

にナルポインタは指定できず、0＜

destmax

≦

RSIZE_MAX

にする。

●

src

の文字列長は

destmax

より小さくする。

●

コピー元とコピー先の配列は重複してはいけない。

実行時制約違反が起こると、

strcpy_s()

は

dest

がナルポインタでなく、0＜

destmax

≦

RSIZE_MAX

のとき、

dest

[0]

に文字列終端文字を書く。

strcpy_s()

は実行時制約違反が起こらないと、すなわち文字列

src

を文字列終端文字を

含めてコピーすることに成功すれば0を返す。非ゼロ戻り値はエラーを示す。文字列終端文

字の後の

char

配列

dest

の値は未定義となる。

■ 

例

struct guest {

char name[64];

int age;

_Bool male;

_Bool smoking;

_Bool discount; ...