6.3.11 STATUS コマンド
引数 (Arguments):
- メールボックス名
- ステータスデータ項目名
応答 (Responses): 必須のタグなし応答:STATUS
結果 (Result):
- OK - status 完了
- NO - status 失敗:その名前のステータスがありません
- BAD - コマンド不明または引数が無効
STATUS コマンドは、指定されたメールボックスのステータスを要求します。現在選択されているメールボックスは変更されず、クエリされたメールボックス内のメッセージの状態にも影響しません。
STATUS コマンドは、2 番目の IMAP4rev2 接続を開いてメールボックスに対して EXAMINE コマンドを実行し、最初の IMAP4rev2 接続で現在のメールボックスの選択を解除せずにそのメールボックスのステータスをクエリする代替手段を提供します。
LIST コマンドとは異なり、STATUS コマンドは応答が高速であることは保証されません。特定の状況下では、非常に遅くなる可能性があります。
現在定義されているステータスデータ項目:
MESSAGES - メールボックス内のメッセージ数。
UIDNEXT - メールボックスの次の一意識別子値。
UIDVALIDITY - メールボックスの一意識別子有効性値。
UNSEEN - \Seen フラグが設定されていないメッセージ数。
DELETED - \Deleted フラグが設定されているメッセージ数。
SIZE - メールボックスの合計サイズ (オクテット単位)。
例:
C: A042 STATUS blurdybloop (UIDNEXT MESSAGES)
S: * STATUS blurdybloop (MESSAGES 231 UIDNEXT 44292)
S: A042 OK STATUS completed