thrd_create サブルーチン

オンライン編集

目的

このサブルーチンはスレッドを作成します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <threads.h>
int thrd_create(thrd_t *thr, thrd_start_t func, void *arg);

説明

thrd_create サブルーチンは、 func(arg) サブルーチンを実行することによって、新しいスレッドを作成します。 thrd_create サブルーチンは、成功すると、 thr パラメーターによって指定されたオブジェクトを、新しく作成されたスレッドの ID に設定します。
注:
  • スレッドの ID は、元のスレッドが終了し、スレッドが切り離されるか別のスレッドに結合された後で、別のスレッドに再使用することができます。
  • thrd_create サブルーチンの完了は、新規スレッドの開始と同期します。

パラメーター

状況

項目 説明
thr 新しく作成されたスレッドの ID を保持します。
func 新規スレッドを作成するために使用されるサブルーチンを指定します。
arg func() サブルーチンに対する引数を指定します。

戻り値

thrd_create サブルーチンは、成功時に thrd_success を返します。要求されたスレッドにメモリーが割り当てられていない場合は thrd_nomem を返し、要求が完了していない場合は thrd_error を返します。

ファイル

項目 説明
threads.h 標準マクロ、データ・タイプ、およびサブルーチンは、 threads.h ファイルによって定義されます。