cvs: phpdoc-de /reference/imap/functions imap-search.xml

From: Date: Mon, 26 Feb 2007 12:06:24 +0000
Subject: cvs: phpdoc-de /reference/imap/functions imap-search.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2037@lists.php.net to get a copy of this message
hholzgra Mon Feb 26 12:06:24 2007 UTC Modified files: /phpdoc-de/reference/imap/functions imap-search.xml Log: translation update

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/imap/functions/imap-search.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/imap/functions/imap-search.xml diff -u phpdoc-de/reference/imap/functions/imap-search.xml:1.4 phpdoc-de/reference/imap/functions/imap-search.xml:1.5 --- phpdoc-de/reference/imap/functions/imap-search.xml:1.4 Mon Jan 29 21:47:10 2007 +++ phpdoc-de/reference/imap/functions/imap-search.xml Mon Feb 26 12:06:24 2007 @@ -1,179 +1,237 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.1 Maintainer: hholzgra Status: working --> -<!-- splitted from ./de/functions/imap.xml, last change in rev 1.2 --> -<!-- last change to 'imap-search' in en/ tree in rev 1.2 --> - <refentry id="function.imap-search"> - <refnamediv> - <refname>imap_search</refname> - <refpurpose> - Sucht Nachrichten, die den übergebenen Suchkriterien entsprechen - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>imap_search</methodname> - <methodparam><type>int</type><parameter>imap_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>criteria</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - 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 <parameter>criteria</parameter> enthält einen String, - der sich aus den folgenden Suchbegriffen zusammensetzen kann - <itemizedlist> - <listitem> - <simpara> - ALL - liefert alle Nachrichten, die den restlichen Kriterien - entsprechen - </simpara> - </listitem> - <listitem> - <simpara> - ANSWERED - das \\ANSWERED Flag der Nachricht ist gesetzt - </simpara> - </listitem> - <listitem> - <simpara> - BCC "string" - Das Bcc: Feld der Nachricht enthält "string" - </simpara> - </listitem> - <listitem> - <simpara> - BEFORE "date" - Das Date: Feld der Nachricht enthält ein - Datum, das vor dem in "date" angegebenen liegt - </simpara> - </listitem> - <listitem> - <simpara> - BODY "string" - Im Inhalt der Nachricht ist "string" enthalten - </simpara> - </listitem> - <listitem> - <simpara> - CC "string" - Das Cc: Feld der Nachricht enthält "string" - </simpara> - </listitem> - <listitem> - <simpara> - DELETED - Die Nachricht ist zum Löschen vorgemerkt - </simpara> - </listitem> - <listitem> - <simpara> - FLAGGED - Das \\FLAGGED (wichtig bzw. dringend) Flag der - Nachricht ist gesetzt - </simpara> - </listitem> - <listitem> - <simpara> - FROM "string" - Das From: Feld der Nachricht enthält "string" - </simpara> - </listitem> - <listitem> - <simpara> - KEYWORD "string" - Das Feld Keyword: enthält "string" - </simpara> - </listitem> - <listitem> - <simpara> - NEW - die Nachricht ist neu - </simpara> - </listitem> - <listitem> - <simpara> - OLD - die Nachricht ist nicht neu - </simpara> - </listitem> - <listitem> - <simpara> - ON "date" - Das Datum in Date: entspricht "date" - </simpara> - </listitem> - <listitem> - <simpara> - RECENT - Das \\RECENT Flag ist gesetzt - </simpara> - </listitem> - <listitem> - <simpara> - SEEN - Das \\SEEN Flag ist gesetzt, die Nachricht wurde - bereits einmal abgerufen - </simpara> - </listitem> - <listitem> - <simpara> - SINCE "date" - Das Datum "date" liegt vor dem im Date: Feld - der Nachricht - </simpara> - </listitem> - <listitem> - <simpara> - SUBJECT "string" - "string" ist Teil des Betreffs der - Nachricht - </simpara> - </listitem> - <listitem> - <simpara> - TEXT "string" - "string" ist Teil der Nachricht (Kopf oder - Inhalt) - </simpara> - </listitem> - <listitem> - <simpara> - TO "string" - Das To: Feld der Nachricht enthält "string" - </simpara> - </listitem> - <listitem> - <simpara> - UNANSWERED - Die Nachricht wurde nicht beantwortet, das - \\Answered Flag ist nicht gesetzt - </simpara> - </listitem> - <listitem> - <simpara> - UNDELETED - Die Nachricht ist nicht zum Löschen vorgemerkt - </simpara> - </listitem> - <listitem> - <simpara> - UNFLAGGED - Die Nachricht ist nicht als 'wichtig' markiert - </simpara> - </listitem> - <listitem> - <simpara> - UNKEYWORD "string" - "string" ist nicht Schlüsselwort der - Nachricht - </simpara> - </listitem> - <listitem> - <simpara> - UNSEEN - Die Nachricht wurde bisher nicht gelesen - </simpara> - </listitem> - </itemizedlist> - Argumente, die Leerzeichen enthalten, müssen dabei in - Anführungszeichen eingebettet werden. - </para> - <para> - Um zum Beispiel alle unbeantworteten Nachrichten von Mama zu - finden übergeben Sie als <parameter>criteria</parameter>: - "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 <ulink - url="&url.rfc;rfc2060.html">RFC 2060</ulink>, Abschnitt 6.4.4). - </para> - <para> - Enthält der optionale Parameter <parameter>flags</parameter> den - Wert SE_UID, so werden UIDs anstelle von laufenden - Nachrichtennummern zurückgegeben. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.10 Maintainer: hholzgra Status: ready --> +<refentry id="function.imap-search"> + <refnamediv> + <refname>imap_search</refname> + <refpurpose>Liefert ein Array von Nachrichten die den gegebenen Suchkriterien entsprechen</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>imap_search</methodname> + <methodparam><type>resource</type><parameter>imap_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>criteria</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + <function>imap_search</function> durchsucht die Nachrichten + des aktuellen Postfachs. + </para> + <para> + Der Suchstring um zB nach allen unbeantworteten Nachrichten von + Mutter zu suchen wäre "UNANSWERED FROM Mutter". Die Suche untercheidet + nicht nach Groß- und Kleinschreibung. Die folgende Liste von + Suchkriterien wurde aus dem Sourcecode des UW c-client erstellt, + sie ist daher nicht unbedingt vollständig oder in allen Einzelheiten + korrekt (siehe auch <ulink url="&url.rfc;2060">RFC2060</ulink>, + Abschnitt 6.4.4). + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + &imap.imap-stream.description; + <varlistentry> + <term><parameter>criteria</parameter></term> + <listitem> + <para> + Ein aus mit Leerzeichen getrennten Schlüsselworten und Argumenten. + Argumente die selbt Leerzeichen enthalten müssen in doppelte + Anführungszeichen gefasst werden (z.B. FROM "Hans Müller"). + Es existieren folgende Schlüsselworte: + <itemizedlist> + <listitem> + <simpara> + ALL - return all messages matching the rest of the criteria + </simpara> + </listitem> + <listitem> + <simpara> + ANSWERED - die gesuchten Nachrichten wurden beantwortet + </simpara> + </listitem> + <listitem> + <simpara> + BCC "text" - die gesuchten Nachrichten enthalten "text" im Bcc: Feld + </simpara> + </listitem> + <listitem> + <simpara> + BEFORE "datum" - die gesuchten Nachrichten wurden vor "datum" gesendet + </simpara> + </listitem> + <listitem> + <simpara> + BODY "text" - der Nachrichtenkörper enthält "text" + </simpara> + </listitem> + <listitem> + <simpara> + CC "text" - die gesuchten Nachrichten enthalten "text" im Cc: Feld + </simpara> + </listitem> + <listitem> + <simpara> + DELETED - die gesuchten Nachrichten sind zur Löschung vorgemerkt + </simpara> + </listitem> + <listitem> + <simpara> + FLAGGED - match messages with the \\FLAGGED (sometimes + referred to as Important or Urgent) flag set + </simpara> + </listitem> + <listitem> + <simpara> + FROM "text" - sucht Nachrichten mit "text" im Absender (From:) + </simpara> + </listitem> + <listitem> + <simpara> + KEYWORD "text" - sucht Nachrichten mit Schlüsselwort "text" + </simpara> + </listitem> + <listitem> + <simpara> + NEW - die gesuchten Nachrichten sind neu + </simpara> + </listitem> + <listitem> + <simpara> + OLD - die gesuchten Nachrichten sind nicht neu + </simpara> + </listitem> + <listitem> + <simpara> + ON "datum" - die Nachrichten wurden am angegebenen "datum" gesendet + </simpara> + </listitem> + <listitem> + <simpara> + RECENT - sucht Nachrichten deren \\RECENT Flag nocht gesetzt ist + </simpara> + </listitem> + <listitem> + <simpara> + SEEN - sucht bereits gelesene Nachrichten (das \\SEEN Flag ist gesetzt) + </simpara> + </listitem> + <listitem> + <simpara> + SINCE "datum" - sucht nach "datum" gesendete Nachrichten + </simpara> + </listitem> + <listitem> + <simpara> + SUBJECT "text" - sucht Nachrichten mit "text" in der Betreffzeile + </simpara> + </listitem> + <listitem> + <simpara> + TEXT "text" - sucht Nachrichten deren Text "text" enthält + </simpara> + </listitem> + <listitem> + <simpara> + TO "text" - sucht Nachrichten mit "text" im Empfänger (To:) + </simpara> + </listitem> + <listitem> + <simpara> + UNANSWERED - sucht noch nicht beantwortete Nachrichten + </simpara> + </listitem> + <listitem> + <simpara> + UNDELETED - sucht nicht zum Löschen vorgemerkte Nachrichten + </simpara> + </listitem> + <listitem> + <simpara> + UNFLAGGED - sucht Nachrichten die nicht als wichtig markiert sind + </simpara> + </listitem> + <listitem> + <simpara> + UNKEYWORD "text" - sucht Nachrichten in deren Schlüsselwörtern + "text" nicht enthalten ist + </simpara> + </listitem> + <listitem> + <simpara> + UNSEEN - sucht ungelesene Nachrichten + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Der Parameter <parameter>options</parameter> kann + auf <constant>SE_UID</constant> gesetzt werden + um UIDs statt Nachrichtennummern zurückzuerhalten. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>charset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Liefert ein Array mit Nachrichtennummern oder UIDs. + </para> + <para> + Wenn die Suchkriterien keinen Sinn ergaben oder + keine Nachrichten gefunden wurden wird &false; + zurückgegeben. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.3</entry> + <entry> + Der Parameter <parameter>charset</parameter> wurde hinzugefügt + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_listscan</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.de (#2037) next »