目次 - SDL 3.0 API(機能別) - 標準ライブラリ - SDL_strlcpy

SDL_strlcpy

文字列をコピーする

ヘッダ

SDL3/SDL_stdinc.h

構文

size_t SDL_strlcpy(char *dst, const char *src, size_t maxlen);

引数

char *dstコピー先のバッファ. NULLであってはならず, srcと重なっていてはならない
const char *srcコピーするNUL終端の文字列. NULLであってはならず, dstと重なっていてはならない
size_tmaxlenコピー先のバッファの最大長(文字数)

戻り値

(size_t) srcの長さ(NUL終端を含まない文字数)を戻す.

詳細

この関数は最大maxlen - 1文字をsrcからdstにコピーしてNUL終端を追加する.

maxlenが0の場合, コピーは行われず, NUL終端も書き込まれない.

UTF-8文字列をコピーしたいが, マルチバイトの途中で切り落とされたくない場合は, SDL_utf8strlcpyの使用を検討すること.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_strlcpy - SDL Wiki