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