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.
