cvs: phpdoc-de /reference/regex configure.xml reference.xml /reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml
split.xml spliti.xml sql-regcase.xml
| From: | Martin Samesch | Date: | Sat, 21 Jun 2003 14:06:53 +0000 |
| Subject: | cvs: phpdoc-de /reference/regex configure.xml reference.xml /reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml split.xml spliti.xml sql-regcase.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-754@lists.php.net to get a copy of this message | ||
samesch Sat Jun 21 10:06:53 2003 EDT
Modified files:
/phpdoc-de/reference/regex configure.xml reference.xml
/phpdoc-de/reference/regex/functions ereg-replace.xml ereg.xml
eregi-replace.xml eregi.xml
split.xml spliti.xml
sql-regcase.xml
Log:
syncing with EN
Index: phpdoc-de/reference/regex/configure.xml diff -u phpdoc-de/reference/regex/configure.xml:1.1 phpdoc-de/reference/regex/configure.xml:1.2 --- phpdoc-de/reference/regex/configure.xml:1.1 Tue Jan 7 15:24:52 2003 +++ phpdoc-de/reference/regex/configure.xml Sat Jun 21 10:06:53 2003 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <section id="regex.installation"> &reftitle.install; + <warning> + <simpara> + Sie sollten TYPE nur ändern, wenn Sie wissen, was Sie tun. + </simpara> + </warning> <para> Um die regexp-Unterstützung zu aktivieren, müssen Sie PHP mit der Option <option role="configure">--with-regex[=TYPE]</option> übersetzen. TYPE kann entweder system, apache oder php sein. Standardmäßig wird php verwendet. </para> - <note> - <simpara> - Sie sollten TYPE nur ändern, wenn Sie wissen, was Sie tun. - </simpara> - </note> &windows.builtin; </section> Index: phpdoc-de/reference/regex/reference.xml diff -u phpdoc-de/reference/regex/reference.xml:1.7 phpdoc-de/reference/regex/reference.xml:1.8 --- phpdoc-de/reference/regex/reference.xml:1.7 Fri May 16 11:32:50 2003 +++ phpdoc-de/reference/regex/reference.xml Sat Jun 21 10:06:53 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <reference id="ref.regex"> <title>Reguläre Ausdrücke Funktionen (POSIX erweitert)</title> <titleabbrev>Regexps</titleabbrev> @@ -8,7 +8,7 @@ <partintro> <section id="regex.intro"> &reftitle.intro; - <note> + <tip> <para> Bei Verwendung der <link linkend="ref.pcre">PCRE Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit @@ -17,7 +17,7 @@ andere Merkmale, die von der POSIX-erweiterten Syntax regulärer Ausdrücke nicht unterstützt werden. </para> - </note> + </tip> <warning> <para> Diese Funktionen regulärer Ausdrücke sind im Gegensatz zu den @@ -49,6 +49,8 @@ <simpara><function>spliti</function></simpara> </listitem> </itemizedlist> + </para> + <para> Alle diese Funktionen nehmen als erstes Argument einen regulären Ausdruck an. PHP verwendet durch POSIX 1003.2 definierte POSIX erweiterte reguläre Ausdrücke. Eine vollständige Beschreibung der @@ -89,34 +91,33 @@ <title>Beispiele regulärer Ausdrücke</title> <programlisting role="php"> <![CDATA[ +<?php +// Gibt true zurück, falls "abc" irgendwo in $string gefunden wird. ereg ("abc", $string); -/* Gibt true zurück, falls "abc" - irgendwo in $string gefunden wird. */ +// Gibt true zurück, falls "abc" am Anfang von $string gefunden wird. ereg ("^abc", $string); -/* Gibt true zurück, falls "abc" - am Anfang von $string gefunden wird. */ +// Gibt true zurück, falls "abc" am Ende von $string gefunden wird. ereg ("abc$", $string); -/* Gibt true zurück, falls "abc" - am Ende von $string gefunden wird. */ +// Gibt true zurück, falls es sich beim Client Browser um Netscape 2, +// 3 oder MSIE 3 handelt. eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); -/* Gibt true zurück, falls es sich beim Client Browser - um Netscape 2, 3 oder MSIE 3 handelt. */ +// Setzt drei Wörter, die durch Leerzeichen getrennt sind, in +// $regs[1], $regs[2] und $regs[3] ein. ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); -/* Setzt drei Wörter, die durch Leerzeichen getrennt - sind, in $regs[1], $regs[2] und $regs[3] ein. */ +// Setzt ein <br /> Tag vor $string. $string = ereg_replace ("^", "<br />", $string); -/* Setzt ein <br /> Tag vor $string. */ +// Setzt ein <br /> Tag hinter $string. $string = ereg_replace ("$", "<br />", $string); -/* Setzt ein <br /> Tag hinter $string. */ +// Entfernt alle Zeilenumbrüche aus $string. $string = ereg_replace ("\n", "", $string); -/* Entfernt alle Zeilenumbrüche aus $string. */ +?> ]]> </programlisting> </example> @@ -136,7 +137,7 @@ </section> </partintro> -&reference.regex.functions; + &reference.regex.functions; </reference> <!-- Keep this comment at the end of the file Index: phpdoc-de/reference/regex/functions/ereg-replace.xml diff -u phpdoc-de/reference/regex/functions/ereg-replace.xml:1.4 phpdoc-de/reference/regex/functions/ereg-replace.xml:1.5 --- phpdoc-de/reference/regex/functions/ereg-replace.xml:1.4 Sat Mar 1 06:33:31 2003 +++ phpdoc-de/reference/regex/functions/ereg-replace.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'ereg-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.ereg-replace"> <refnamediv> @@ -11,19 +11,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ereg_replace</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - </methodsynopsis> - <note> - <para> - Die Funktion <function>preg_replace</function>, die eine zu Perl - kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die - schnellere Alternative zu <function>ereg_replace</function>. - </para> - </note> + <methodsynopsis> + <type>string</type><methodname>ereg_replace</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + </methodsynopsis> <simpara> Diese Funktion durchsucht <parameter>Zeichenkette</parameter> nach Übereinstimmungen mit <parameter>Suchmuster</parameter> und @@ -54,6 +47,8 @@ <para> Der folgende Code-Schnipsel gibt zum Beispiel dreimal "Das war ein Test" aus: + </para> + <para> <example> <title><function>ereg_replace</function> Beispiel</title> <programlisting> @@ -73,6 +68,8 @@ daran, dass <function>ereg_replace</function> die Zahl als Ordinalwert eines Zeichens betrachtet und dieses verwendet. Zum Beispiel: + </para> + <para> <example> <title><function>ereg_replace</function> Beispiel</title> <programlisting> @@ -99,12 +96,21 @@ <title>Ersetzen von URLs durch Links</title> <programlisting role="php"> <![CDATA[ +<?php $text = ereg_replace("[[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/]", "<a href=\"\\0\">\\0</a>", $text); +?> ]]> </programlisting> </example> </para> + <tip> + <para> + Die Funktion <function>preg_replace</function>, die eine zu Perl + kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die + schnellere Alternative zu <function>ereg_replace</function>. + </para> + </tip> <para> Siehe auch: <function>ereg</function>, <function>eregi</function>, <function>eregi_replace</function>, Index: phpdoc-de/reference/regex/functions/ereg.xml diff -u phpdoc-de/reference/regex/functions/ereg.xml:1.5 phpdoc-de/reference/regex/functions/ereg.xml:1.6 --- phpdoc-de/reference/regex/functions/ereg.xml:1.5 Sat Mar 1 06:33:56 2003 +++ phpdoc-de/reference/regex/functions/ereg.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'ereg' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.ereg"> <refnamediv> @@ -13,12 +13,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>ereg</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>ereg</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> + </methodsynopsis> <note> <para> Die Funktion <function>preg_match</function>, die eine zu Perl @@ -27,7 +27,8 @@ </para> </note> <simpara> - Sucht in <parameter>Zeichenkette</parameter> nach + Sucht in <parameter>Zeichenkette</parameter> unter + Berücksichtigung der Groß- und Kleinschreibung nach Übereinstimmungen mit dem regulären Ausdruck, der in <parameter>Suchmuster</parameter> angegeben wurde. </simpara> @@ -42,19 +43,18 @@ Übereinstimmung mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten <parameter>Zeichenkette</parameter>. </simpara> - <simpara> - Bis (und inklusive) PHP 4.1.0 wird <literal>$regs</literal> mit - genau zehn Elementen gefüllt, auch wenn es tatsächlich mehr oder - weniger Übereinstimmungen mit den eingeklammerten - Teilzeichenketten gibt. Dies wirkt sich aber nicht auf - <function>ereg</function>s Fähigkeit aus, mehr übereinstimmende - Teilzeichenketten zu finden. Falls keine Übereinstimmungen - gefunden werden, wird <literal>$regs</literal> nicht von - <function>ereg</function> verändert. - </simpara> - <simpara> - Die Suche unterscheidet zwischen Groß und Kleinschreibung. - </simpara> + <note> + <simpara> + Bis (und inklusive) PHP 4.1.0 wird <literal>$regs</literal> mit + genau zehn Elementen gefüllt, auch wenn es tatsächlich mehr oder + weniger Übereinstimmungen mit den eingeklammerten + Teilzeichenketten gibt. Dies wirkt sich aber nicht auf + <function>ereg</function>s Fähigkeit aus, mehr übereinstimmende + Teilzeichenketten zu finden. Falls keine Übereinstimmungen + gefunden werden, wird <literal>$regs</literal> nicht von + <function>ereg</function> verändert. + </simpara> + </note> <simpara> Gibt &true; zurück, wenn in <parameter>Zeichenkette</parameter> eine Übereinstimmung mit <parameter>Suchmuster</parameter> @@ -64,6 +64,8 @@ <para> Der folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) und gibt es im Format TT.MM.JJJJ aus: + </para> + <para> <example> <title><function>ereg</function> Beispiel</title> <programlisting role="php"> Index: phpdoc-de/reference/regex/functions/eregi-replace.xml diff -u phpdoc-de/reference/regex/functions/eregi-replace.xml:1.3 phpdoc-de/reference/regex/functions/eregi-replace.xml:1.4 --- phpdoc-de/reference/regex/functions/eregi-replace.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/eregi-replace.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'eregi-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.eregi-replace"> <refnamediv> @@ -14,12 +14,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>eregi_replace</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>eregi_replace</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>ereg_replace</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Index: phpdoc-de/reference/regex/functions/eregi.xml diff -u phpdoc-de/reference/regex/functions/eregi.xml:1.4 phpdoc-de/reference/regex/functions/eregi.xml:1.5 --- phpdoc-de/reference/regex/functions/eregi.xml:1.4 Thu Feb 20 11:21:34 2003 +++ phpdoc-de/reference/regex/functions/eregi.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'eregi' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.eregi"> <refnamediv> @@ -14,16 +14,18 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>eregi</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>eregi</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>ereg</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. + </para> + <para> <example> <title><function>eregi</function> Beispiel</title> <programlisting role="php"> Index: phpdoc-de/reference/regex/functions/split.xml diff -u phpdoc-de/reference/regex/functions/split.xml:1.5 phpdoc-de/reference/regex/functions/split.xml:1.6 --- phpdoc-de/reference/regex/functions/split.xml:1.5 Mon Aug 26 11:30:59 2002 +++ phpdoc-de/reference/regex/functions/split.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.8 --> <!-- last change to 'split' in en/ tree in rev 1.7 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.7 --> <refentry id="function.split"> <refnamediv> @@ -14,25 +14,30 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>array</type><methodname>split</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> - </methodsynopsis> - <note> + <methodsynopsis> + <type>array</type><methodname>split</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> + </methodsynopsis> + <tip> <para> Die Funktion <function>preg_split</function>, die eine zu Perl kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die - schnellere Alternative zu <function>split</function>. + schnellere Alternative zu <function>split</function>. Wenn Sie + die Fähigkeiten regulärer Ausdrücke nicht benötigen, ist die + Verwendung von <function>explode</function> schneller, weil + diese Funktion nicht unter der Last der Engine für reguläre + Ausdrücke steht. </para> - </note> + </tip> <para> Gibt ein Array mit Zeichenketten zurück, die jeweils eine - Teilzeichenkette von <parameter>Zeichenkette</parameter> sind und - durch deren Zerlegung an den durch - <parameter>Suchmuster</parameter> des regulären Ausdrucks - bestimmten Stellen entstehen. Wenn + Teilzeichenkette von <parameter>Zeichenkette</parameter> sind. + Diese Teilzeichenketten entstehen durch Zerlegung von + <parameter>Zeichenkette</parameter> an den durch + <parameter>Suchmuster</parameter> des Groß- und Kleinschreibung + berücksichtigenden regulären Ausdrucks bestimmten Stellen. Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das zurückgegebene Array höchstens <parameter>Beschränkung</parameter> Elemente, von denen das @@ -43,53 +48,50 @@ <para> Um die ersten vier Felder einer Zeile von <filename>/etc/passwd</filename> abzuspalten: + </para> + <para> <example> <title><function>split</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -list($user,$pass,$uid,$gid,$extra)= split (":", $passwd_line, 5); +<?php +list($user, $pass, $uid, $gid, $extra) = + split (":", $passwd_line, 5); +?> ]]> </programlisting> </example> </para> - <note> - <simpara> - Wenn <parameter>Suchmuster</parameter> - <replaceable>n</replaceable> mal vorkommt, enhält das - zurückgegebene Array - <literal><replaceable>n</replaceable>+1</literal> Elemente. - Kommt <parameter>Suchmuster</parameter> zum Beispiel überhaupt - nicht vor, wird ein Array mit nur einem Element zurückgegeben. - Das gilt natürlich auch, wenn - <parameter>Zeichenkette</parameter> leer ist. - </simpara> - </note> + <simpara> + Wenn <parameter>Suchmuster</parameter> + <replaceable>n</replaceable> mal vorkommt, enhält das + zurückgegebene Array + <literal><replaceable>n</replaceable>+1</literal> Elemente. Kommt + <parameter>Suchmuster</parameter> zum Beispiel überhaupt nicht + vor, wird ein Array mit nur einem Element zurückgegeben. Das gilt + natürlich auch, wenn <parameter>Zeichenkette</parameter> leer + ist. + </simpara> <para> Um ein Datum zu analysieren, das durch Schrägstriche, Punkte oder Bindestriche getrennt ist: + </para> + <para> <example> <title><function>split</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -$datum = "04/30/1973"; // Trennzeichen darf ein Schrägstrich, Punkt - // oder Bindestrich sein +<?php +// Trennzeichen darf ein Schrägstrich, Punkt oder Bindestrich sein +$datum = "04/30/1973"; list ($monat, $tag, $jahr) = split ('[/.-]', $datum); -echo "Monat: $monat; Tag: $tag; Jahr: $jahr<br>\n"; +echo "Monat: $monat; Tag: $tag; Jahr: $jahr<br />\n"; +?> ]]> </programlisting> </example> </para> <para> - Beachten Sie, dass <parameter>Suchmuster</parameter> Groß- und - Kleinschreibung berücksichtigt. - </para> - <para> - Beachten Sie: wenn Sie die Fähigkeiten regulärer Ausdrücke nicht - benötigen, ist die Verwendung von <function>explode</function> - schneller, weil diese Funktion nicht unter der Last der Engine - für reguläre Ausdrücke steht. - </para> - <para> Wenn Sie nach einer Möglichkeit suchen, das Verhalten von Perls <command>@chars = split('', $str)</command> nachzuahmen, schauen Sie sich bitte die Beispiele für <function>preg_split</function> @@ -104,9 +106,9 @@ <function>split</function> (oder, bei diesem Thema, eine andere Regex-Funktion) verhalte sich seltsam, lesen Sie bitte die Datei <filename>regex.7</filename>, die sich im - <filename class="directory">regex/</filename> Unterverzeichnis ihrer - PHP-Distribution befindet. Da sie im manpage-Fomat vorliegt, - sollten Sie einen Befehl der Art <command>man + <filename class="directory">regex/</filename> Unterverzeichnis + ihrer PHP-Distribution befindet. Da sie im manpage-Fomat + vorliegt, sollten Sie einen Befehl der Art <command>man /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. </para> Index: phpdoc-de/reference/regex/functions/spliti.xml diff -u phpdoc-de/reference/regex/functions/spliti.xml:1.3 phpdoc-de/reference/regex/functions/spliti.xml:1.4 --- phpdoc-de/reference/regex/functions/spliti.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/spliti.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'spliti' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.spliti"> <refnamediv> @@ -14,12 +14,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>array</type><methodname>spliti</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>spliti</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>split</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Index: phpdoc-de/reference/regex/functions/sql-regcase.xml diff -u phpdoc-de/reference/regex/functions/sql-regcase.xml:1.3 phpdoc-de/reference/regex/functions/sql-regcase.xml:1.4 --- phpdoc-de/reference/regex/functions/sql-regcase.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/sql-regcase.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'sql-regcase' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.sql-regcase"> <refnamediv> @@ -26,15 +26,22 @@ Klammerausdruck umgewandelt wird. Die Klammer enthält dieses Zeichen, wenn möglich, in groß- und kleingeschriebener Form, andernfalls enthält sie das ursprüngliche Zeichen zweimal. + </para> + <para> <example> <title><function>sql_regcase</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php echo sql_regcase ("Foo bar"); +?> ]]> </programlisting> + <para> + Ausgabe: + </para> + <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen> </example> - Gibt <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen> aus. </para> <para> Dies kann bei Produkten, die nur reguläre Ausdrücke mit
Index: phpdoc-de/reference/regex/configure.xml diff -u phpdoc-de/reference/regex/configure.xml:1.1 phpdoc-de/reference/regex/configure.xml:1.2 --- phpdoc-de/reference/regex/configure.xml:1.1 Tue Jan 7 15:24:52 2003 +++ phpdoc-de/reference/regex/configure.xml Sat Jun 21 10:06:53 2003 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <section id="regex.installation"> &reftitle.install; + <warning> + <simpara> + Sie sollten TYPE nur ändern, wenn Sie wissen, was Sie tun. + </simpara> + </warning> <para> Um die regexp-Unterstützung zu aktivieren, müssen Sie PHP mit der Option <option role="configure">--with-regex[=TYPE]</option> übersetzen. TYPE kann entweder system, apache oder php sein. Standardmäßig wird php verwendet. </para> - <note> - <simpara> - Sie sollten TYPE nur ändern, wenn Sie wissen, was Sie tun. - </simpara> - </note> &windows.builtin; </section> Index: phpdoc-de/reference/regex/reference.xml diff -u phpdoc-de/reference/regex/reference.xml:1.7 phpdoc-de/reference/regex/reference.xml:1.8 --- phpdoc-de/reference/regex/reference.xml:1.7 Fri May 16 11:32:50 2003 +++ phpdoc-de/reference/regex/reference.xml Sat Jun 21 10:06:53 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <reference id="ref.regex"> <title>Reguläre Ausdrücke Funktionen (POSIX erweitert)</title> <titleabbrev>Regexps</titleabbrev> @@ -8,7 +8,7 @@ <partintro> <section id="regex.intro"> &reftitle.intro; - <note> + <tip> <para> Bei Verwendung der <link linkend="ref.pcre">PCRE Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit @@ -17,7 +17,7 @@ andere Merkmale, die von der POSIX-erweiterten Syntax regulärer Ausdrücke nicht unterstützt werden. </para> - </note> + </tip> <warning> <para> Diese Funktionen regulärer Ausdrücke sind im Gegensatz zu den @@ -49,6 +49,8 @@ <simpara><function>spliti</function></simpara> </listitem> </itemizedlist> + </para> + <para> Alle diese Funktionen nehmen als erstes Argument einen regulären Ausdruck an. PHP verwendet durch POSIX 1003.2 definierte POSIX erweiterte reguläre Ausdrücke. Eine vollständige Beschreibung der @@ -89,34 +91,33 @@ <title>Beispiele regulärer Ausdrücke</title> <programlisting role="php"> <![CDATA[ +<?php +// Gibt true zurück, falls "abc" irgendwo in $string gefunden wird. ereg ("abc", $string); -/* Gibt true zurück, falls "abc" - irgendwo in $string gefunden wird. */ +// Gibt true zurück, falls "abc" am Anfang von $string gefunden wird. ereg ("^abc", $string); -/* Gibt true zurück, falls "abc" - am Anfang von $string gefunden wird. */ +// Gibt true zurück, falls "abc" am Ende von $string gefunden wird. ereg ("abc$", $string); -/* Gibt true zurück, falls "abc" - am Ende von $string gefunden wird. */ +// Gibt true zurück, falls es sich beim Client Browser um Netscape 2, +// 3 oder MSIE 3 handelt. eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); -/* Gibt true zurück, falls es sich beim Client Browser - um Netscape 2, 3 oder MSIE 3 handelt. */ +// Setzt drei Wörter, die durch Leerzeichen getrennt sind, in +// $regs[1], $regs[2] und $regs[3] ein. ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); -/* Setzt drei Wörter, die durch Leerzeichen getrennt - sind, in $regs[1], $regs[2] und $regs[3] ein. */ +// Setzt ein <br /> Tag vor $string. $string = ereg_replace ("^", "<br />", $string); -/* Setzt ein <br /> Tag vor $string. */ +// Setzt ein <br /> Tag hinter $string. $string = ereg_replace ("$", "<br />", $string); -/* Setzt ein <br /> Tag hinter $string. */ +// Entfernt alle Zeilenumbrüche aus $string. $string = ereg_replace ("\n", "", $string); -/* Entfernt alle Zeilenumbrüche aus $string. */ +?> ]]> </programlisting> </example> @@ -136,7 +137,7 @@ </section> </partintro> -&reference.regex.functions; + &reference.regex.functions; </reference> <!-- Keep this comment at the end of the file Index: phpdoc-de/reference/regex/functions/ereg-replace.xml diff -u phpdoc-de/reference/regex/functions/ereg-replace.xml:1.4 phpdoc-de/reference/regex/functions/ereg-replace.xml:1.5 --- phpdoc-de/reference/regex/functions/ereg-replace.xml:1.4 Sat Mar 1 06:33:31 2003 +++ phpdoc-de/reference/regex/functions/ereg-replace.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'ereg-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.ereg-replace"> <refnamediv> @@ -11,19 +11,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>ereg_replace</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - </methodsynopsis> - <note> - <para> - Die Funktion <function>preg_replace</function>, die eine zu Perl - kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die - schnellere Alternative zu <function>ereg_replace</function>. - </para> - </note> + <methodsynopsis> + <type>string</type><methodname>ereg_replace</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + </methodsynopsis> <simpara> Diese Funktion durchsucht <parameter>Zeichenkette</parameter> nach Übereinstimmungen mit <parameter>Suchmuster</parameter> und @@ -54,6 +47,8 @@ <para> Der folgende Code-Schnipsel gibt zum Beispiel dreimal "Das war ein Test" aus: + </para> + <para> <example> <title><function>ereg_replace</function> Beispiel</title> <programlisting> @@ -73,6 +68,8 @@ daran, dass <function>ereg_replace</function> die Zahl als Ordinalwert eines Zeichens betrachtet und dieses verwendet. Zum Beispiel: + </para> + <para> <example> <title><function>ereg_replace</function> Beispiel</title> <programlisting> @@ -99,12 +96,21 @@ <title>Ersetzen von URLs durch Links</title> <programlisting role="php"> <![CDATA[ +<?php $text = ereg_replace("[[:alpha:]]+://[^<>[:space:]]+[[:alnum:]/]", "<a href=\"\\0\">\\0</a>", $text); +?> ]]> </programlisting> </example> </para> + <tip> + <para> + Die Funktion <function>preg_replace</function>, die eine zu Perl + kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die + schnellere Alternative zu <function>ereg_replace</function>. + </para> + </tip> <para> Siehe auch: <function>ereg</function>, <function>eregi</function>, <function>eregi_replace</function>, Index: phpdoc-de/reference/regex/functions/ereg.xml diff -u phpdoc-de/reference/regex/functions/ereg.xml:1.5 phpdoc-de/reference/regex/functions/ereg.xml:1.6 --- phpdoc-de/reference/regex/functions/ereg.xml:1.5 Sat Mar 1 06:33:56 2003 +++ phpdoc-de/reference/regex/functions/ereg.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'ereg' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.ereg"> <refnamediv> @@ -13,12 +13,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>ereg</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>ereg</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> + </methodsynopsis> <note> <para> Die Funktion <function>preg_match</function>, die eine zu Perl @@ -27,7 +27,8 @@ </para> </note> <simpara> - Sucht in <parameter>Zeichenkette</parameter> nach + Sucht in <parameter>Zeichenkette</parameter> unter + Berücksichtigung der Groß- und Kleinschreibung nach Übereinstimmungen mit dem regulären Ausdruck, der in <parameter>Suchmuster</parameter> angegeben wurde. </simpara> @@ -42,19 +43,18 @@ Übereinstimmung mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten <parameter>Zeichenkette</parameter>. </simpara> - <simpara> - Bis (und inklusive) PHP 4.1.0 wird <literal>$regs</literal> mit - genau zehn Elementen gefüllt, auch wenn es tatsächlich mehr oder - weniger Übereinstimmungen mit den eingeklammerten - Teilzeichenketten gibt. Dies wirkt sich aber nicht auf - <function>ereg</function>s Fähigkeit aus, mehr übereinstimmende - Teilzeichenketten zu finden. Falls keine Übereinstimmungen - gefunden werden, wird <literal>$regs</literal> nicht von - <function>ereg</function> verändert. - </simpara> - <simpara> - Die Suche unterscheidet zwischen Groß und Kleinschreibung. - </simpara> + <note> + <simpara> + Bis (und inklusive) PHP 4.1.0 wird <literal>$regs</literal> mit + genau zehn Elementen gefüllt, auch wenn es tatsächlich mehr oder + weniger Übereinstimmungen mit den eingeklammerten + Teilzeichenketten gibt. Dies wirkt sich aber nicht auf + <function>ereg</function>s Fähigkeit aus, mehr übereinstimmende + Teilzeichenketten zu finden. Falls keine Übereinstimmungen + gefunden werden, wird <literal>$regs</literal> nicht von + <function>ereg</function> verändert. + </simpara> + </note> <simpara> Gibt &true; zurück, wenn in <parameter>Zeichenkette</parameter> eine Übereinstimmung mit <parameter>Suchmuster</parameter> @@ -64,6 +64,8 @@ <para> Der folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) und gibt es im Format TT.MM.JJJJ aus: + </para> + <para> <example> <title><function>ereg</function> Beispiel</title> <programlisting role="php"> Index: phpdoc-de/reference/regex/functions/eregi-replace.xml diff -u phpdoc-de/reference/regex/functions/eregi-replace.xml:1.3 phpdoc-de/reference/regex/functions/eregi-replace.xml:1.4 --- phpdoc-de/reference/regex/functions/eregi-replace.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/eregi-replace.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'eregi-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.eregi-replace"> <refnamediv> @@ -14,12 +14,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>eregi_replace</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>eregi_replace</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Ersatz</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>ereg_replace</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Index: phpdoc-de/reference/regex/functions/eregi.xml diff -u phpdoc-de/reference/regex/functions/eregi.xml:1.4 phpdoc-de/reference/regex/functions/eregi.xml:1.5 --- phpdoc-de/reference/regex/functions/eregi.xml:1.4 Thu Feb 20 11:21:34 2003 +++ phpdoc-de/reference/regex/functions/eregi.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'eregi' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.eregi"> <refnamediv> @@ -14,16 +14,18 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>bool</type><methodname>eregi</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>eregi</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>regs</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>ereg</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. + </para> + <para> <example> <title><function>eregi</function> Beispiel</title> <programlisting role="php"> Index: phpdoc-de/reference/regex/functions/split.xml diff -u phpdoc-de/reference/regex/functions/split.xml:1.5 phpdoc-de/reference/regex/functions/split.xml:1.6 --- phpdoc-de/reference/regex/functions/split.xml:1.5 Mon Aug 26 11:30:59 2002 +++ phpdoc-de/reference/regex/functions/split.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.8 --> <!-- last change to 'split' in en/ tree in rev 1.7 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.7 --> <refentry id="function.split"> <refnamediv> @@ -14,25 +14,30 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>array</type><methodname>split</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> - </methodsynopsis> - <note> + <methodsynopsis> + <type>array</type><methodname>split</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> + </methodsynopsis> + <tip> <para> Die Funktion <function>preg_split</function>, die eine zu Perl kompatible Syntax regulärer Ausdrücke verwendet, ist häufig die - schnellere Alternative zu <function>split</function>. + schnellere Alternative zu <function>split</function>. Wenn Sie + die Fähigkeiten regulärer Ausdrücke nicht benötigen, ist die + Verwendung von <function>explode</function> schneller, weil + diese Funktion nicht unter der Last der Engine für reguläre + Ausdrücke steht. </para> - </note> + </tip> <para> Gibt ein Array mit Zeichenketten zurück, die jeweils eine - Teilzeichenkette von <parameter>Zeichenkette</parameter> sind und - durch deren Zerlegung an den durch - <parameter>Suchmuster</parameter> des regulären Ausdrucks - bestimmten Stellen entstehen. Wenn + Teilzeichenkette von <parameter>Zeichenkette</parameter> sind. + Diese Teilzeichenketten entstehen durch Zerlegung von + <parameter>Zeichenkette</parameter> an den durch + <parameter>Suchmuster</parameter> des Groß- und Kleinschreibung + berücksichtigenden regulären Ausdrucks bestimmten Stellen. Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das zurückgegebene Array höchstens <parameter>Beschränkung</parameter> Elemente, von denen das @@ -43,53 +48,50 @@ <para> Um die ersten vier Felder einer Zeile von <filename>/etc/passwd</filename> abzuspalten: + </para> + <para> <example> <title><function>split</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -list($user,$pass,$uid,$gid,$extra)= split (":", $passwd_line, 5); +<?php +list($user, $pass, $uid, $gid, $extra) = + split (":", $passwd_line, 5); +?> ]]> </programlisting> </example> </para> - <note> - <simpara> - Wenn <parameter>Suchmuster</parameter> - <replaceable>n</replaceable> mal vorkommt, enhält das - zurückgegebene Array - <literal><replaceable>n</replaceable>+1</literal> Elemente. - Kommt <parameter>Suchmuster</parameter> zum Beispiel überhaupt - nicht vor, wird ein Array mit nur einem Element zurückgegeben. - Das gilt natürlich auch, wenn - <parameter>Zeichenkette</parameter> leer ist. - </simpara> - </note> + <simpara> + Wenn <parameter>Suchmuster</parameter> + <replaceable>n</replaceable> mal vorkommt, enhält das + zurückgegebene Array + <literal><replaceable>n</replaceable>+1</literal> Elemente. Kommt + <parameter>Suchmuster</parameter> zum Beispiel überhaupt nicht + vor, wird ein Array mit nur einem Element zurückgegeben. Das gilt + natürlich auch, wenn <parameter>Zeichenkette</parameter> leer + ist. + </simpara> <para> Um ein Datum zu analysieren, das durch Schrägstriche, Punkte oder Bindestriche getrennt ist: + </para> + <para> <example> <title><function>split</function> Beispiel</title> <programlisting role="php"> <![CDATA[ -$datum = "04/30/1973"; // Trennzeichen darf ein Schrägstrich, Punkt - // oder Bindestrich sein +<?php +// Trennzeichen darf ein Schrägstrich, Punkt oder Bindestrich sein +$datum = "04/30/1973"; list ($monat, $tag, $jahr) = split ('[/.-]', $datum); -echo "Monat: $monat; Tag: $tag; Jahr: $jahr<br>\n"; +echo "Monat: $monat; Tag: $tag; Jahr: $jahr<br />\n"; +?> ]]> </programlisting> </example> </para> <para> - Beachten Sie, dass <parameter>Suchmuster</parameter> Groß- und - Kleinschreibung berücksichtigt. - </para> - <para> - Beachten Sie: wenn Sie die Fähigkeiten regulärer Ausdrücke nicht - benötigen, ist die Verwendung von <function>explode</function> - schneller, weil diese Funktion nicht unter der Last der Engine - für reguläre Ausdrücke steht. - </para> - <para> Wenn Sie nach einer Möglichkeit suchen, das Verhalten von Perls <command>@chars = split('', $str)</command> nachzuahmen, schauen Sie sich bitte die Beispiele für <function>preg_split</function> @@ -104,9 +106,9 @@ <function>split</function> (oder, bei diesem Thema, eine andere Regex-Funktion) verhalte sich seltsam, lesen Sie bitte die Datei <filename>regex.7</filename>, die sich im - <filename class="directory">regex/</filename> Unterverzeichnis ihrer - PHP-Distribution befindet. Da sie im manpage-Fomat vorliegt, - sollten Sie einen Befehl der Art <command>man + <filename class="directory">regex/</filename> Unterverzeichnis + ihrer PHP-Distribution befindet. Da sie im manpage-Fomat + vorliegt, sollten Sie einen Befehl der Art <command>man /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. </para> Index: phpdoc-de/reference/regex/functions/spliti.xml diff -u phpdoc-de/reference/regex/functions/spliti.xml:1.3 phpdoc-de/reference/regex/functions/spliti.xml:1.4 --- phpdoc-de/reference/regex/functions/spliti.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/spliti.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'spliti' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.spliti"> <refnamediv> @@ -14,12 +14,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - <methodsynopsis> - <type>array</type><methodname>spliti</methodname> - <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> - <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>spliti</methodname> + <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> + <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> + </methodsynopsis> <para> Diese Funktion entspricht <function>split</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Index: phpdoc-de/reference/regex/functions/sql-regcase.xml diff -u phpdoc-de/reference/regex/functions/sql-regcase.xml:1.3 phpdoc-de/reference/regex/functions/sql-regcase.xml:1.4 --- phpdoc-de/reference/regex/functions/sql-regcase.xml:1.3 Sun Jun 9 06:56:09 2002 +++ phpdoc-de/reference/regex/functions/sql-regcase.xml Sat Jun 21 10:06:53 2003 @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./de/functions/regex.xml, last change in rev 1.2 --> <!-- last change to 'sql-regcase' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- OLD-Revision: 1.39/EN.1.2 --> <refentry id="function.sql-regcase"> <refnamediv> @@ -26,15 +26,22 @@ Klammerausdruck umgewandelt wird. Die Klammer enthält dieses Zeichen, wenn möglich, in groß- und kleingeschriebener Form, andernfalls enthält sie das ursprüngliche Zeichen zweimal. + </para> + <para> <example> <title><function>sql_regcase</function> Beispiel</title> <programlisting role="php"> <![CDATA[ +<?php echo sql_regcase ("Foo bar"); +?> ]]> </programlisting> + <para> + Ausgabe: + </para> + <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen> </example> - Gibt <screen>[Ff][Oo][Oo] [Bb][Aa][Rr]</screen> aus. </para> <para> Dies kann bei Produkten, die nur reguläre Ausdrücke mit