class Thread::Monitor::ConditionVariable (Ruby 4.1 リファレンスマニュアル)

aliases: MonitorMixin::ConditionVariable

要約

Thread::Monitor と MonitorMixin のための条件変数クラスです。 Thread::Monitor#new_cond や MonitorMixin#new_cond が返します。ユーザが Thread::Monitor::ConditionVariable.new を直接呼ぶことはありません。

Ruby 4.0 までは monitor ライブラリの MonitorMixin::ConditionVariable クラスとして提供されていましたが、Ruby 4.1 で組み込みクラスになりました。MonitorMixin::ConditionVariable は、monitor ライブラリを読み込むと Thread::Monitor::ConditionVariable の別名として引き続き使えます。

インスタンスメソッド

broadcast -> ()[permalink][rdoc][edit]

その条件変数で待っている全てのスレッドの実行を再開します。

[SEE_ALSO] Thread::Monitor::ConditionVariable#signal

signal -> ()[permalink][rdoc][edit]

その条件変数で待っているスレッドがあれば実行を再開させます。

複数のスレッドが待っている場合には1つのスレッドのみ実行を再開します。

[SEE_ALSO] Thread::Monitor::ConditionVariable#broadcast

wait(timeout = nil) -> bool[permalink][rdoc][edit]

モニタのロックを開放し、現在のスレッドを停止します。

これを呼ぶスレッドはモニタのロックを保持している必要があります。

Thread::Monitor::ConditionVariable#signal や Thread::Monitor::ConditionVariable#broadcast で起こされるまでスレッドは停止し続けます。

timeout を与えた場合は最大 timeout 秒まで停止した後にスレッドを再開します。

実行を再開したスレッドはモニタのロックを保持した状態になります。これによって危険領域(critical section)上で動作しているスレッドはただ一つになり、排他を実現します。

true を返します。timeout が与えられていて待ち時間が timeout を越えた場合は false を返します。

[PARAM] timeout:: タイムアウトまでの秒数。指定しなかった場合はタイムアウトしません。
[EXCEPTION] ThreadError:: ロックを持っていないスレッドがこのメソッドを呼びだした場合に発生します

[SEE_ALSO] Thread::Monitor::ConditionVariable#wait_while, Thread::Monitor::ConditionVariable#wait_until

wait_until { ... } -> ()[permalink][rdoc][edit]

モニタのロックを開放し、現在のスレッドをブロックで指定した条件を満たすまで停止します。

Thread::Monitor::ConditionVariable#signal や Thread::Monitor::ConditionVariable#broadcast でスレッドが起こされると、ロックを取得し、ブロックを評価しその結果によってこのメソッドから抜け処理を継続するか再びロックを開放しスレッドを停止するかを決めます。

[SEE_ALSO] Thread::Monitor::ConditionVariable#wait

wait_while { ... } -> ()[permalink][rdoc][edit]

モニタのロックを開放し、現在のスレッドをブロックで指定した条件を満たしている間停止します。

[EXCEPTION] ThreadError:: ロックを持っていないスレッドがこのメソッドを呼びだした場合に発生します

[SEE_ALSO] Thread::Monitor::ConditionVariable#wait

要約

目次

インスタンスメソッド