imap_search

Description

imap_search() effectue une recherche dans la boîte aux lettres courante, sur le flot IMAP courant. criteria est une chaîne, délimitée par des espaces, dans laquelle les mots-clés suivants sont acceptés. Tous les arguments multi-mots doivent être entre guillemets :

• ALL - retourne tous les message qui vérifie le reste du critère.

• ANSWERED - tous les messages avec le flag \\ANSWERED

• BCC "string" - tous les messages avec la chaîne "string" dans le champs Bcc:

• BEFORE "date" - tous les messages avec Date: avant "date"

• BODY "string" - tous les messages avec "string" dans le corps

• CC "string" - tous les messages avec "string" dans le champs Cc:

• DELETED - tous les messages effacés

• FLAGGED - tous les messages avec le flag \\FLAGGED (parfois interprété comme Important ou Urgent)

• FROM "string" - tous les messages avec la chaîne "string" dan le champs From:

• KEYWORD "string" - tous les messags avec la chaîne "string" comme mot clé

• NEW - tous les nouveaux messages

• OLD - tous les anciens messages

• ON "date" - tous les messages avec la date "date" comme champs Date:

• RECENT - tous les messages avec le flag \\RECENT

• SEEN - tous les messages lus (avec le flag\\SEEN flag)

• SINCE "date" - tous les messages avec la date Date: après "date"

• SUBJECT "string" - tous les messages avec la chaîne "string" dans le champs Subject:

• TEXT "string" - tous les messages avec le texte "string"

• TO "string" - tous les messages avec la chaîne "string" dans le champs To:

• UNANSWERED - tous les messages non répondus

• UNDELETED - tous les messages non effacés

• UNFLAGGED - tous les messages non flaggés

• UNKEYWORD "string" - tous les messages dans le mot clés "string"

• UNSEEN - tous les messages non lus

Par exemple, pour rechercher les messages non répondus, envoyés par maman, vous pouvez utiliser : "UNANSWERED FROM maman". Les recherches semblent insensibles à la casse. Cette liste de critères est issue du code d'un client C UW et peut être incomplète ou inprécise. (voir aussi RFC2060, section 6.4.4).

Les valeurs pour les flags sont SE_UID, qui fait que le tableau réponse contient les UIDs plutôt que les numéros de séquence.