Ruby 1.9.3 リファレンスマニュアル > ライブラリ一覧 > threadライブラリ > SizedQueueクラス

class SizedQueue + Queue

クラスの継承リスト: SizedQueue < Queue < Object < Kernel < BasicObject

要約

サイズの最大値を指定できる Queue です。

例

[ruby-list:283] より。q をサイズ 1 の SizedQueue オブジェクトに することによって、入力される行と出力される行が同じ順序になります。 q = [] にすると入力と違った順序で行が出力されます。 

require 'thread'

q = SizedQueue.new(1)

th = Thread.start {
  while line = q.pop
    print line
  end
}

while l = gets
  q.push(l)
end
q.push(l)

th.join

特異メソッド

new(max) -> SizedQueue

SizedQueue オブジェクトを生成します。

[PARAM] max:
キューのサイズの最大値です。
new -> Queue

新しいキューオブジェクトを生成します。

インスタンスメソッド

push(obj) -> ()
self << obj -> ()
enq(obj) -> ()

キューに与えられたオブジェクトを追加します。

キューのサイズが SizedQueue#max に達している場合は、 キューのサイズが SizedQueue#max より小さくなるまで他のスレッドに実行を譲ります。 その後、キューに与えられたオブジェクトを追加します。

[PARAM] obj:
キューに追加したいオブジェクトを指定します。

[SEE_ALSO] Queue#push

push(value) -> ()
self << value -> ()
enq(value) -> ()

キューの値を追加します。待っているスレッドがいれば実行を再開 させます。返り値は不定です。

clear -> ()

キューを空にします。返り値は不定です。

pop(non_block = false) -> object
shift(non_block = false) -> object
deq(non_block = false) -> object

キューからひとつ値を取り出します。 キューに push しようと待っているスレッドがあれば、実行を再開させます。

[PARAM] non_block:
true を与えると、キューが空の時に例外 ThreadError が発生します。

[SEE_ALSO] Queue#pop

pop(non_block = false) -> object
shift(non_block = false) -> object
deq(non_block = false) -> object

キューからひとつ値を取り出します。キューが空の時、呼出元のスレッドは停止します。

[PARAM] non_block:
true を与えると、キューが空の時に例外 ThreadError が発生します。
empty? -> bool

キューが空の時、真を返します。

length -> Fixnum
size -> Fixnum

キューの長さを返します。

max -> Fixnum

キューの最大サイズを返します。

max=(n)

キューの最大サイズを設定します。

[PARAM] n:
キューの最大サイズを指定します。
num_waiting -> Fixnum

キューを待っているスレッドの数を返します。

class SizedQueue