imap_search

Beschreibung

array imap_search ( int imap_stream, string criteria, int flags )

Diese Funktion durchsucht die Nachrichten des aktuellen Postfachs und liefert ein Array mit den Nummern der Nachrichten, die mit den angegebenen Kriterien übereinstimmen. Der Parameter criteria enthält einen String, der sich aus den folgenden Suchbegriffen zusammensetzen kann

• ALL - liefert alle Nachrichten, die den restlichen Kriterien entsprechen

• ANSWERED - das \\ANSWERED Flag der Nachricht ist gesetzt

• BCC "string" - Das Bcc: Feld der Nachricht enthält "string"

• BEFORE "date" - Das Date: Feld der Nachricht enthält ein Datum, das vor dem in "date" angegebenen liegt

• BODY "string" - Im Inhalt der Nachricht ist "string" enthalten

• CC "string" - Das Cc: Feld der Nachricht enthält "string"

• DELETED - Die Nachricht ist zum Löschen vorgemerkt

• FLAGGED - Das \\FLAGGED (wichtig bzw. dringend) Flag der Nachricht ist gesetzt

• FROM "string" - Das From: Feld der Nachricht enthält "string"

• KEYWORD "string" - Das Feld Keyword: enthält "string"

• NEW - die Nachricht ist neu

• OLD - die Nachricht ist nicht neu

• ON "date" - Das Datum in Date: entspricht "date"

• RECENT - Das \\RECENT Flag ist gesetzt

• SEEN - Das \\SEEN Flag ist gesetzt, die Nachricht wurde bereits einmal abgerufen

• SINCE "date" - Das Datum "date" liegt vor dem im Date: Feld der Nachricht

• SUBJECT "string" - "string" ist Teil des Betreffs der Nachricht

• TEXT "string" - "string" ist Teil der Nachricht (Kopf oder Inhalt)

• TO "string" - Das To: Feld der Nachricht enthält "string"

• UNANSWERED - Die Nachricht wurde nicht beantwortet, das \\Answered Flag ist nicht gesetzt

• UNDELETED - Die Nachricht ist nicht zum Löschen vorgemerkt

• UNFLAGGED - Die Nachricht ist nicht als 'wichtig' markiert

• UNKEYWORD "string" - "string" ist nicht Schlüsselwort der Nachricht

• UNSEEN - Die Nachricht wurde bisher nicht gelesen

Argumente, die Leerzeichen enthalten, müssen dabei in Anführungszeichen eingebettet werden.

Um zum Beispiel alle unbeantworteten Nachrichten von Mama zu finden übergeben Sie als criteria: "UNANSWERED FROM Mama". Die Suche scheint nicht zwischen Groß- und Kleinschreibung zu unterscheiden. Die Liste der Suchbegriffe entstand nach Inspektion der UW c-client Sourcen und ist vermutlich nicht vollständig (siehe auch RFC 2060, Abschnitt 6.4.4).

Enthält der optionale Parameter flags den Wert SE_UID, so werden UIDs anstelle von laufenden Nachrichtennummern zurückgegeben.