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

SDL_strndup

メモリを確保して最大n文字の文字列をコピーする

ヘッダ

SDL3/SDL_stdinc.h

構文

char * SDL_strndup(const char *str, size_t maxlen);

引数

const char *strコピーする文字列
size_tmaxlenコピーする文字列の最大バイト数. NUL終端の分は含まれない

戻り値

(char *) 新しく確保された文字列へのポインタを戻す.

詳細

この関数はNUL終端の文字列strにとって十分な領域を最大maxlenバイトSDL_mallocで確保し, この領域に文字列をコピーする.

文字列がmaxlenバイトよりも長い場合, 戻された文字列の長さはmaxlenバイトで, さらに最大バイト数には含まれないNUL終端が追加されている.

戻された文字列は呼び出し側の管理となる. 不要になった場合はSDL_freeに渡す必要がある.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_strndup - SDL Wiki