cvs: phpdoc-de /reference/regex/functions ereg-replace.xml ereg.xml eregi-replace.xml eregi.xml split.xml spliti.xml sql-regcase.xml
| From: | Martin Samesch | Date: | Sun, 05 Aug 2007 12:48:53 +0000 |
| Subject: | cvs: phpdoc-de /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-2210@lists.php.net to get a copy of this message | ||
samesch Sun Aug 5 12:48:53 2007 UTC
Modified files:
/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
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/ereg-replace.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/regex/functions/ereg-replace.xml diff -u phpdoc-de/reference/regex/functions/ereg-replace.xml:1.9 phpdoc-de/reference/regex/functions/ereg-replace.xml:1.10 --- phpdoc-de/reference/regex/functions/ereg-replace.xml:1.9 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/ereg-replace.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.ereg-replace" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>ereg_replace</refname> <refpurpose>Ersetzt einen regulären Ausdruck</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>ereg_replace</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,26 +20,58 @@ Übereinstimmungen mit <parameter>Suchmuster</parameter> und ersetzt dann den übereinstimmenden Text durch <parameter>Ersatz</parameter>. </simpara> - <simpara> - Zurückgegeben wird die geänderte Zeichenkette, was auch bedeuten könnte, - dass die ursprüngliche Zeichenkette zurückgegeben wird, wenn es keine zu - ersetzenden Übereinstimmungen gibt. - </simpara> - <simpara> - Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten - enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form - <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die dann - durch die Ziffer'ste Teilzeichenkette ersetzt werden. - <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten - Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. - Klammern dürfen geschachtelt werden und werden in diesem Fall anhand der - öffnenden Klammern gezählt. - </simpara> - <simpara> - Wenn in <parameter>Zeichenkette</parameter> keine Übereinstimmungen - gefunden werden, wird <parameter>Zeichenkette</parameter> unverändert - zurückgegeben. - </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Ein POSIX-erweiterter regulärer Ausdruck + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Ersatz</parameter></term> + <listitem> + <para> + Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten + enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form + <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die + dann durch die Ziffer'ste Teilzeichenkette ersetzt werden. + <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten + Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. + Klammern dürfen geschachtelt werden und werden in diesem Fall anhand + der öffnenden Klammern gezählt. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird die geänderte Zeichenkette. Wenn in + <parameter>Zeichenkette</parameter> keine Übereinstimmungen gefunden + werden, wird sie unverändert zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> Der folgende Code-Schnipsel gibt zum Beispiel dreimal "Das war ein Test" aus: @@ -105,6 +135,10 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <tip> <para> Die Funktion <function>preg_replace</function>, die eine zu Perl @@ -112,12 +146,21 @@ Alternative zu <function>ereg_replace</function>. </para> </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>ereg</function>, <function>eregi</function>, - <function>eregi_replace</function>, <function>str_replace</function> und - <function>preg_match</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>eregi</function></member> + <member><function>eregi_replace</function></member> + <member><function>str_replace</function></member> + <member><function>preg_match</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/ereg.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-de/reference/regex/functions/ereg.xml diff -u phpdoc-de/reference/regex/functions/ereg.xml:1.12 phpdoc-de/reference/regex/functions/ereg.xml:1.13 --- phpdoc-de/reference/regex/functions/ereg.xml:1.12 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/ereg.xml Sun Aug 5 12:48:53 2007 @@ -1,71 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- 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.13 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> <refentry xml:id="function.ereg" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>ereg</refname> <refpurpose>Sucht Übereinstimmungen mit einem regulären Ausdruck</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</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 role="reference">regs</parameter></methodparam> </methodsynopsis> - <note> - <para> - Die Funktion <function>preg_match</function>, die eine zu Perl kompatible - Syntax regulärer Ausdrücke verwendet, ist häufig die schnellere - Alternative zu <function>ereg</function>. - </para> - </note> <simpara> 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> - <simpara> - Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von - <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit dem - dritten Argument <parameter>regs</parameter> aufgerufen wurde, werden die - Übereinstimmungen in den Elementen des Arrays <parameter>regs</parameter> - gespeichert. $regs[1] enthält dann die Teilzeichenkette der ersten Klammer, - $regs[2] die Teilzeichenkette der zweiten usw. $regs[0] enthält bei - Übereinstimmung mit <parameter>Zeichenkette</parameter> eine Kopie der - kompletten <parameter>Zeichenkette</parameter>. - </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> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck mit Berücksichtigung der Groß- und Kleinschreibung + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>regs</parameter></term> + <listitem> + <para> + Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von + <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit + dem dritten Argument <parameter>regs</parameter> aufgerufen wurde, + werden die Übereinstimmungen in den Elementen des Arrays + <parameter>regs</parameter> gespeichert. + </para> + <para> + $regs[1] enthält die Teilzeichenkette der ersten Klammer, $regs[2] die + Teilzeichenkette der zweiten usw. $regs[0] enthält bei Übereinstimmung + mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten + <parameter>Zeichenkette</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> Gibt die Länge der übereinstimmenden Zeichenkette zurück, falls in <parameter>Zeichenkette</parameter> eine Übereinstimmung mit <parameter>Suchmuster</parameter> gefunden wurde oder &false;, wenn keine - Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. Falls - der optionale Parameter <parameter>regs</parameter> nicht übergeben wurde - oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese - Funktion 1 zurück. - </simpara> + Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. + </para> <para> - Der folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) und - gibt es im Format TT.MM.JJJJ aus: + Falls der optionale Parameter <parameter>regs</parameter> nicht übergeben + wurde oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese + Funktion 1 zurück. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>ereg</function> Beispiel</title> + <para> + Das folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) + und gibt es im Format TT.MM.JJJJ aus: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -79,12 +101,44 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Die Funktion <function>preg_match</function>, die eine zu Perl kompatible + Syntax regulärer Ausdrücke verwendet, ist häufig die schnellere + Alternative zu <function>ereg</function>. + </para> + </note> + <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> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>eregi</function>, <function>ereg_replace</function>, - <function>eregi_replace</function>, <function>preg_match</function>, - <function>strpos</function> und <function>strstr</function>. + <simplelist> + <member><function>eregi</function></member> + <member><function>ereg_replace</function></member> + <member><function>eregi_replace</function></member> + <member><function>preg_match</function></member> + <member><function>strpos</function></member> + <member><function>strstr</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/eregi-replace.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/regex/functions/eregi-replace.xml diff -u phpdoc-de/reference/regex/functions/eregi-replace.xml:1.8 phpdoc-de/reference/regex/functions/eregi-replace.xml:1.9 --- phpdoc-de/reference/regex/functions/eregi-replace.xml:1.8 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/eregi-replace.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.eregi-replace" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eregi_replace</refname> <refpurpose>Ersetzt einen regulären Ausdrück ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>eregi_replace</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,6 +20,58 @@ Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Ein POSIX-erweiterter regulärer Ausdruck + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Ersatz</parameter></term> + <listitem> + <para> + Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten + enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form + <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die + dann durch die Ziffer'ste Teilzeichenkette ersetzt werden. + <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten + Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. + Klammern dürfen geschachtelt werden und werden in diesem Fall anhand + der öffnenden Klammern gezählt. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird die geänderte Zeichenkette. Wenn in + <parameter>Zeichenkette</parameter> keine Übereinstimmungen gefunden + werden, wird sie unverändert zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>Suchergebnisse hervorheben</title> @@ -36,11 +86,19 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>ereg</function>, <function>eregi</function> und - <function>ereg_replace</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>eregi</function></member> + <member><function>ereg_replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/eregi.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/regex/functions/eregi.xml diff -u phpdoc-de/reference/regex/functions/eregi.xml:1.10 phpdoc-de/reference/regex/functions/eregi.xml:1.11 --- phpdoc-de/reference/regex/functions/eregi.xml:1.10 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/eregi.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- 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.10 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.eregi" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eregi</refname> <refpurpose>Sucht Übereinstimmung mit regulärem Ausdruck ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</type><methodname>eregi</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,6 +20,67 @@ dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>regs</parameter></term> + <listitem> + <para> + Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von + <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit + dem dritten Argument <parameter>regs</parameter> aufgerufen wurde, + werden die Übereinstimmungen in den Elementen des Arrays + <parameter>regs</parameter> gespeichert. + </para> + <para> + $regs[1] enthält die Teilzeichenkette der ersten Klammer, $regs[2] die + Teilzeichenkette der zweiten usw. $regs[0] enthält bei Übereinstimmung + mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten + <parameter>Zeichenkette</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge der übereinstimmenden Zeichenkette zurück, falls in + <parameter>Zeichenkette</parameter> eine Übereinstimmung mit + <parameter>Suchmuster</parameter> gefunden wurde oder &false;, wenn keine + Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. + </para> + <para> + Falls der optionale Parameter <parameter>regs</parameter> nicht übergeben + wurde oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese + Funktion 1 zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>eregi</function> Beispiel</title> @@ -37,12 +96,21 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>ereg</function>, <function>ereg_replace</function>, - <function>eregi_replace</function>, <function>stripos</function> und - <function>stristr</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>ereg_replace</function></member> + <member><function>eregi_replace</function></member> + <member><function>stripos</function></member> + <member><function>stristr</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/split.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/regex/functions/split.xml diff -u phpdoc-de/reference/regex/functions/split.xml:1.11 phpdoc-de/reference/regex/functions/split.xml:1.12 --- phpdoc-de/reference/regex/functions/split.xml:1.11 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/split.xml Sun Aug 5 12:48:53 2007 @@ -1,51 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.7 --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.split" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>split</refname> <refpurpose>Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks in ein Array</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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>. 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> - </tip> + <para> + Zerlegt <parameter>Zeichenkette</parameter> anhand eines regulären + Ausdrucks in ein Array. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck mit Berücksichtigung der Groß- und Kleinschreibung + </para> + <para> + Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären + Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese + entsprechend kennzeichnen. Wenn Sie der Ansicht sind, + <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 + /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Beschränkung</parameter></term> + <listitem> + <para> + Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das + zurückgegebene Array höchstens <parameter>Beschränkung</parameter> + Elemente, von denen das letzte den ganzen Rest von + <parameter>Zeichenkette</parameter> enthält. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> Gibt ein Array mit Zeichenketten zurück, die jeweils eine 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 letzte den ganzen Rest von - <parameter>Zeichenkette</parameter> enthält. Bei Auftreten eines Fehlers - gibt <function>split</function> &false; zurück. + durch den regulären Ausdruck <parameter>Suchmuster</parameter> bestimmten + Stellen unter Berücksichtigung der Groß- und Kleinschreibung. </para> <para> - Um die ersten vier Felder einer Zeile von <filename>/etc/passwd</filename> - abzuspalten: + 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. Bei Auftreten eines + Fehlers gibt <function>split</function> &false; zurück. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>split</function> Beispiel</title> + <para> + Um die ersten vier Felder einer Zeile von + <filename>/etc/passwd</filename> abzuspalten: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -56,21 +107,13 @@ </programlisting> </example> </para> - <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> + <para> + Um ein Datum zu analysieren, das durch Schrägstriche, Punkte oder + Bindestriche getrennt ist: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -83,33 +126,45 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <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>. 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> + </tip> + <tip> + <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> oder + <function>str_split</function> an. + </para> + </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <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> oder - <function>str_split</function> an. - </para> - <para> - Bitte beachten Sie, dass <parameter>Suchmuster</parameter> ein regulärer - Ausdruck ist. Wenn Sie eine Zerlegung an Zeichen vornehmen, die in - regulären Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie - diese entsprechend kennzeichnen. Wenn Sie der Ansicht sind, - <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 - /usr/local/src/regex/regex.7</command> verwenden, um sie zu - lesen. - </para> - <para> - Siehe auch <function>preg_split</function>, <function>spliti</function>, - <function>str_split</function>, <function>explode</function>, - <function>implode</function>, <function>chunk_split</function> und - <function>wordwrap</function>. + <simplelist> + <member><function>preg_split</function></member> + <member><function>spliti</function></member> + <member><function>str_split</function></member> + <member><function>explode</function></member> + <member><function>implode</function></member> + <member><function>chunk_split</function></member> + <member><function>wordwrap</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/spliti.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/regex/functions/spliti.xml diff -u phpdoc-de/reference/regex/functions/spliti.xml:1.8 phpdoc-de/reference/regex/functions/spliti.xml:1.9 --- phpdoc-de/reference/regex/functions/spliti.xml:1.8 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/spliti.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> <refentry xml:id="function.spliti" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>spliti</refname> <refpurpose>Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks ohne Berücksichtigung von Groß-/Kleinschreibung in ein Array</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>array</type><methodname>spliti</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -18,10 +16,85 @@ <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> </methodsynopsis> <para> + Zerlegt <parameter>Zeichenkette</parameter> anhand eines regulären + Ausdrucks in ein Array. + </para> + <para> Diese Funktion entspricht <function>split</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung + </para> + <para> + Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären + Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese + entsprechend kennzeichnen. Wenn Sie der Ansicht sind, + <function>spliti</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 + /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Beschränkung</parameter></term> + <listitem> + <para> + Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das + zurückgegebene Array höchstens <parameter>Beschränkung</parameter> + Elemente, von denen das letzte den ganzen Rest von + <parameter>Zeichenkette</parameter> enthält. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein Array mit Zeichenketten zurück, die jeweils eine Teilzeichenkette + von <parameter>Zeichenkette</parameter> sind. Diese Teilzeichenketten + entstehen durch Zerlegung von <parameter>Zeichenkette</parameter> an den + durch den regulären Ausdruck <parameter>Suchmuster</parameter> bestimmten + Stellen ohne Berücksichtigung der Groß- und Kleinschreibung. + </para> + <para> + 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. Bei Auftreten eines + Fehlers gibt <function>spliti</function> &false; zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> Dieses Beispiel verwendet 'a' als Trennzeichen um eine Zeichenkette zu zerlegen: @@ -51,11 +124,20 @@ </screen> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>preg_split</function>, <function>split</function>, - <function>explode</function> und <function>implode</function>. + <simplelist> + <member><function>preg_split</function></member> + <member><function>split</function></member> + <member><function>explode</function></member> + <member><function>implode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/sql-regcase.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/regex/functions/sql-regcase.xml diff -u phpdoc-de/reference/regex/functions/sql-regcase.xml:1.9 phpdoc-de/reference/regex/functions/sql-regcase.xml:1.10 --- phpdoc-de/reference/regex/functions/sql-regcase.xml:1.9 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/sql-regcase.xml Sun Aug 5 12:48:53 2007 @@ -1,28 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.sql-regcase" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>sql_regcase</refname> <refpurpose>Erstellt einen regulären Ausdruck für eine Suche nach Übereinstimmungen ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>sql_regcase</methodname> <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> </methodsynopsis> <para> - Gibt einen korrekten regulären Ausdruck zurück, der mit + Erstellt einen regulären Ausdruck für eine Suche nach Übereinstimmungen + ohne Berücksichtigung von Groß- und Kleinschreibung. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die umzuwandelnde Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen korrekten regulären Ausdruck zurück, der auf <parameter>Zeichenkette</parameter> ohne Berücksichtigung von - Groß-/Kleinschreibung übereinstimmt. Dieser Ausdruck entspricht + Groß- und Kleinschreibung passt. Dieser Ausdruck entspricht <parameter>Zeichenkette</parameter>, wobei jeder Buchstabe in einen Klammerausdruck umgewandelt wird. Die Klammer enthält diesen Buchstaben in groß- und kleingeschriebener Form. Andere Zeichen bleiben unverändert. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>sql_regcase</function> Beispiel</title> @@ -43,11 +69,12 @@ </para> <para> Dies kann bei Produkten, die nur reguläre Ausdrücke mit Berücksichtigung - von Groß-/Kleinschreibung unterstützen, verwendet werden, um eine + von Groß- und Kleinschreibung unterstützen, verwendet werden, um eine Übereinstimmung mit Suchmustern ohne Berücksichtigung von - Groß-/Kleinschreibung zu erreichen. + Groß- und Kleinschreibung zu erreichen. </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/ereg-replace.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/regex/functions/ereg-replace.xml diff -u phpdoc-de/reference/regex/functions/ereg-replace.xml:1.9 phpdoc-de/reference/regex/functions/ereg-replace.xml:1.10 --- phpdoc-de/reference/regex/functions/ereg-replace.xml:1.9 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/ereg-replace.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.ereg-replace" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>ereg_replace</refname> <refpurpose>Ersetzt einen regulären Ausdruck</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>ereg_replace</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,26 +20,58 @@ Übereinstimmungen mit <parameter>Suchmuster</parameter> und ersetzt dann den übereinstimmenden Text durch <parameter>Ersatz</parameter>. </simpara> - <simpara> - Zurückgegeben wird die geänderte Zeichenkette, was auch bedeuten könnte, - dass die ursprüngliche Zeichenkette zurückgegeben wird, wenn es keine zu - ersetzenden Übereinstimmungen gibt. - </simpara> - <simpara> - Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten - enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form - <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die dann - durch die Ziffer'ste Teilzeichenkette ersetzt werden. - <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten - Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. - Klammern dürfen geschachtelt werden und werden in diesem Fall anhand der - öffnenden Klammern gezählt. - </simpara> - <simpara> - Wenn in <parameter>Zeichenkette</parameter> keine Übereinstimmungen - gefunden werden, wird <parameter>Zeichenkette</parameter> unverändert - zurückgegeben. - </simpara> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Ein POSIX-erweiterter regulärer Ausdruck + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Ersatz</parameter></term> + <listitem> + <para> + Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten + enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form + <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die + dann durch die Ziffer'ste Teilzeichenkette ersetzt werden. + <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten + Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. + Klammern dürfen geschachtelt werden und werden in diesem Fall anhand + der öffnenden Klammern gezählt. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird die geänderte Zeichenkette. Wenn in + <parameter>Zeichenkette</parameter> keine Übereinstimmungen gefunden + werden, wird sie unverändert zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> Der folgende Code-Schnipsel gibt zum Beispiel dreimal "Das war ein Test" aus: @@ -105,6 +135,10 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <tip> <para> Die Funktion <function>preg_replace</function>, die eine zu Perl @@ -112,12 +146,21 @@ Alternative zu <function>ereg_replace</function>. </para> </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>ereg</function>, <function>eregi</function>, - <function>eregi_replace</function>, <function>str_replace</function> und - <function>preg_match</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>eregi</function></member> + <member><function>eregi_replace</function></member> + <member><function>str_replace</function></member> + <member><function>preg_match</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/ereg.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-de/reference/regex/functions/ereg.xml diff -u phpdoc-de/reference/regex/functions/ereg.xml:1.12 phpdoc-de/reference/regex/functions/ereg.xml:1.13 --- phpdoc-de/reference/regex/functions/ereg.xml:1.12 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/ereg.xml Sun Aug 5 12:48:53 2007 @@ -1,71 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- 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.13 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> <refentry xml:id="function.ereg" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>ereg</refname> <refpurpose>Sucht Übereinstimmungen mit einem regulären Ausdruck</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</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 role="reference">regs</parameter></methodparam> </methodsynopsis> - <note> - <para> - Die Funktion <function>preg_match</function>, die eine zu Perl kompatible - Syntax regulärer Ausdrücke verwendet, ist häufig die schnellere - Alternative zu <function>ereg</function>. - </para> - </note> <simpara> 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> - <simpara> - Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von - <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit dem - dritten Argument <parameter>regs</parameter> aufgerufen wurde, werden die - Übereinstimmungen in den Elementen des Arrays <parameter>regs</parameter> - gespeichert. $regs[1] enthält dann die Teilzeichenkette der ersten Klammer, - $regs[2] die Teilzeichenkette der zweiten usw. $regs[0] enthält bei - Übereinstimmung mit <parameter>Zeichenkette</parameter> eine Kopie der - kompletten <parameter>Zeichenkette</parameter>. - </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> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck mit Berücksichtigung der Groß- und Kleinschreibung + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>regs</parameter></term> + <listitem> + <para> + Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von + <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit + dem dritten Argument <parameter>regs</parameter> aufgerufen wurde, + werden die Übereinstimmungen in den Elementen des Arrays + <parameter>regs</parameter> gespeichert. + </para> + <para> + $regs[1] enthält die Teilzeichenkette der ersten Klammer, $regs[2] die + Teilzeichenkette der zweiten usw. $regs[0] enthält bei Übereinstimmung + mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten + <parameter>Zeichenkette</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> Gibt die Länge der übereinstimmenden Zeichenkette zurück, falls in <parameter>Zeichenkette</parameter> eine Übereinstimmung mit <parameter>Suchmuster</parameter> gefunden wurde oder &false;, wenn keine - Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. Falls - der optionale Parameter <parameter>regs</parameter> nicht übergeben wurde - oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese - Funktion 1 zurück. - </simpara> + Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. + </para> <para> - Der folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) und - gibt es im Format TT.MM.JJJJ aus: + Falls der optionale Parameter <parameter>regs</parameter> nicht übergeben + wurde oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese + Funktion 1 zurück. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>ereg</function> Beispiel</title> + <para> + Das folgende Code-Schnipsel mimmt ein Datum im ISO-Format (JJJJ-MM-TT) + und gibt es im Format TT.MM.JJJJ aus: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -79,12 +101,44 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Die Funktion <function>preg_match</function>, die eine zu Perl kompatible + Syntax regulärer Ausdrücke verwendet, ist häufig die schnellere + Alternative zu <function>ereg</function>. + </para> + </note> + <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> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>eregi</function>, <function>ereg_replace</function>, - <function>eregi_replace</function>, <function>preg_match</function>, - <function>strpos</function> und <function>strstr</function>. + <simplelist> + <member><function>eregi</function></member> + <member><function>ereg_replace</function></member> + <member><function>eregi_replace</function></member> + <member><function>preg_match</function></member> + <member><function>strpos</function></member> + <member><function>strstr</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/eregi-replace.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/regex/functions/eregi-replace.xml diff -u phpdoc-de/reference/regex/functions/eregi-replace.xml:1.8 phpdoc-de/reference/regex/functions/eregi-replace.xml:1.9 --- phpdoc-de/reference/regex/functions/eregi-replace.xml:1.8 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/eregi-replace.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.eregi-replace" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eregi_replace</refname> <refpurpose>Ersetzt einen regulären Ausdrück ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>eregi_replace</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,6 +20,58 @@ Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Ein POSIX-erweiterter regulärer Ausdruck + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Ersatz</parameter></term> + <listitem> + <para> + Wenn <parameter>Suchmuster</parameter> eingeklammerte Teilzeichenketten + enthält, darf <parameter>Ersatz</parameter> Teilzeichenketten der Form + <literal>\\<replaceable>Ziffer</replaceable></literal> enthalten, die + dann durch die Ziffer'ste Teilzeichenkette ersetzt werden. + <literal>\\0</literal> erzeugt den gesamten Inhalt der durchsuchten + Zeichenkette. Bis zu neun Teilzeichenketten dürfen verwendet werden. + Klammern dürfen geschachtelt werden und werden in diesem Fall anhand + der öffnenden Klammern gezählt. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Zurückgegeben wird die geänderte Zeichenkette. Wenn in + <parameter>Zeichenkette</parameter> keine Übereinstimmungen gefunden + werden, wird sie unverändert zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>Suchergebnisse hervorheben</title> @@ -36,11 +86,19 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>ereg</function>, <function>eregi</function> und - <function>ereg_replace</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>eregi</function></member> + <member><function>ereg_replace</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/eregi.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/regex/functions/eregi.xml diff -u phpdoc-de/reference/regex/functions/eregi.xml:1.10 phpdoc-de/reference/regex/functions/eregi.xml:1.11 --- phpdoc-de/reference/regex/functions/eregi.xml:1.10 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/eregi.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- 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.10 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.eregi" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eregi</refname> <refpurpose>Sucht Übereinstimmung mit regulärem Ausdruck ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</type><methodname>eregi</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -22,6 +20,67 @@ dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>regs</parameter></term> + <listitem> + <para> + Wenn Übereinstimmungen mit eingeklammerten Teilzeichenketten von + <parameter>Suchmuster</parameter> gefunden werden und die Funktion mit + dem dritten Argument <parameter>regs</parameter> aufgerufen wurde, + werden die Übereinstimmungen in den Elementen des Arrays + <parameter>regs</parameter> gespeichert. + </para> + <para> + $regs[1] enthält die Teilzeichenkette der ersten Klammer, $regs[2] die + Teilzeichenkette der zweiten usw. $regs[0] enthält bei Übereinstimmung + mit <parameter>Zeichenkette</parameter> eine Kopie der kompletten + <parameter>Zeichenkette</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge der übereinstimmenden Zeichenkette zurück, falls in + <parameter>Zeichenkette</parameter> eine Übereinstimmung mit + <parameter>Suchmuster</parameter> gefunden wurde oder &false;, wenn keine + Übereinstimmung gefunden wurde oder wenn ein Fehler aufgetreten ist. + </para> + <para> + Falls der optionale Parameter <parameter>regs</parameter> nicht übergeben + wurde oder die Länge der übereinstimmenden Zeichenkette 0 ist, gibt diese + Funktion 1 zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>eregi</function> Beispiel</title> @@ -37,12 +96,21 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>ereg</function>, <function>ereg_replace</function>, - <function>eregi_replace</function>, <function>stripos</function> und - <function>stristr</function>. + <simplelist> + <member><function>ereg</function></member> + <member><function>ereg_replace</function></member> + <member><function>eregi_replace</function></member> + <member><function>stripos</function></member> + <member><function>stristr</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/split.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/regex/functions/split.xml diff -u phpdoc-de/reference/regex/functions/split.xml:1.11 phpdoc-de/reference/regex/functions/split.xml:1.12 --- phpdoc-de/reference/regex/functions/split.xml:1.11 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/split.xml Sun Aug 5 12:48:53 2007 @@ -1,51 +1,102 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.7 --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.split" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>split</refname> <refpurpose>Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks in ein Array</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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>. 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> - </tip> + <para> + Zerlegt <parameter>Zeichenkette</parameter> anhand eines regulären + Ausdrucks in ein Array. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck mit Berücksichtigung der Groß- und Kleinschreibung + </para> + <para> + Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären + Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese + entsprechend kennzeichnen. Wenn Sie der Ansicht sind, + <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 + /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Beschränkung</parameter></term> + <listitem> + <para> + Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das + zurückgegebene Array höchstens <parameter>Beschränkung</parameter> + Elemente, von denen das letzte den ganzen Rest von + <parameter>Zeichenkette</parameter> enthält. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> Gibt ein Array mit Zeichenketten zurück, die jeweils eine 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 letzte den ganzen Rest von - <parameter>Zeichenkette</parameter> enthält. Bei Auftreten eines Fehlers - gibt <function>split</function> &false; zurück. + durch den regulären Ausdruck <parameter>Suchmuster</parameter> bestimmten + Stellen unter Berücksichtigung der Groß- und Kleinschreibung. </para> <para> - Um die ersten vier Felder einer Zeile von <filename>/etc/passwd</filename> - abzuspalten: + 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. Bei Auftreten eines + Fehlers gibt <function>split</function> &false; zurück. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>split</function> Beispiel</title> + <para> + Um die ersten vier Felder einer Zeile von + <filename>/etc/passwd</filename> abzuspalten: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -56,21 +107,13 @@ </programlisting> </example> </para> - <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> + <para> + Um ein Datum zu analysieren, das durch Schrägstriche, Punkte oder + Bindestriche getrennt ist: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -83,33 +126,45 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <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>. 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> + </tip> + <tip> + <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> oder + <function>str_split</function> an. + </para> + </tip> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <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> oder - <function>str_split</function> an. - </para> - <para> - Bitte beachten Sie, dass <parameter>Suchmuster</parameter> ein regulärer - Ausdruck ist. Wenn Sie eine Zerlegung an Zeichen vornehmen, die in - regulären Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie - diese entsprechend kennzeichnen. Wenn Sie der Ansicht sind, - <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 - /usr/local/src/regex/regex.7</command> verwenden, um sie zu - lesen. - </para> - <para> - Siehe auch <function>preg_split</function>, <function>spliti</function>, - <function>str_split</function>, <function>explode</function>, - <function>implode</function>, <function>chunk_split</function> und - <function>wordwrap</function>. + <simplelist> + <member><function>preg_split</function></member> + <member><function>spliti</function></member> + <member><function>str_split</function></member> + <member><function>explode</function></member> + <member><function>implode</function></member> + <member><function>chunk_split</function></member> + <member><function>wordwrap</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/spliti.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/regex/functions/spliti.xml diff -u phpdoc-de/reference/regex/functions/spliti.xml:1.8 phpdoc-de/reference/regex/functions/spliti.xml:1.9 --- phpdoc-de/reference/regex/functions/spliti.xml:1.8 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/spliti.xml Sun Aug 5 12:48:53 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> <refentry xml:id="function.spliti" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>spliti</refname> <refpurpose>Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks ohne Berücksichtigung von Groß-/Kleinschreibung in ein Array</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>array</type><methodname>spliti</methodname> <methodparam><type>string</type><parameter>Suchmuster</parameter></methodparam> @@ -18,10 +16,85 @@ <methodparam choice="opt"><type>int</type><parameter>Beschränkung</parameter></methodparam> </methodsynopsis> <para> + Zerlegt <parameter>Zeichenkette</parameter> anhand eines regulären + Ausdrucks in ein Array. + </para> + <para> Diese Funktion entspricht <function>split</function> mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Suchmuster</parameter></term> + <listitem> + <para> + Regulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung + </para> + <para> + Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären + Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese + entsprechend kennzeichnen. Wenn Sie der Ansicht sind, + <function>spliti</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 + /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die zu durchsuchende Zeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Beschränkung</parameter></term> + <listitem> + <para> + Wenn <parameter>Beschränkung</parameter> gesetzt wurde, enthält das + zurückgegebene Array höchstens <parameter>Beschränkung</parameter> + Elemente, von denen das letzte den ganzen Rest von + <parameter>Zeichenkette</parameter> enthält. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein Array mit Zeichenketten zurück, die jeweils eine Teilzeichenkette + von <parameter>Zeichenkette</parameter> sind. Diese Teilzeichenketten + entstehen durch Zerlegung von <parameter>Zeichenkette</parameter> an den + durch den regulären Ausdruck <parameter>Suchmuster</parameter> bestimmten + Stellen ohne Berücksichtigung der Groß- und Kleinschreibung. + </para> + <para> + 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. Bei Auftreten eines + Fehlers gibt <function>spliti</function> &false; zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> Dieses Beispiel verwendet 'a' als Trennzeichen um eine Zeichenkette zu zerlegen: @@ -51,11 +124,20 @@ </screen> </example> </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>preg_split</function>, <function>split</function>, - <function>explode</function> und <function>implode</function>. + <simplelist> + <member><function>preg_split</function></member> + <member><function>split</function></member> + <member><function>explode</function></member> + <member><function>implode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/functions/sql-regcase.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/regex/functions/sql-regcase.xml diff -u phpdoc-de/reference/regex/functions/sql-regcase.xml:1.9 phpdoc-de/reference/regex/functions/sql-regcase.xml:1.10 --- phpdoc-de/reference/regex/functions/sql-regcase.xml:1.9 Sat Jun 23 13:21:47 2007 +++ phpdoc-de/reference/regex/functions/sql-regcase.xml Sun Aug 5 12:48:53 2007 @@ -1,28 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- 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.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.39/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.sql-regcase" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>sql_regcase</refname> <refpurpose>Erstellt einen regulären Ausdruck für eine Suche nach Übereinstimmungen ohne Berücksichtigung von Groß-/Kleinschreibung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>sql_regcase</methodname> <methodparam><type>string</type><parameter>Zeichenkette</parameter></methodparam> </methodsynopsis> <para> - Gibt einen korrekten regulären Ausdruck zurück, der mit + Erstellt einen regulären Ausdruck für eine Suche nach Übereinstimmungen + ohne Berücksichtigung von Groß- und Kleinschreibung. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Zeichenkette</parameter></term> + <listitem> + <para> + Die umzuwandelnde Zeichenkette + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen korrekten regulären Ausdruck zurück, der auf <parameter>Zeichenkette</parameter> ohne Berücksichtigung von - Groß-/Kleinschreibung übereinstimmt. Dieser Ausdruck entspricht + Groß- und Kleinschreibung passt. Dieser Ausdruck entspricht <parameter>Zeichenkette</parameter>, wobei jeder Buchstabe in einen Klammerausdruck umgewandelt wird. Die Klammer enthält diesen Buchstaben in groß- und kleingeschriebener Form. Andere Zeichen bleiben unverändert. </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>sql_regcase</function> Beispiel</title> @@ -43,11 +69,12 @@ </para> <para> Dies kann bei Produkten, die nur reguläre Ausdrücke mit Berücksichtigung - von Groß-/Kleinschreibung unterstützen, verwendet werden, um eine + von Groß- und Kleinschreibung unterstützen, verwendet werden, um eine Übereinstimmung mit Suchmustern ohne Berücksichtigung von - Groß-/Kleinschreibung zu erreichen. + Groß- und Kleinschreibung zu erreichen. </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file