superclass=
type=module
library=monitor
extended=
included=

スレッドの同期機構としてのモニター機能を提供するモジュールです。

=== 例

  require 'monitor'
  
  buf = []
  buf.extend(MonitorMixin)
  empty_cond = buf.new_cond
  
  # consumer
  Thread.start do
    loop do
      buf.synchronize do
        empty_cond.wait_while { buf.empty? }
        print buf.shift
      end
    end
  end
  
  # producer
  while line = ARGF.gets
    buf.synchronize do
      buf.push(line)
      empty_cond.signal
    end
  end

=== 初期化

MonitorMixin は初期化される必要があります。
上の例のように [[m:Object#extend]] を使って利用する場合は
自動的に初期化されます。

  require 'monitor'
  buf = []
  buf.extend(MonitorMixin)

しかし、MonitorMixin をクラス定義の際に [[m:Module#include]] を使って
利用する場合は、initialize メソッドで super() か super を呼んで、初期化する必要があります。
スーパークラスの initialize に引数を渡したい場合は super を、そうでない場合は super() を呼んで下さい。
詳しくは、[[ref:d:spec/call#super]] を参照して下さい。
例えば、以下の MyObject のスーパークラスは Object であり、その initialize は引数を受け付けないので
super ではなく super() を呼ぶ必要があります。

  require 'monitor'
  class MyObject
    include MonitorMixin
    
    def initialize(val)
      super()
      @value = val
    end
    
    def to_s
      synchronize {
        @value.to_s
      }
    end
  end

以下も参考になります。

  * [[ruby-dev:9384]]
  * [[ruby-dev:9386]]
