Extended maintenance of Ruby 1.9.3 ended on February 23, 2015. Read more
Object
This class provides a way to synchronize communication between threads.
Example:
require 'thread' queue = Queue.new producer = Thread.new do 5.times do |i| sleep rand(i) # simulate expense queue << i puts "#{i} produced" end end consumer = Thread.new do 5.times do |i| value = queue.pop sleep rand(i/2) # simulate expense puts "consumed #{value}" end end consumer.join
Removes all objects from the queue.
# File thread.rb, line 217 def clear @que.clear end
Returns true
if the queue is empty.
# File thread.rb, line 210 def empty? @que.empty? end
Returns the length of the queue.
# File thread.rb, line 224 def length @que.length end
Returns the number of threads waiting on the queue.
# File thread.rb, line 236 def num_waiting @waiting.size end
Retrieves data from the queue. If the queue is empty, the calling thread
is suspended until data is pushed onto the queue. If
non_block
is true, the thread isn’t suspended, and an
exception is raised.
# File thread.rb, line 183 def pop(non_block=false) @mutex.synchronize{ while true if @que.empty? raise ThreadError, "queue empty" if non_block @waiting.push Thread.current @mutex.sleep else return @que.shift end end } end
Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.
If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.
If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.
If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.