pthread_once(3T)

構文

パラメータ

説明

pthread_once() 関数は、アプリケーションで init_routine() が １ 回だけ呼び出されることを保証します。 この関数は、 init_routine() が pthread_once() を介して以前に呼び出されたか判断するために、 once_control オブジェクトを使用します。

最初に once_control と init_routine() を指定して pthread_once() を呼び出すと、引き数無しで init_routine() が呼び出されます。 それ以降、同じ once_control で pthread_once() を呼び出しても、 init_routine() は呼び出されません。 pthread_once() から戻った時には、 init_routine() が (前回の呼び出しの場合でも今回の呼び出しの場合でも) 呼び出されたことを保証されます。

マクロ PTHREAD_ONCE_INIT は、once control ブロックを静的に初期化するのに使用されます。 この初期化は、 pthread_once() 呼び出しの前に行われなければなりません。

pthread_once() は、取り消し地点ではありません。 しかし、呼び出し元にとっては init_routine() は取り消し地点であるかもしれません。 init_routine() を実行するスレッドが取り消された場合、 once_control 引き数には init_routine() が呼び出されなかったことを示すステータスが設定されます pthread_cancel(3T) を参照してください)。 その次に once_control を指定して pthread_once() 関数が呼び出されると、 init_routine() 関数が呼び出されます。

once_control に自動記憶領域を指定した場合、または PTHREAD_ONCE_INIT で初期化されない場合の、 pthread_once() の動作は不定です。

戻り値

正常終了すると pthread_once() は ０ を返します。 それ以外の場合、エラーの内容を表すエラー番号を返します (errno 変数は使用しません)。

エラー

以下の条件の場合、 pthread_once() 関数は、該当するエラー番号を返します。

例

いくつかのモジュールが動的に初期化されるよう設計される場合、例としては、 モジュールの最初の関数が実行されるとき、グローバルな初期化を行います。 この処理は、単一スレッドのプログラムでは、一般に次のように実現されます。

マルチスレッド化されたプロセスでは、単純な初期化フラグでは十分ではないので、フラグを他のスレッドによる変更から保護しなければなりません。 つまりこのフラグは、一度だけ初期化しなければならない mutex で保護する必要があります。 マルチスレッドプログラムでは、次のように初期化を行う必要があります。

著者

pthread_once() は、IEEE POSIX P1003.1c 標準から派生しました。

参照

pthread_create(3T)

標準準拠

pthread_once(): POSIX 1003.1c.