Aller au contenu principal

6.3.11 Commande STATUS

Arguments :

  • nom de boîte aux lettres
  • noms d'éléments de données d'état

Réponses : réponses non étiquetées REQUISES : STATUS

Résultat :

  • OK - status terminé
  • NO - échec de status : aucun statut pour ce nom
  • BAD - commande inconnue ou arguments invalides

La commande STATUS demande le statut de la boîte aux lettres indiquée. Elle ne modifie pas la boîte aux lettres actuellement sélectionnée et n'affecte pas l'état des messages dans la boîte aux lettres interrogée.

La commande STATUS fournit une alternative à l'ouverture d'une deuxième connexion IMAP4rev2 et à l'exécution d'une commande EXAMINE sur une boîte aux lettres pour interroger le statut de cette boîte aux lettres sans désélectionner la boîte aux lettres actuelle dans la première connexion IMAP4rev2.

Contrairement à la commande LIST, la commande STATUS ne garantit pas une réponse rapide. Dans certaines circonstances, elle peut être assez lente.

Éléments de données d'état actuellement définis :

MESSAGES - Le nombre de messages dans la boîte aux lettres.

UIDNEXT - La valeur du prochain identifiant unique de la boîte aux lettres.

UIDVALIDITY - La valeur de validité de l'identifiant unique de la boîte aux lettres.

UNSEEN - Le nombre de messages qui n'ont pas le drapeau \Seen défini.

DELETED - Le nombre de messages qui ont le drapeau \Deleted défini.

SIZE - La taille totale de la boîte aux lettres en octets.

Exemple :

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