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した場合には定義されません。

クラスに Module#include する例

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 -> ()`	ロックを解放します。ロック待ちになっていたスレッドの実行は再開されます。