404 Not Found

PATH: opt / alt / ruby19 / lib64 / ruby / 1.9.1

#
#   thwait.rb - thread synchronization class
#       $Release Version: 0.9 $
#       $Revision: 1.3 $
#       by Keiju ISHITSUKA(Nihon Rational Software Co.,Ltd.)

require "thread.rb"
require "e2mmap.rb"

#
# This class watches for termination of multiple threads.  Basic functionality
# (wait until specified threads have terminated) can be accessed through the
# class method ThreadsWait::all_waits.  Finer control can be gained using
# instance methods.
#
# Example:
#
#   ThreadsWait.all_wait(thr1, thr2, ...) do |t|
#     STDERR.puts "Thread #{t} has terminated."
#   end
#
#
#   th = ThreadsWait.new(thread1,...)
#   th.next_wait # next one to be done
#
#
class ThreadsWait
  RCS_ID='-$Id: thwait.rb,v 1.3 1998/06/26 03:19:34 keiju Exp keiju $-'

extend Exception2MessageMapper
  def_exception("ErrNoWaitingThread", "No threads for waiting.")
  def_exception("ErrNoFinishedThread", "No finished threads.")

#
  # Waits until all specified threads have terminated.  If a block is provided,
  # it is executed for each thread as they terminate.
  #
  def ThreadsWait.all_waits(*threads) # :yield: thread
    tw = ThreadsWait.new(*threads)
    if block_given?
      tw.all_waits do |th|
        yield th
      end
    else
      tw.all_waits
    end
  end

#
  # Creates a ThreadsWait object, specifying the threads to wait on.
  # Non-blocking.
  #
  def initialize(*threads)
    @threads = []
    @wait_queue = Queue.new
    join_nowait(*threads) unless threads.empty?
  end

# Returns the array of threads that have not terminated yet.
  attr :threads

#
  # Returns +true+ if there are no threads in the pool still running.
  #
  def empty?
    @threads.empty?
  end

#
  # Returns +true+ if any thread has terminated and is ready to be collected.
  #
  def finished?
    !@wait_queue.empty?
  end

#
  # Waits for specified threads to terminate, and returns when one of
  # the threads terminated.
  #
  def join(*threads)
    join_nowait(*threads)
    next_wait
  end

#
  # Specifies the threads that this object will wait for, but does not actually
  # wait.
  #
  def join_nowait(*threads)
    threads.flatten!
    @threads.concat threads
    for th in threads
      Thread.start(th) do |t|
        begin
          t.join
        ensure
          @wait_queue.push t
        end
      end
    end
  end

#
  # Waits until any of the specified threads has terminated, and returns the one
  # that does.
  #
  # If there is no thread to wait, raises +ErrNoWaitingThread+.  If +nonblock+
  # is true, and there is no terminated thread, raises +ErrNoFinishedThread+.
  #
  def next_wait(nonblock = nil)
    ThreadsWait.fail ErrNoWaitingThread if @threads.empty?
    begin
      @threads.delete(th = @wait_queue.pop(nonblock))
      th
    rescue ThreadError
      ThreadsWait.fail ErrNoFinishedThread
    end
  end

#
  # Waits until all of the specified threads are terminated.  If a block is
  # supplied for the method, it is executed for each thread termination.
  #
  # Raises exceptions in the same manner as +next_wait+.
  #
  def all_waits
    until @threads.empty?
      th = next_wait
      yield th if block_given?
    end
  end
end

##
# An alias for ThreadsWait from thwait.rb

ThWait = ThreadsWait

# Documentation comments:
#  - Source of documentation is evenly split between Nutshell, existing
#    comments, and my own rephrasing.
#  - I'm not particularly confident that the comments are all exactly correct.

[+] rinda
[+] yaml
[-] rational.rb [edit]
[-] matrix.rb [edit]
[+] rdoc
[-] shell.rb [edit]
[-] ostruct.rb [edit]
[-] scanf.rb [edit]
[+] ripper
[+] dl
[-] gserver.rb [edit]
[-] rdoc.rb [edit]
[-] getoptlong.rb [edit]
[-] thread.rb [edit]
[-] sync.rb [edit]
[+] syck
[-] delegate.rb [edit]
[-] open-uri.rb [edit]
[-] json.rb [edit]
[-] rubygems.rb [edit]
[-] openssl.rb [edit]
[+] json
[-] debug.rb [edit]
[+] irb
[-] digest.rb [edit]
[-] yaml.rb [edit]
[-] forwardable.rb [edit]
[-] weakref.rb [edit]
[-] benchmark.rb [edit]
[-] profiler.rb [edit]
[-] uri.rb [edit]
[-] English.rb [edit]
[-] timeout.rb [edit]
[+] rbconfig
[-] tracer.rb [edit]
[-] resolv.rb [edit]
[+] uri
[-] tsort.rb [edit]
[-] find.rb [edit]
[-] logger.rb [edit]
[-] psych.rb [edit]
[+] psych
[-] ubygems.rb [edit]
[-] profile.rb [edit]
[-] optparse.rb [edit]
[+] matrix
[-] pp.rb [edit]
[+] test
[-] date.rb [edit]
[-] cmath.rb [edit]
[-] ripper.rb [edit]
[-] fiddle.rb [edit]
[+] drb
[+] rake
[+] webrick
[-] cgi.rb [edit]
[-] pathname.rb [edit]
[+] xmlrpc
[-] mutex_m.rb [edit]
[+] rss
[+] racc
[-] complex.rb [edit]
[+] ..
[-] prettyprint.rb [edit]
[-] csv.rb [edit]
[-] kconv.rb [edit]
[-] securerandom.rb [edit]
[+] fiddle
[-] abbrev.rb [edit]
[-] resolv-replace.rb [edit]
[+] digest
[-] mathn.rb [edit]
[+] rexml
[-] e2mmap.rb [edit]
[-] shellwords.rb [edit]
[-] rss.rb [edit]
[-] time.rb [edit]
[+] openssl
[+] date
[-] dl.rb [edit]
[-] fileutils.rb [edit]
[-] socket.rb [edit]
[+] net
[-] monitor.rb [edit]
[-] tempfile.rb [edit]
[-] syck.rb [edit]
[-] un.rb [edit]
[-] mkmf.rb [edit]
[-] base64.rb [edit]
[-] thwait.rb [edit]
[-] webrick.rb [edit]
[-] erb.rb [edit]
[-] rake.rb [edit]
[+] shell
[-] expect.rb [edit]
[-] open3.rb [edit]
[+] cgi
[-] tmpdir.rb [edit]
[-] ipaddr.rb [edit]
[-] pstore.rb [edit]
[-] singleton.rb [edit]
[+] rubygems
[-] set.rb [edit]
[-] observer.rb [edit]
[-] drb.rb [edit]
[-] irb.rb [edit]
[-] prime.rb [edit]
[+] x86_64-linux
[+] optparse