cvs: phpdoc-de /reference/pcre pattern.modifiers.xml
| From: | Martin Samesch | Date: | Fri, 04 Jan 2008 21:32:08 +0000 |
| Subject: | cvs: phpdoc-de /reference/pcre pattern.modifiers.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2363@lists.php.net to get a copy of this message | ||
samesch Fri Jan 4 21:32:08 2008 UTC
Modified files:
/phpdoc-de/reference/pcre pattern.modifiers.xml
Log:
syncing with EN; indentation
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/pattern.modifiers.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/pcre/pattern.modifiers.xml diff -u phpdoc-de/reference/pcre/pattern.modifiers.xml:1.9 phpdoc-de/reference/pcre/pattern.modifiers.xml:1.10 --- phpdoc-de/reference/pcre/pattern.modifiers.xml:1.9 Thu Dec 13 14:13:28 2007 +++ phpdoc-de/reference/pcre/pattern.modifiers.xml Fri Jan 4 21:32:08 2008 @@ -1,202 +1,196 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> <!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 --> -<refentry xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>Suchmuster-Modifikatoren</refname> - <refpurpose> - Beschreibt mögliche Modifikatoren in RegEx-Suchmustern - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <para> - Die zurzeit möglichen PCRE-Modifikatoren sind unten aufgelistet. Die - Bezeichnungen in Klammern beziehen sich auf die internen PCRE-Bezeichnungen - für diese Modifikatoren. Leerzeichen und Zeilenumbrüche in Modifikatoren - werden ignoriert. Andere Zeichen führen zu einem Fehler. - </para> - <para> - <blockquote> - <variablelist> - <varlistentry> - <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passen Buchstaben im Suchmuster - sowohl auf groß- als auch auf kleingeschriebene Buchstaben. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> - <listitem> - <simpara> - Standardmäßig behandelt PCRE eine zu durchsuchende Zeichenkette wie - eine einzige Zeile von Zeichen (auch wenn sie tatsächlich mehrere - Zeilenumbrüche enthält). Das Metazeichen für einen Zeilenanfang (^) - passt nur auf den Anfang der Zeichenkette, das Metazeichen für ein - Zeilenende ($) nur auf das Ende der Zeichenkette (falls der - Modifikator <emphasis>D</emphasis> nicht gesetzt ist). Das ist genauso - wie bei Perl. - </simpara> - <simpara> - Wenn dieser Modifikator gesetzt ist, passen die Zeilenanfang- und - Zeilenende-Konstrukte in der Zeichenkette sowohl direkt nach, bzw. vor - einem Zeilenumbruch als auch auf deren Anfang und Ende. Das entspricht - dem Perl-Modifikator /m. Falls die Zeichenkette keine Sequenz "\n" - enthält, oder im Suchmuster kein ^ oder $ vorkommt, hat dieser - Modifikator keine Wirkung. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>s</emphasis> (PCRE_DOTALL)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passt das Metazeichen Punkt im - Suchmuster auf alle Zeichen inklusive Zeilenumbrüche. Ohne diesen - Modifikator sind Zeilenumbrüche ausgeschlossen. Dieser Modifikator - entspricht dem Perl-Modifikator /s. Unabhängig davon, ob dieser - Modifikator gesetzt ist, passt eine verneinende Zeichenklasse wie z.B. - [^a] immer auf einen Zeilenumbruch. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>x</emphasis> (PCRE_EXTENDED)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, werden Leerräume im Suchmuster - ignoriert, sofern sie nicht maskiert sind oder sich innerhalb einer - Zeichenklasse befinden. Außerdem werden Zeichen, die außerhalb einer - Zeichenklasse zwischen nicht maskierten # stehen, einschließlich dem - nächsten Zeilenumbruch ignoriert. Das entspricht dem Perl-Modifikator - /x und bietet die Möglichkeit, Kommentare in komplizierte Suchmuster - einzufügen. Beachten Sie aber, dass dies nur für Datenzeichen gilt. - Leerräume dürfen niemals innerhalb einer Folge spezieller Zeichen - auftreten, zum Beispiel in der Folge <literal>(?(</literal>, die einen - bedingten Teilausdruck einleitet. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>e</emphasis> (PREG_REPLACE_EVAL)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, macht - <function>preg_replace</function> in der Ersetzungszeichenkette eine - normale Ersetzung von Rückrefenzen, wertet sie als PHP-Code aus und - verwendet das Ergebnis um damit die gesuchte Zeichenkette zu ersetzen. - Einfache Anführungszeichen, doppelte Anführungszeichen, Backslashes - und NULL-Zeichen werden in den ersetzten Rückreferenzen mit einem - Backslash maskiert. - </simpara> - <para> - Dieser Modifikator wird nur von <function>preg_replace</function> - verwendet; von anderen PCRE-Funktionen wird er ignoriert. - <note> - <simpara> - Dieser Modifikator steht in PHP 3 nicht zur Verfügung. - </simpara> - </note> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, wird das Suchmuster "verankert", - das bedeutet, dass es gezwungen wird, nur auf den Anfang der - durchsuchten Zeichenkette zu passen. Diese Wirkung kann auch durch - geeignete Konstrukte im Suchmuster selbst erreicht werden, was in Perl - die einzige Möglichkeit ist, sie zu realisieren. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>D</emphasis> (PCRE_DOLLAR_ENDONLY)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passt ein Dollar-Metazeichen im - Suchmuster nur auf das Ende der durchsuchten Zeichenkette. Ohne diesen - Modifikator passt ein Dollarzeichen auch direkt vor dem letzten - Zeichen, falls es ein Zeilenumbruch ist (aber nicht vor anderen - Zeilenumbrüchen). Wenn der Modifikator <emphasis>m</emphasis> gesetzt - ist, wird dieser Modifikator ignoriert. Für diesen Modifikator gibt es - in Perl keine Entsprechung. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>S</emphasis></term> - <listitem> - <simpara> - Wenn ein Suchmuster mehrmals verwendet werden soll, lohnt es sich, - mehr Zeit für dessen Analyse aufzubringen um die Suche zu optimieren. - Wenn dieser Modifikator gesetzt ist, wird diese zusätzliche Analyse - durchgeführt. Gegenwärtig ist die Untersuchung eines Suchmusters nur - für nicht verankerte Suchmuster brauchbar, die am Anfang kein - einzelnes fixiertes Zeichen haben. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>U</emphasis> (PCRE_UNGREEDY)</term> - <listitem> - <simpara> - Dieser Modifikator kehrt die Gier von Quantifikatoren um, sodass sie - standardmäßig nicht gierig sind, aber gierig werden, wenn ihnen ein - "?" folgt. Das ist nicht mit Perl kompatibel. Es kann auch <link - linkend="regexp.reference.internal-options">innerhalb des - Suchmusters</link> mit dem Modifikator (?U) oder durch ein - Fragezeichen hinter dem Quantifikator (z.B. <literal>.*?</literal>) - gesetzt werden. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>X</emphasis> (PCRE_EXTRA)</term> - <listitem> - <simpara> - Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche - PCRE-Funktionalität an. Ein Backslash vor einem Buchstaben, der keine - spezielle Bedeutung hat, verursacht eine Fehlermeldung und reserviert - diese Kombinationen somit für künftige Erweiterungen. Standardmäßig - wird ein Backslash vor einem Buchstaben, der keine spezielle Bedeutung - hat, wie in Perl als Buchstabensymbol behandelt. Gegenwärtig werden - von diesem Modifikator keine weiteren Eigenschaften kontrolliert. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>J</emphasis> (PCRE_INFO_JCHANGED)</term> - <listitem> - <simpara> - Die interne Option (?J) ändert die lokale Option PCRE_DUPNAMES. - Erlaubt doppelte Namen für Teilsuchmuster. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>u</emphasis> (PCRE_UTF8)</term> - <listitem> - <simpara> - Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche - PCRE-Funktionalität an. Suchmuster werden als UTF-8 behandelt. Dieser - Modifikator steht unter Unix seit PHP 4.1.0 und unter Win32 seit PHP - 4.2.3 zur Verfügung. Ob es sich im Suchmuster um gültiges UTF-8 - handelt, wird seit PHP 4.3.5 überprüft. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </blockquote> - </para> - </refsect1> -</refentry> +<article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> + <title>Suchmuster-Modifikatoren</title> + <titleabbrev> + Beschreibt mögliche Modifikatoren in RegEx-Suchmustern + </titleabbrev> + <para> + Die zurzeit möglichen PCRE-Modifikatoren sind unten aufgelistet. Die + Bezeichnungen in Klammern beziehen sich auf die internen PCRE-Bezeichnungen + für diese Modifikatoren. Leerzeichen und Zeilenumbrüche in Modifikatoren + werden ignoriert. Andere Zeichen führen zu einem Fehler. + </para> + <para> + <blockquote> + <variablelist> + <varlistentry> + <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passen Buchstaben im Suchmuster + sowohl auf groß- als auch auf kleingeschriebene Buchstaben. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> + <listitem> + <simpara> + Standardmäßig behandelt PCRE eine zu durchsuchende Zeichenkette wie + eine einzige Zeile von Zeichen (auch wenn sie tatsächlich mehrere + Zeilenumbrüche enthält). Das Metazeichen für einen Zeilenanfang (^) + passt nur auf den Anfang der Zeichenkette, das Metazeichen für ein + Zeilenende ($) nur auf das Ende der Zeichenkette (falls der Modifikator + <emphasis>D</emphasis> nicht gesetzt ist). Das ist genauso wie bei + Perl. + </simpara> + <simpara> + Wenn dieser Modifikator gesetzt ist, passen die Zeilenanfang- und + Zeilenende-Konstrukte in der Zeichenkette sowohl direkt nach, bzw. vor + einem Zeilenumbruch als auch auf deren Anfang und Ende. Das entspricht + dem Perl-Modifikator /m. Falls die Zeichenkette keine Sequenz "\n" + enthält, oder im Suchmuster kein ^ oder $ vorkommt, hat dieser + Modifikator keine Wirkung. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>s</emphasis> (PCRE_DOTALL)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passt das Metazeichen Punkt im + Suchmuster auf alle Zeichen inklusive Zeilenumbrüche. Ohne diesen + Modifikator sind Zeilenumbrüche ausgeschlossen. Dieser Modifikator + entspricht dem Perl-Modifikator /s. Unabhängig davon, ob dieser + Modifikator gesetzt ist, passt eine verneinende Zeichenklasse wie z.B. + [^a] immer auf einen Zeilenumbruch. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>x</emphasis> (PCRE_EXTENDED)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, werden Leerräume im Suchmuster + ignoriert, sofern sie nicht maskiert sind oder sich innerhalb einer + Zeichenklasse befinden. Außerdem werden Zeichen, die außerhalb einer + Zeichenklasse zwischen nicht maskierten # stehen, einschließlich dem + nächsten Zeilenumbruch ignoriert. Das entspricht dem Perl-Modifikator + /x und bietet die Möglichkeit, Kommentare in komplizierte Suchmuster + einzufügen. Beachten Sie aber, dass dies nur für Datenzeichen gilt. + Leerräume dürfen niemals innerhalb einer Folge spezieller Zeichen + auftreten, zum Beispiel in der Folge <literal>(?(</literal>, die einen + bedingten Teilausdruck einleitet. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>e</emphasis> (PREG_REPLACE_EVAL)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, macht + <function>preg_replace</function> in der Ersetzungszeichenkette eine + normale Ersetzung von Rückrefenzen, wertet sie als PHP-Code aus und + verwendet das Ergebnis um damit die gesuchte Zeichenkette zu ersetzen. + Einfache Anführungszeichen, doppelte Anführungszeichen, Backslashes und + NULL-Zeichen werden in den ersetzten Rückreferenzen mit einem Backslash + maskiert. + </simpara> + <para> + Dieser Modifikator wird nur von <function>preg_replace</function> + verwendet; von anderen PCRE-Funktionen wird er ignoriert. + <note> + <simpara> + Dieser Modifikator steht in PHP 3 nicht zur Verfügung. + </simpara> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, wird das Suchmuster "verankert", + das bedeutet, dass es gezwungen wird, nur auf den Anfang der + durchsuchten Zeichenkette zu passen. Diese Wirkung kann auch durch + geeignete Konstrukte im Suchmuster selbst erreicht werden, was in Perl + die einzige Möglichkeit ist, sie zu realisieren. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>D</emphasis> (PCRE_DOLLAR_ENDONLY)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passt ein Dollar-Metazeichen im + Suchmuster nur auf das Ende der durchsuchten Zeichenkette. Ohne diesen + Modifikator passt ein Dollarzeichen auch direkt vor dem letzten + Zeichen, falls es ein Zeilenumbruch ist (aber nicht vor anderen + Zeilenumbrüchen). Wenn der Modifikator <emphasis>m</emphasis> gesetzt + ist, wird dieser Modifikator ignoriert. Für diesen Modifikator gibt es + in Perl keine Entsprechung. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>S</emphasis></term> + <listitem> + <simpara> + Wenn ein Suchmuster mehrmals verwendet werden soll, lohnt es sich, mehr + Zeit für dessen Analyse aufzubringen um die Suche zu optimieren. Wenn + dieser Modifikator gesetzt ist, wird diese zusätzliche Analyse + durchgeführt. Gegenwärtig ist die Untersuchung eines Suchmusters nur + für nicht verankerte Suchmuster brauchbar, die am Anfang kein einzelnes + fixiertes Zeichen haben. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>U</emphasis> (PCRE_UNGREEDY)</term> + <listitem> + <simpara> + Dieser Modifikator kehrt die Gier von Quantifikatoren um, sodass sie + standardmäßig nicht gierig sind, aber gierig werden, wenn ihnen ein "?" + folgt. Das ist nicht mit Perl kompatibel. Es kann auch <link + linkend="regexp.reference.internal-options">innerhalb des + Suchmusters</link> mit dem Modifikator (?U) oder durch ein Fragezeichen + hinter dem Quantifikator (z.B. <literal>.*?</literal>) gesetzt werden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>X</emphasis> (PCRE_EXTRA)</term> + <listitem> + <simpara> + Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche + PCRE-Funktionalität an. Ein Backslash vor einem Buchstaben, der keine + spezielle Bedeutung hat, verursacht eine Fehlermeldung und reserviert + diese Kombinationen somit für künftige Erweiterungen. Standardmäßig + wird ein Backslash vor einem Buchstaben, der keine spezielle Bedeutung + hat, wie in Perl als Buchstabensymbol behandelt. Gegenwärtig werden von + diesem Modifikator keine weiteren Eigenschaften kontrolliert. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>J</emphasis> (PCRE_INFO_JCHANGED)</term> + <listitem> + <simpara> + Die interne Option (?J) ändert die lokale Option PCRE_DUPNAMES. Erlaubt + doppelte Namen für Teilsuchmuster. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>u</emphasis> (PCRE_UTF8)</term> + <listitem> + <simpara> + Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche + PCRE-Funktionalität an. Suchmuster werden als UTF-8 behandelt. Dieser + Modifikator steht unter Unix seit PHP 4.1.0 und unter Win32 seit PHP + 4.2.3 zur Verfügung. Ob es sich im Suchmuster um gültiges UTF-8 + handelt, wird seit PHP 4.3.5 überprüft. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </blockquote> + </para> +</article> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/pattern.modifiers.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/pcre/pattern.modifiers.xml diff -u phpdoc-de/reference/pcre/pattern.modifiers.xml:1.9 phpdoc-de/reference/pcre/pattern.modifiers.xml:1.10 --- phpdoc-de/reference/pcre/pattern.modifiers.xml:1.9 Thu Dec 13 14:13:28 2007 +++ phpdoc-de/reference/pcre/pattern.modifiers.xml Fri Jan 4 21:32:08 2008 @@ -1,202 +1,196 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> <!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 --> -<refentry xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>Suchmuster-Modifikatoren</refname> - <refpurpose> - Beschreibt mögliche Modifikatoren in RegEx-Suchmustern - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <para> - Die zurzeit möglichen PCRE-Modifikatoren sind unten aufgelistet. Die - Bezeichnungen in Klammern beziehen sich auf die internen PCRE-Bezeichnungen - für diese Modifikatoren. Leerzeichen und Zeilenumbrüche in Modifikatoren - werden ignoriert. Andere Zeichen führen zu einem Fehler. - </para> - <para> - <blockquote> - <variablelist> - <varlistentry> - <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passen Buchstaben im Suchmuster - sowohl auf groß- als auch auf kleingeschriebene Buchstaben. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> - <listitem> - <simpara> - Standardmäßig behandelt PCRE eine zu durchsuchende Zeichenkette wie - eine einzige Zeile von Zeichen (auch wenn sie tatsächlich mehrere - Zeilenumbrüche enthält). Das Metazeichen für einen Zeilenanfang (^) - passt nur auf den Anfang der Zeichenkette, das Metazeichen für ein - Zeilenende ($) nur auf das Ende der Zeichenkette (falls der - Modifikator <emphasis>D</emphasis> nicht gesetzt ist). Das ist genauso - wie bei Perl. - </simpara> - <simpara> - Wenn dieser Modifikator gesetzt ist, passen die Zeilenanfang- und - Zeilenende-Konstrukte in der Zeichenkette sowohl direkt nach, bzw. vor - einem Zeilenumbruch als auch auf deren Anfang und Ende. Das entspricht - dem Perl-Modifikator /m. Falls die Zeichenkette keine Sequenz "\n" - enthält, oder im Suchmuster kein ^ oder $ vorkommt, hat dieser - Modifikator keine Wirkung. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>s</emphasis> (PCRE_DOTALL)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passt das Metazeichen Punkt im - Suchmuster auf alle Zeichen inklusive Zeilenumbrüche. Ohne diesen - Modifikator sind Zeilenumbrüche ausgeschlossen. Dieser Modifikator - entspricht dem Perl-Modifikator /s. Unabhängig davon, ob dieser - Modifikator gesetzt ist, passt eine verneinende Zeichenklasse wie z.B. - [^a] immer auf einen Zeilenumbruch. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>x</emphasis> (PCRE_EXTENDED)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, werden Leerräume im Suchmuster - ignoriert, sofern sie nicht maskiert sind oder sich innerhalb einer - Zeichenklasse befinden. Außerdem werden Zeichen, die außerhalb einer - Zeichenklasse zwischen nicht maskierten # stehen, einschließlich dem - nächsten Zeilenumbruch ignoriert. Das entspricht dem Perl-Modifikator - /x und bietet die Möglichkeit, Kommentare in komplizierte Suchmuster - einzufügen. Beachten Sie aber, dass dies nur für Datenzeichen gilt. - Leerräume dürfen niemals innerhalb einer Folge spezieller Zeichen - auftreten, zum Beispiel in der Folge <literal>(?(</literal>, die einen - bedingten Teilausdruck einleitet. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>e</emphasis> (PREG_REPLACE_EVAL)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, macht - <function>preg_replace</function> in der Ersetzungszeichenkette eine - normale Ersetzung von Rückrefenzen, wertet sie als PHP-Code aus und - verwendet das Ergebnis um damit die gesuchte Zeichenkette zu ersetzen. - Einfache Anführungszeichen, doppelte Anführungszeichen, Backslashes - und NULL-Zeichen werden in den ersetzten Rückreferenzen mit einem - Backslash maskiert. - </simpara> - <para> - Dieser Modifikator wird nur von <function>preg_replace</function> - verwendet; von anderen PCRE-Funktionen wird er ignoriert. - <note> - <simpara> - Dieser Modifikator steht in PHP 3 nicht zur Verfügung. - </simpara> - </note> - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, wird das Suchmuster "verankert", - das bedeutet, dass es gezwungen wird, nur auf den Anfang der - durchsuchten Zeichenkette zu passen. Diese Wirkung kann auch durch - geeignete Konstrukte im Suchmuster selbst erreicht werden, was in Perl - die einzige Möglichkeit ist, sie zu realisieren. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>D</emphasis> (PCRE_DOLLAR_ENDONLY)</term> - <listitem> - <simpara> - Wenn dieser Modifikator gesetzt ist, passt ein Dollar-Metazeichen im - Suchmuster nur auf das Ende der durchsuchten Zeichenkette. Ohne diesen - Modifikator passt ein Dollarzeichen auch direkt vor dem letzten - Zeichen, falls es ein Zeilenumbruch ist (aber nicht vor anderen - Zeilenumbrüchen). Wenn der Modifikator <emphasis>m</emphasis> gesetzt - ist, wird dieser Modifikator ignoriert. Für diesen Modifikator gibt es - in Perl keine Entsprechung. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>S</emphasis></term> - <listitem> - <simpara> - Wenn ein Suchmuster mehrmals verwendet werden soll, lohnt es sich, - mehr Zeit für dessen Analyse aufzubringen um die Suche zu optimieren. - Wenn dieser Modifikator gesetzt ist, wird diese zusätzliche Analyse - durchgeführt. Gegenwärtig ist die Untersuchung eines Suchmusters nur - für nicht verankerte Suchmuster brauchbar, die am Anfang kein - einzelnes fixiertes Zeichen haben. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>U</emphasis> (PCRE_UNGREEDY)</term> - <listitem> - <simpara> - Dieser Modifikator kehrt die Gier von Quantifikatoren um, sodass sie - standardmäßig nicht gierig sind, aber gierig werden, wenn ihnen ein - "?" folgt. Das ist nicht mit Perl kompatibel. Es kann auch <link - linkend="regexp.reference.internal-options">innerhalb des - Suchmusters</link> mit dem Modifikator (?U) oder durch ein - Fragezeichen hinter dem Quantifikator (z.B. <literal>.*?</literal>) - gesetzt werden. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>X</emphasis> (PCRE_EXTRA)</term> - <listitem> - <simpara> - Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche - PCRE-Funktionalität an. Ein Backslash vor einem Buchstaben, der keine - spezielle Bedeutung hat, verursacht eine Fehlermeldung und reserviert - diese Kombinationen somit für künftige Erweiterungen. Standardmäßig - wird ein Backslash vor einem Buchstaben, der keine spezielle Bedeutung - hat, wie in Perl als Buchstabensymbol behandelt. Gegenwärtig werden - von diesem Modifikator keine weiteren Eigenschaften kontrolliert. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>J</emphasis> (PCRE_INFO_JCHANGED)</term> - <listitem> - <simpara> - Die interne Option (?J) ändert die lokale Option PCRE_DUPNAMES. - Erlaubt doppelte Namen für Teilsuchmuster. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis>u</emphasis> (PCRE_UTF8)</term> - <listitem> - <simpara> - Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche - PCRE-Funktionalität an. Suchmuster werden als UTF-8 behandelt. Dieser - Modifikator steht unter Unix seit PHP 4.1.0 und unter Win32 seit PHP - 4.2.3 zur Verfügung. Ob es sich im Suchmuster um gültiges UTF-8 - handelt, wird seit PHP 4.3.5 überprüft. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </blockquote> - </para> - </refsect1> -</refentry> +<article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook"> + <title>Suchmuster-Modifikatoren</title> + <titleabbrev> + Beschreibt mögliche Modifikatoren in RegEx-Suchmustern + </titleabbrev> + <para> + Die zurzeit möglichen PCRE-Modifikatoren sind unten aufgelistet. Die + Bezeichnungen in Klammern beziehen sich auf die internen PCRE-Bezeichnungen + für diese Modifikatoren. Leerzeichen und Zeilenumbrüche in Modifikatoren + werden ignoriert. Andere Zeichen führen zu einem Fehler. + </para> + <para> + <blockquote> + <variablelist> + <varlistentry> + <term><emphasis>i</emphasis> (PCRE_CASELESS)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passen Buchstaben im Suchmuster + sowohl auf groß- als auch auf kleingeschriebene Buchstaben. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>m</emphasis> (PCRE_MULTILINE)</term> + <listitem> + <simpara> + Standardmäßig behandelt PCRE eine zu durchsuchende Zeichenkette wie + eine einzige Zeile von Zeichen (auch wenn sie tatsächlich mehrere + Zeilenumbrüche enthält). Das Metazeichen für einen Zeilenanfang (^) + passt nur auf den Anfang der Zeichenkette, das Metazeichen für ein + Zeilenende ($) nur auf das Ende der Zeichenkette (falls der Modifikator + <emphasis>D</emphasis> nicht gesetzt ist). Das ist genauso wie bei + Perl. + </simpara> + <simpara> + Wenn dieser Modifikator gesetzt ist, passen die Zeilenanfang- und + Zeilenende-Konstrukte in der Zeichenkette sowohl direkt nach, bzw. vor + einem Zeilenumbruch als auch auf deren Anfang und Ende. Das entspricht + dem Perl-Modifikator /m. Falls die Zeichenkette keine Sequenz "\n" + enthält, oder im Suchmuster kein ^ oder $ vorkommt, hat dieser + Modifikator keine Wirkung. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>s</emphasis> (PCRE_DOTALL)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passt das Metazeichen Punkt im + Suchmuster auf alle Zeichen inklusive Zeilenumbrüche. Ohne diesen + Modifikator sind Zeilenumbrüche ausgeschlossen. Dieser Modifikator + entspricht dem Perl-Modifikator /s. Unabhängig davon, ob dieser + Modifikator gesetzt ist, passt eine verneinende Zeichenklasse wie z.B. + [^a] immer auf einen Zeilenumbruch. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>x</emphasis> (PCRE_EXTENDED)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, werden Leerräume im Suchmuster + ignoriert, sofern sie nicht maskiert sind oder sich innerhalb einer + Zeichenklasse befinden. Außerdem werden Zeichen, die außerhalb einer + Zeichenklasse zwischen nicht maskierten # stehen, einschließlich dem + nächsten Zeilenumbruch ignoriert. Das entspricht dem Perl-Modifikator + /x und bietet die Möglichkeit, Kommentare in komplizierte Suchmuster + einzufügen. Beachten Sie aber, dass dies nur für Datenzeichen gilt. + Leerräume dürfen niemals innerhalb einer Folge spezieller Zeichen + auftreten, zum Beispiel in der Folge <literal>(?(</literal>, die einen + bedingten Teilausdruck einleitet. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>e</emphasis> (PREG_REPLACE_EVAL)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, macht + <function>preg_replace</function> in der Ersetzungszeichenkette eine + normale Ersetzung von Rückrefenzen, wertet sie als PHP-Code aus und + verwendet das Ergebnis um damit die gesuchte Zeichenkette zu ersetzen. + Einfache Anführungszeichen, doppelte Anführungszeichen, Backslashes und + NULL-Zeichen werden in den ersetzten Rückreferenzen mit einem Backslash + maskiert. + </simpara> + <para> + Dieser Modifikator wird nur von <function>preg_replace</function> + verwendet; von anderen PCRE-Funktionen wird er ignoriert. + <note> + <simpara> + Dieser Modifikator steht in PHP 3 nicht zur Verfügung. + </simpara> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>A</emphasis> (PCRE_ANCHORED)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, wird das Suchmuster "verankert", + das bedeutet, dass es gezwungen wird, nur auf den Anfang der + durchsuchten Zeichenkette zu passen. Diese Wirkung kann auch durch + geeignete Konstrukte im Suchmuster selbst erreicht werden, was in Perl + die einzige Möglichkeit ist, sie zu realisieren. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>D</emphasis> (PCRE_DOLLAR_ENDONLY)</term> + <listitem> + <simpara> + Wenn dieser Modifikator gesetzt ist, passt ein Dollar-Metazeichen im + Suchmuster nur auf das Ende der durchsuchten Zeichenkette. Ohne diesen + Modifikator passt ein Dollarzeichen auch direkt vor dem letzten + Zeichen, falls es ein Zeilenumbruch ist (aber nicht vor anderen + Zeilenumbrüchen). Wenn der Modifikator <emphasis>m</emphasis> gesetzt + ist, wird dieser Modifikator ignoriert. Für diesen Modifikator gibt es + in Perl keine Entsprechung. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>S</emphasis></term> + <listitem> + <simpara> + Wenn ein Suchmuster mehrmals verwendet werden soll, lohnt es sich, mehr + Zeit für dessen Analyse aufzubringen um die Suche zu optimieren. Wenn + dieser Modifikator gesetzt ist, wird diese zusätzliche Analyse + durchgeführt. Gegenwärtig ist die Untersuchung eines Suchmusters nur + für nicht verankerte Suchmuster brauchbar, die am Anfang kein einzelnes + fixiertes Zeichen haben. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>U</emphasis> (PCRE_UNGREEDY)</term> + <listitem> + <simpara> + Dieser Modifikator kehrt die Gier von Quantifikatoren um, sodass sie + standardmäßig nicht gierig sind, aber gierig werden, wenn ihnen ein "?" + folgt. Das ist nicht mit Perl kompatibel. Es kann auch <link + linkend="regexp.reference.internal-options">innerhalb des + Suchmusters</link> mit dem Modifikator (?U) oder durch ein Fragezeichen + hinter dem Quantifikator (z.B. <literal>.*?</literal>) gesetzt werden. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>X</emphasis> (PCRE_EXTRA)</term> + <listitem> + <simpara> + Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche + PCRE-Funktionalität an. Ein Backslash vor einem Buchstaben, der keine + spezielle Bedeutung hat, verursacht eine Fehlermeldung und reserviert + diese Kombinationen somit für künftige Erweiterungen. Standardmäßig + wird ein Backslash vor einem Buchstaben, der keine spezielle Bedeutung + hat, wie in Perl als Buchstabensymbol behandelt. Gegenwärtig werden von + diesem Modifikator keine weiteren Eigenschaften kontrolliert. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>J</emphasis> (PCRE_INFO_JCHANGED)</term> + <listitem> + <simpara> + Die interne Option (?J) ändert die lokale Option PCRE_DUPNAMES. Erlaubt + doppelte Namen für Teilsuchmuster. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><emphasis>u</emphasis> (PCRE_UTF8)</term> + <listitem> + <simpara> + Dieser Modifikator schaltet mit Perl nicht kompatible zusätzliche + PCRE-Funktionalität an. Suchmuster werden als UTF-8 behandelt. Dieser + Modifikator steht unter Unix seit PHP 4.1.0 und unter Win32 seit PHP + 4.2.3 zur Verfügung. Ob es sich im Suchmuster um gültiges UTF-8 + handelt, wird seit PHP 4.3.5 überprüft. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </blockquote> + </para> +</article> <!-- Keep this comment at the end of the file Local variables: