read(tuple, sec=nil) -> [Array|Hash]
[permalink][rdoc][edit]-
タプルスペース内の tuple にマッチするタプルを一つコピーして返します。
このメソッド呼び出しが終了しても、タプルスペースからタプルは取り除かれません。
tuple で指定できるパターンについては rinda/rinda/タプルのパターンについて を参照してください。
マッチするタプルが存在しない場合は、マッチするタプルがタプルスペースに投入されるまで待ちます。
sec でタイムアウト秒数を指定できます。待ち時間が sec 秒を過ぎた時には read をあきらめ例外 Rinda::RequestExpiredError を発生させます。 sec に nil を指定するとタイムアウトせずに無限に待ち続けます。
- [PARAM] tuple:
- タプルのパターン
- [PARAM] sec:
- タイムアウト秒数
- [EXCEPTION] Rinda::RequestExpiredError:
- read がタイムアウトした場合に発生します
- [EXCEPTION] Ridna::RequestCanceledError:
- read が何らかの理由でキャンセルされた場合に発生します。