(PHP 4, PHP 5, PHP 7, PHP 8)
imap_sort — Trie des messages
$imap
, int $criteria
, bool $reverse
, int $flags
= 0
, string|null $search_criteria
= null
, string|null $charset
= null
) : array|falseRécupère et trie les numéros de messages en fonction des paramètres donnés.
imap
Un flux IMAP retourné par la fonction imap_open().
criteria
Les critères criteria
peuvent être
un (et un seul) parmi les suivants :
SORTDATE
: date du message
SORTARRIVAL
: date d'arrivée
SORTFROM
: nom de la première boîte
aux lettres de l'adresse d'origine (From address)
SORTSUBJECT
: sujet du message
SORTTO
: nom de la première boîte aux
lettres de destination (To address)
SORTCC
: nom de la boîte aux lettres de
copie cachée (cc address)
SORTSIZE
: taille du message en octets
reverse
S'il faut trier en ordre inverse.
flags
Les flags
dont des masques de bits,
d'un ou plusieurs des éléments suivants :
SE_UID
: retourne des UID à la place de numéros
SE_NOPREFETCH
: ne pas prétélécharger les messages trouvés
search_criteria
Critères de recherche IMAP2-format. Pour plus de détails voir imap_search().
charset
Jeu de caractères MIME à utiliser lors de la recherche de chaîne de caractères.
Retourne un tableau de numéros de messages triés en fonction
des paramètres fournis, ou false
si une erreur survient.
Version | Description |
---|---|
8.0.0 |
reverse est un bool au lieu de int.
|
8.0.0 |
search_criteria et charset sont désormais nullable.
|