(PHP 4, PHP 5)
imap_listscan — Lit la liste des boîtes aux lettres, et y recherche une chaîne
$imap_stream
, string $ref
, string $pattern
, string $content
)
Retourne un tableau contenant les noms des boîtes aux lettres
qui contiennent la chaîne content
dans leur nom.
Cette fonction est similaire à imap_listmailbox(),
mais va aussi vérifier la présence de la chaîne content
dans les messages de la boîte aux lettres.
imap_streamUn flux IMAP retourné par la fonction imap_open().
ref
ref ne devrait être que le serveur
sous la forme décrite dans imap_open()
pattern
Spécifie la position dans la hiérarchie des boîtes aux lettres, où il faut commencer à chercher.
Il y a deux caractères
spéciaux que vous pouvez utiliser dans pattern :
'*' et '%'.
'*' signifie : toutes les boîtes aux lettres. Si vous passez
pattern comme '*', vous obtiendrez
la liste complète des boîtes aux lettres de la hiérarchie.
'%' signifie qu'on ne s'intéresse qu'au niveau courant.
'%' passé à pattern ne retournera
que les boîtes aux lettres de niveau supérieur; '~/mail/%'
sous UW_IMAPD retournera toutes les boîtes aux lettres du
dossier ~/mail directory, mais pas leurs enfants.
content
La chaîne cherchée
Retourne un tableau contenant les noms des boîtes aux lettres
qui contiennent la chaîne content
dans le nom de la boîte aux lettres.