imap_listscan
(PHP 4, PHP 5)
imap_listscan — Lit la liste des boîtes aux lettres, et y recherche une chaîne
Description
$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.
Liste de paramètres
-
imap_stream
-
Un 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 passezpattern
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
Valeurs de retour
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.
Voir aussi
- imap_listmailbox() - Alias de imap_list
- imap_search() - Retourne un tableau de messages après recherche