Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Mutexクラス

class Mutex

クラスの継承リスト: Mutex < Object < Kernel < BasicObject

要約

Mutex(Mutal Exclusion = 相互排他ロック)は共有データを並行アクセスから保護する ためにあります。Mutex の典型的な使い方は(m を Mutex オブジェクトとします):

m.lock
begin
  # m によって保護されたクリティカルセクション
ensure
  m.unlock
end

または、より簡単に

m.synchronize {
  # m によって保護されたクリティカルセクション
}

特異メソッド

new -> Mutex

新しい mutex を生成して返します。

インスタンスメソッド

lock -> self

mutex オブジェクトをロックします。一度に一つのス レッドだけが mutex をロックできます。既にロックされている mutex に対してロックを行おうとしたスレッドは mutex のロックが解放さ れるまで、実行が停止されます。

locked? -> bool

mutex がロックされている時、真を返します。

sleep(timeout = nil) -> self

与えられた秒数の間スリープしてからロックを解放します。

[PARAM] timeout:
スリープする秒数を指定します。省略するとスリープし続けます。
[EXCEPTION] ThreadError:
自身がカレントスレッドによってロックされていない場合に発生します。
synchronize { ... } -> object

mutex をロックし、ブロックを実行します。実行後に必ず mutex のロックを解放します。

ブロックが最後に評価した値を返します。

try_lock -> bool

mutex をロックしようとして、ロックが成功した場合、真を返します。 ロックできなかった場合にはブロックせず偽を返します。

unlock -> self | nil

mutex のロックを解放します。mutex のロック待ちになっていたスレッドの実行は再開されます。

[RETURN]
self がロックされていなければ nil を返します。そうでなければself を返します。

例:

m = Mutex.new
begin
  m.lock
  # critical part
ensure
  m.unlock
end

Mutex はロックしたスレッド以外からロックを開放することは出来ません。 ロックしたスレッド以外から unlock が呼ばれると ThreadError が発生します。

m = Mutex.new
m.lock
Thread.new do
  m.unlock # => ThreadError
end.join
[EXCEPTION] ThreadError:
自身をロックしたスレッド以外から呼ばれた場合に発生します。
class Mutex