跳到主要内容

6.3.11 STATUS 命令

参数:

  • mailbox 名称
  • status 数据项名称

响应: REQUIRED 的不带标签响应: STATUS

结果:

  • OK - status 已完成
  • NO - status 失败: 该名称没有 status
  • BAD - 命令未知或参数无效

STATUS 命令请求所指示 mailbox 的状态. 它不会改变当前已选择的 mailbox, 也不会影响被查询 mailbox 中任何消息的状态.

STATUS 命令提供了一种替代方案: 无需打开第二个 IMAP4rev2 连接并对某个 mailbox 执行 EXAMINE 命令, 就可以在不取消第一个 IMAP4rev2 连接中当前 mailbox 选择的情况下查询该 mailbox 的状态.

与 LIST 命令不同, STATUS 命令不保证快速响应. 在某些情况下, 它可能相当慢.

当前定义的 status 数据项:

MESSAGES - mailbox 中的消息数量.

UIDNEXT - mailbox 的下一个唯一标识符值.

UIDVALIDITY - mailbox 的唯一标识符有效性值.

UNSEEN - 未设置 \Seen flag 的消息数量.

DELETED - 已设置 \Deleted flag 的消息数量.

SIZE - mailbox 的总大小, 以 octet 为单位.

示例:

C: A042 STATUS blurdybloop (UIDNEXT MESSAGES)
S: * STATUS blurdybloop (MESSAGES 231 UIDNEXT 44292)
S: A042 OK STATUS completed