responses -> { String => [object] }[permalink][rdoc][edit]responses {|hash| ... } -> objectresponses(type) {|array| ... } -> object-
サーバから送られてきた untagged な応答の記録を返します。
untagged な応答は種類ごとに記録されます。応答の種類には "FLAGS", "OK", "UIDVALIDITY", "EXISTS" などがあり、この文字列がハッシュテーブルのキーとなります。そして各種類ごとに配列が用意され、untagged な応答を受信するたびにその配列の末尾にその内容が記録されます。
ブロックを渡すと、記録をブロックに渡してブロックの値を返します。
typeを指定するとその種類の応答の配列だけを渡します(typeは大文字に変換して探します)。ブロックの実行中は受信スレッドなどが記録を更新しないよう同期されます。ブロックの外で記録のハッシュやその配列を扱うのはスレッド安全ではないため、下の例のようにブロックを渡して使います。ブロックを渡さずに
例typeを指定すると ArgumentError が発生します。ブロックもtypeも渡さないときは記録のハッシュそのものを返します。ブロックを渡さずに呼ぶ形は非推奨ですが、警告は出ません。imap.select("inbox") p imap.responses("EXISTS", &:last) # => 2 p imap.responses("UIDVALIDITY", &:last) # => 968263756- [PARAM]
type: - 応答の種類("EXISTS" など)を文字列で指定します。
- [EXCEPTION]
ArgumentError: -
ブロックを渡さずに
typeを指定した場合に発生します。
- [PARAM]