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

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