Ruby 2.2.0 リファレンスマニュアル > ライブラリ一覧 > mutex_mライブラリ > Mutex_mモジュール

module Mutex_m

クラス・モジュールの継承リスト: Mutex_m

要約

スレッド同期機構である Mutex のモジュール版です。クラスに Module#include することでそのクラスに Mutex 機能を持たせることができます。また、普通のオブジェクトを Object#extend により Mutex にする事ができます。

このモジュールによるロックは再入不可能です。再入可能な同等品が必要な場合は Sync_m の利用を考えてください。

「mu_」の付かないメソッド(Mutex_m#lock, Mutex_m#synchronize, Mutex_m#locked?, Mutex_m#try_lock, Mutex_m#unlock) はモジュールにincludeした場合には定義されません。

[ruby-list:1991]

クラスに Module#include する例

require "mutex_m"
class Foo
  include Mutex_m
  ...
end
obj = Foo.new
obj.synchronize do
  # 危険領域(critical section)
  ...
end

オブジェクトに Object#extend する例

require "mutex_m"
obj = Object.new
obj.extend(Mutex_m)
obj.lock
# 危険領域(critical section)
...
obj.unlock

特異メソッド

定義 説明
append_features(klass) -> Class | nil

ユーザが直接、使うことはありません。

define_aliases(klass) -> Class

ユーザが直接、使うことはありません。

extend_object(module) -> Module

ユーザが直接、使うことはありません。

インスタンスメソッド

定義 説明
mu_lock -> ()
lock -> ()

self をロックします。一度にひとつのスレッドしかロックできません。既にロックされている mutex に対してロックを行おうとしたスレッドはロックが解放されるまで、実行が停止されます。

mu_locked? -> bool
locked? -> bool

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

mu_extended -> Mutex

Mutex_m.extend_object から呼び出されます。ユーザが直接使うことはありません。

mu_synchronize { ... } -> object
synchronize { ... } -> object

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

mu_try_lock -> bool
try_lock -> bool

self をロックしようとして、成功した場合、真を返し、ロックを得ます。

mu_unlock -> ()
unlock -> ()

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