Ruby 3.3 リファレンスマニュアル > ライブラリ一覧 > monitorライブラリ > Monitorクラス

class Monitor

クラス・モジュールの継承リスト: Monitor < Object < Kernel < BasicObject

要約

スレッドの同期機構としてのモニター機能を提供するクラスです。また同じスレッドから何度も lock できる Mutex としての機能も提供します。

MonitorMixin を include し、いくつかの別名を定義したクラスです。

例

消費者、生産者問題の例

require 'monitor'

buf = []
mon = Monitor.new
empty_cond = mon.new_cond

# consumer
Thread.start do
  loop do
    mon.synchronize do
      empty_cond.wait_while { buf.empty? }
      print buf.shift
    end
  end
end

# producer
while line = ARGF.gets
  mon.synchronize do
    buf.push(line)
    empty_cond.signal
  end
end

2回ロックしてもデッドロックにならない例です。

デッドロックにならない例

require 'monitor'
mon = Monitor.new
mon.synchronize {
  mon.synchronize {
  }
}

Thread::Mutex ではデッドロックになります。

Mutex でデッドロックになる例

mx = Mutex.new
mx.synchronize {
  mx.synchronize {
  }
}
# => deadlock; recursive locking (ThreadError)

特異メソッド

定義	説明
`new -> Monitor`	新しい Monitor オブジェクトを生成します。

インスタンスメソッド

定義	説明
`enter -> () mon_enter -> ()`	モニターをロックします。
`exit -> () mon_exit -> ()`	モニターのロックを解放します。
`mon_check_owner -> nil`	MonitorMixin 用の内部メソッドです。
`mon_locked? -> bool`	モニターがロックされているときに true を返します。
`mon_owned? -> bool`	カレントスレッドがモニターをロックしているときに true を返します。
`synchronize { ... } -> object mon_synchronize { ... } -> object`	モニターをロックし、ブロックを実行します。実行後に必ずモニターのロックを解放します。
`try_enter -> bool try_mon_enter -> bool mon_try_enter -> bool`	モニターのロックを取得しようと試みます。ロックに成功した(ロックが開放状態だった、もしくはロックを取得していたスレッドが自分自身であった)場合には真を返します。
`new_cond -> MonitorMixin::ConditionVariable`	モニターに関連付けられた、新しい MonitorMixin::ConditionVariable を生成して返します。
`wait_for_cond(cond, timeout) -> bool`	MonitorMixin::ConditionVariable 用の内部メソッドです。

継承したメソッド

! != __id__ __send__ instance_eval instance_exec method_missing singleton_method_added singleton_method_removed singleton_method_undefined !~ <=> == === _dump class clone define_singleton_method display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy inspect instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? itself marshal_dump marshal_load method methods nil? object_id pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods psych_to_yaml public_method public_methods public_send remove_instance_variable respond_to? respond_to_missing? send singleton_class singleton_method singleton_methods tap then to_a to_ary to_hash to_int to_io to_proc to_regexp to_s to_str .yaml_tag ::ARGF ::ARGV ::DATA ::ENV ::RUBY_COPYRIGHT ::RUBY_DESCRIPTION ::RUBY_ENGINE ::RUBY_ENGINE_VERSION ::RUBY_PATCHLEVEL ::RUBY_PLATFORM ::RUBY_RELEASE_DATE ::RUBY_REVISION ::RUBY_VERSION ::SCRIPT_LINES__ ::STDERR ::STDIN ::STDOUT ::TOPLEVEL_BINDING