imap_lsub

(PHP 4, PHP 5)

imap_lsub — Liste aller abonierten Postfächer

Beschreibung

array imap_lsub ( resource $imap_stream , string $ref , string $pattern )

Liefert ein Array aller vom Benutzer abonnierten Postfächer

Parameter-Liste

imap_stream

Eine von imap_open() zurückgegebene IMAP-Verbindung.

ref

Serverspezifikation, siehe imap_open() für Details.

pattern

Legt fest ab welchem Punkt der Postfachhierachie gesucht werden soll.

Zwei spezielle Zeichen können als Teil des Suchmusters pattern benutzt werden: '*' und '%'. Mit '*' werden alle Postfächer angefordert, so können Sie z.B. nur '*' als pattern übergeben und erhalten eine Übersicht aller auf dem Server verfügbarer Postfächer. '%' liefert alle Postfächer auf einer Hierachieebene aber nicht die tiefer liegenden Postfächer. Ein einfaches '%' als pattern liefert nur die Postfächer der obersten Ebene, '~/mail/%' z.B. liefert auf einem UW_IMAP Server alle Postfächer des ~/mail Verzeichnisses aber nicht deren Unterpostfächer.

Rückgabewerte

Liefert ein Array mit allen abonierten Postfächern

Siehe auch