cvs: phpdoc-de / language-defs.ent preface.xml /reference/strings/functions strrev.xml strripos.xml strrpos.xml strspn.xml strstr.xml strtolower.xml
strtoupper.xml substr-compare.xml substr-replace.xml substr.xml
| From: | Carola 'Sammy' Kummert | Date: | Thu, 18 Oct 2007 22:41:24 +0000 |
| Subject: | cvs: phpdoc-de / language-defs.ent preface.xml /reference/strings/functions strrev.xml strripos.xml strrpos.xml strspn.xml strstr.xml strtolower.xml strtoupper.xml substr-compare.xml substr-replace.xml substr.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2252@lists.php.net to get a copy of this message | ||
sammywg Thu Oct 18 22:41:24 2007 UTC
Modified files:
/phpdoc-de language-defs.ent preface.xml
/phpdoc-de/reference/strings/functions strrev.xml strripos.xml
strrpos.xml strspn.xml
strstr.xml strtolower.xml
strtoupper.xml
substr-compare.xml
substr-replace.xml
substr.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/language-defs.ent?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/language-defs.ent diff -u phpdoc-de/language-defs.ent:1.16 phpdoc-de/language-defs.ent:1.17 --- phpdoc-de/language-defs.ent:1.16 Tue Sep 13 16:22:18 2005 +++ phpdoc-de/language-defs.ent Thu Oct 18 22:41:24 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='ISO-8859-1' ?> -<!-- EN-Revision: 1.28 Maintainer: betz Status: ready --> -<!-- CREDITS: mk --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.32 Maintainer: sammywg Status: ready --> <!-- Part titles used mostly in manual.xml itself --> <!ENTITY PHPManual "PHP Handbuch"> @@ -19,6 +19,7 @@ <!ENTITY FAQ "FAQ: Frequently Asked Questions"> <!ENTITY FAQabbrev "FAQ"> <!ENTITY Internals "PHP und Zend Engine Interna"> +<!ENTITY Internals2 "PHP im Kern: Das Entwicklerhandbuch für die Zend Engine"> <!ENTITY ZendAPI "Zend API: Hacking the Core of PHP"> <!ENTITY FunctionIndex "Funktions-Index"> <!ENTITY CHMEdition "Windows HTML Hilfe"> @@ -42,8 +43,10 @@ <!ENTITY reftitle.constants '<title>Vordefinierte Konstanten</title>'> <!ENTITY reftitle.constructor '<title>Konstruktor</title>'> <!ENTITY reftitle.description '<title>Beschreibung</title>'> +<!ENTITY reftitle.encoding '<title>Encoding</title>'> <!ENTITY reftitle.examples '<title>Beispiele</title>'> <!ENTITY reftitle.exceptions '<title>Exceptions</title>'> +<!ENTITY reftitle.errors '<title>Fehler/Exceptions</title>'> <!ENTITY reftitle.install '<title>Installation</title>'> <!ENTITY reftitle.intro '<title>Einführung</title>'> <!ENTITY reftitle.methods '<title>Methoden</title>'> http://cvs.php.net/viewvc.cgi/phpdoc-de/preface.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-de/preface.xml diff -u phpdoc-de/preface.xml:1.20 phpdoc-de/preface.xml:1.21 --- phpdoc-de/preface.xml:1.20 Wed Oct 10 10:20:10 2007 +++ phpdoc-de/preface.xml Thu Oct 18 22:41:24 2007 @@ -1,12 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.31 Maintainer: betz Status: ready --> -<!-- CREDITS: mk --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.35 Maintainer: sammywg Status: ready --> <preface xml:id="preface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <info> - <title>Vorwort</title> - + <info><title>Vorwort</title> <abstract> <simpara> <acronym>PHP</acronym> ist die Abkürzung für "PHP: Hypertext @@ -27,7 +24,6 @@ wichtigsten <link linkend="features">Features</link> und weitere <link linkend="appendices">ergänzende Informationen</link>. </para> - <para> Sie können dieses Handbuch in verschiedenen Formaten unter <link xlink:href="&url.php.doc.downloads;">&url.php.doc.downloads;</link> @@ -39,7 +35,6 @@ </para> &contributors; - </preface> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strrev.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strrev.xml diff -u phpdoc-de/reference/strings/functions/strrev.xml:1.5 phpdoc-de/reference/strings/functions/strrev.xml:1.6 --- phpdoc-de/reference/strings/functions/strrev.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strrev.xml Thu Oct 18 22:41:24 2007 @@ -1,33 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.strrev" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strrev</refname> - <refpurpose>Kehrt einen String um</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>strrev</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> in umgekehrter Reihenfolge zurück. - <example> - <title>Umkehren eines Strings mit <function>strrev</function></title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrev"> + <refnamediv> + <refname>strrev</refname> + <refpurpose>Kehrt einen String um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strrev</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> in umgekehrter Reihenfolge zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die umzukehrende Zeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die umgekehrte Zeichenfolge zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Umkehren eines Strings mit <function>strrev</function></title> + <programlisting role="php"> <![CDATA[ <?php echo strrev("Hallo Welt!"); // Ausgabe: "!tleW ollaH" ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strripos.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/strings/functions/strripos.xml diff -u phpdoc-de/reference/strings/functions/strripos.xml:1.4 phpdoc-de/reference/strings/functions/strripos.xml:1.5 --- phpdoc-de/reference/strings/functions/strripos.xml:1.4 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strripos.xml Thu Oct 18 22:41:24 2007 @@ -1,45 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.strripos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strripos</refname> - <refpurpose> - Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, - unabhängig von Groß- und Kleinschreibung. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strripos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die numerische Position des letzten Vorkommens von - <parameter>needle</parameter> im - <parameter>haystack</parameter> String. Im Unterschied zu - <function>strrpos</function> berücksichtigt <function>strripos</function> - die Groß- und Kleinschreibung nicht. Beachten Sie außerdem, dass die - Funktion bei 0 zu zählen beginnt, nicht bei 1. - </para> - <para> - Beachten Sie: <parameter>needle</parameter> kann eine Zeichenkette aus einem - oder mehreren Zeichen sein. - </para> - <para> - Wenn <parameter>needle</parameter> nicht gefunden wird, gibt die Funktion - &false; zurück. - </para> - - &return.falseproblem; - - <para> - <example> - <title>Ein einfaches <function>strripos</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.2 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strripos"> + <refnamediv> + <refname>strripos</refname> + <refpurpose>Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, + unabhängig von Groß- und Kleinschreibung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strripos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, + unabhängig von Groß- und Kleinschreibung. Im Gegensatz zu + <function>strrpos</function> beachtet <function>strripos</function> die + Groß- und Kleinschreibung nicht. + </para> + <refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + Beachten Sie, dass <parameter>needle</parameter> eine Zeichenkette aus + einem oder mehreren Zeichen sein kann. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Der Parameter <parameter>offset</parameter> kann angegeben werden, wenn + eine beliebige Anzahl Zeichen in einem String gesucht werden soll. + </para> + <para> + Negative Offset-Werte beginnen die Suche bei dem in + <parameter>offset</parameter> angegebenen Zeichen ab + <emphasis>Beginn</emphasis> des Strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die numerische Position des letzten Vorkommens von + <parameter>needle</parameter> zurück. Beachten Sie außerdem, dass die + Funktion bei 0 zu zählen beginnt, nicht bei 1. + </para> + <para> + Wenn <parameter>needle</parameter> nicht gefunden wird, gibt die Funktion + &false; zurück. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein einfaches <function>strripos</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $haystack = 'ababcd'; @@ -55,35 +97,34 @@ } ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Glückwunsch! Das letzte Vorkommen von (aB) in (ababcd) ist an Position (2). ]]> - </screen> - </example> - </para> - <simpara> - Der Parameter <parameter>offset</parameter> kann angegeben werden, wenn - eine beliebige Anzahl Zeichen in einem String gesucht werden soll. - </simpara> - <simpara> - Negative Offset-Werte beginnen die Suche bei dem in - <parameter>offset</parameter> angegebenen Zeichen ab - <emphasis>Beginn</emphasis> des Strings. - </simpara> - <para> - Siehe auch <function>strrpos</function>, - <function>strrchr</function>, - <function>substr</function>, <function>stripos</function> und - <function>stristr</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>stripos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strrpos.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/strrpos.xml diff -u phpdoc-de/reference/strings/functions/strrpos.xml:1.8 phpdoc-de/reference/strings/functions/strrpos.xml:1.9 --- phpdoc-de/reference/strings/functions/strrpos.xml:1.8 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strrpos.xml Thu Oct 18 22:41:24 2007 @@ -1,39 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.12 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.5 --> - <refentry xml:id="function.strrpos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strrpos</refname> - <refpurpose> - Findet das letzte Vorkommen eines Zeichens innerhalb einer Zeichenkette - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>strrpos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die numerische Position des letzten Vorkommens von - <parameter>needle</parameter> innerhalb von <parameter>haystack</parameter> - zurück. Beachten Sie, dass needle unter PHP 4 in diesem Fall nur ein - einzelnes Zeichen sein kann. Wenn Sie eine Zeichenkette als needle übergeben, - wird nur deren erstes Zeichen verwendet. - </para> - <para> - Wurde <parameter>needle</parameter> nicht gefunden, wird &false; - zurückgegeben. - </para> - <para> - Es liegt nahe, einen Fehler bei der Auswertung der Rückgabewerte von - "Zeichen an Position 0 gefunden" und "Zeichen nicht gefunden" zu begehen. - Am einfachsten finden Sie den Unterschied wie folgt heraus: - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrpos"> + <refnamediv> + <refname>strrpos</refname> + <refpurpose>Findet das letzte Vorkommen eines Zeichens innerhalb einer Zeichenkette</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strrpos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die numerische Position des letzten Vorkommens von + <parameter>needle</parameter> innerhalb der Zeichenkette + <parameter>haystack</parameter> zurück. Beachten Sie, dass needle unter + PHP 4 in diesem Fall nur ein einzelnes Zeichen sein kann. Wenn Sie eine + Zeichenkette als needle übergeben, wird nur deren erstes Zeichen verwendet. + </para> + <para> + Wurde <parameter>needle</parameter> nicht gefunden, wird &false; + zurückgegeben. + </para> + <para> + Es liegt nahe, einen Fehler bei der Auswertung der Rückgabewerte von + "Zeichen an Position 0 gefunden" und "Zeichen nicht gefunden" zu begehen. + Am einfachsten finden Sie den Unterschied wie folgt heraus: + <informalexample> + <programlisting role="php"> <![CDATA[ <?php @@ -50,37 +48,81 @@ } ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <note> - <simpara> - Seit PHP 5.0.0 kann <parameter>offset</parameter> den Anfangspunkt - der Suche einer beliebigen Anzahl Zeichen innerhalb des Strings angeben. - Negative Werte beenden die Suche an einem beliebigen Punkt vor dem Ende - der Zeichenkette. - </simpara> - </note> - <note> - <simpara> - Der Parameter <parameter>needle</parameter> kann seit PHP 5.0.0 auch ein - String aus mehr als einem Zeichen sein. - </simpara> - </note> - <para> - Siehe auch <function>strpos</function>, - <function>strripos</function>, - <function>strrchr</function>, - <function>substr</function>, - <function>stristr</function> und - <function>strstr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + <para> + Ist <parameter>needle</parameter> kein String, wird der Parameter in einen + Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. + </para> + <note> + <simpara> + Seit PHP 5.0.0 kann <parameter>offset</parameter> den Anfangspunkt + der Suche ab einer beliebigen Anzahl Zeichen innerhalb des Strings angeben. + Negative Werte beenden die Suche an einem beliebigen Punkt vor dem Ende + der Zeichenkette. + </simpara> + </note> + <note> + <simpara> + Der Parameter <parameter>needle</parameter> kann seit PHP 5.0.0 auch ein + String aus mehr als einem Zeichen sein. + </simpara> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>strripos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strspn.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strspn.xml diff -u phpdoc-de/reference/strings/functions/strspn.xml:1.5 phpdoc-de/reference/strings/functions/strspn.xml:1.6 --- phpdoc-de/reference/strings/functions/strspn.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strspn.xml Thu Oct 18 22:41:24 2007 @@ -1,68 +1,146 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.strspn" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strspn</refname> - <refpurpose> - Ermittelt die Länge der übereinstimmenden Zeichen - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strspn</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <simpara> - Gibt die Länge des Abschnittes am Anfang von <parameter>str1</parameter> - zurück, der vollständig aus in <parameter>str2</parameter> angegebenen - Zeichen besteht. - </simpara> - <para> - Die Zeile - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strspn"> + <refnamediv> + <refname>strspn</refname> + <refpurpose>Ermittelt die Länge der übereinstimmenden Zeichen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strspn</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + Ermittelt die Länge der übereinstimmenden Zeichen. + </para> + <para> + Die Zeile + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $var = strspn("42 ist die Antwort, was ist die Frage?", "1234567890"); ?> ]]> - </programlisting> - </informalexample> - ordnet 2 der Variable <varname>$var</varname> zu, da der String "42" das - längste Segment darstellt, das Zeichen der Menge "1234567890" enthält. - </para> - <simpara> - Seit PHP 4.3.0 akzeptiert <function>strspn</function> zwei optionale - Parameter vom Typ <type>integer</type>, die dazu verwendet werden können, - die Anfangsposition (<parameter>start</parameter>) sowie die Länge - (<parameter>length</parameter>) des zu untersuchenden Stringteils zu - bestimmen. - </simpara> - <para> - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + ordnet 2 der Variable <varname>$var</varname> zu, da der String "42" das + längste Segment darstellt, das Zeichen der Menge "1234567890" enthält. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str1</parameter></term> + <listitem> + <para> + Die erste Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str2</parameter></term> + <listitem> + <para> + Die zweite Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Die Anfangsstelle der zu untersuchenden Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Die Länge der zu untersuchenden Zeichensequenz. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Abschnittes am Anfang von <parameter>str1</parameter> + zurück, der vollständig aus in <parameter>str2</parameter> angegebenen + Zeichen besteht. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Die Parameter <parameter>start</parameter> und <parameter>length</parameter> + wurden hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strspn</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo strspn("foo", "o", 1, 2); // 2 ?> ]]> - </programlisting> - </informalexample> - </para> - - ¬e.bin-safe; - - <simpara> - Siehe auch <function>strcspn</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strcspn</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strstr.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/strings/functions/strstr.xml diff -u phpdoc-de/reference/strings/functions/strstr.xml:1.10 phpdoc-de/reference/strings/functions/strstr.xml:1.11 --- phpdoc-de/reference/strings/functions/strstr.xml:1.10 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strstr.xml Thu Oct 18 22:41:24 2007 @@ -1,76 +1,153 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.strstr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strstr</refname> - <refpurpose>Findet das erste Vorkommen eines Strings</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strstr</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - </methodsynopsis> - <para> - Gibt den Teil von <parameter>haystack</parameter> ab dem ersten - Vorkommen von <parameter>needle</parameter> bis zum Ende von - <parameter>haystack</parameter> zurück. - </para> - <para> - Falls <parameter>needle</parameter> nicht gefunden wird, wird &false; - zurückgegeben. - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <note> - <para> - Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. - Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, - verwenden Sie <function>stristr</function>. - </para> - </note> - <para> - <example> - <title><function>strstr</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>Findet das erste Vorkommen eines Strings</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strstr</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam><type>bool</type><parameter>before_needle</parameter></methodparam> + </methodsynopsis> + <para> + Gibt den Teil der Zeichenkette <parameter>haystack</parameter> ab dem + ersten Vorkommen von <parameter>needle</parameter> bis zum Ende von + <parameter>haystack</parameter> zurück. + </para> + <note> + <para> + Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. + Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, + verwenden Sie <function>stristr</function>. + </para> + </note> + <note> + <para> + Wenn Sie nur herausfinden möchten, ob ein bestimmter + <parameter>needle</parameter> innerhalb von + <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen + die schnellere und weniger speicherintensive Funktion + <function>strpos</function>. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + Ist <parameter>needle</parameter> kein String, wird der Parameter in einen + Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>before_needle</parameter></term> + <listitem> + <para> + Ist der Wert auf &true; gesetzt (der Standardwert ist &false;), gibt + <function>strstr</function> den Teil von <parameter>haystack</parameter> + zurück, der sich vor dem ersten Vorkommen von <parameter>needle</parameter> + befindet. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen Teil der Zeichenkette zurück. Wird <parameter>needle</parameter> + nicht gefunden, wird &false; zurückgegeben. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>6.0.0</entry> + <entry> + Der Parameter <parameter>before_needle</parameter> wurde hinzugefügt. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + <function>strstr</function> ist nun binary safe. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strstr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$email = 'user@example.com'; +$email = 'name@example.com'; $domain = strstr($email, '@'); echo $domain; // Ausgabe: @example.com + +$user = strstr($email, '@', true); +echo $user; // Ausgabe: name ?> ]]> - </programlisting> - </example> - </para> - <para> - <note> - <para> - Wenn Sie nur herausfinden möchten, ob ein bestimmter - <parameter>needle</parameter> innerhalb von - <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen - die schnellere und weniger speicherintensive Funktion - <function>strpos</function>. - </para> - </note> - </para> - <para> - <function>strstr</function> ist binary safe seit PHP 4.3.0 - </para> - <para> - Siehe auch - <function>preg_match</function>, - <function>stristr</function>, - <function>strpos</function>, - <function>strrchr</function> und - <function>substr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>stristr</function></member> + <member><function>strpos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtolower.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtolower.xml diff -u phpdoc-de/reference/strings/functions/strtolower.xml:1.5 phpdoc-de/reference/strings/functions/strtolower.xml:1.6 --- phpdoc-de/reference/strings/functions/strtolower.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtolower.xml Thu Oct 18 22:41:24 2007 @@ -1,29 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtolower" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtolower</refname> - <refpurpose>Setzt einen String in Kleinbuchstaben um</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtolower</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben - in Kleinbuchstaben umgewandelt wurden. - </para> - <para> - Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist - z. B. die Voreinstellung für locale "C", werden Sonderzeichen - wie Umlaute (ä, ö, ü) nicht umgewandelt. - </para> - <example> - <title><function>strtolower</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtolower"> + <refnamediv> + <refname>strtolower</refname> + <refpurpose>Setzt einen String in Kleinbuchstaben um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtolower</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben + in Kleinbuchstaben umgewandelt wurden. + </para> + <para> + Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist + z. B. die Voreinstellung für locale "C", werden Sonderzeichen + wie Umlaute (ä, ö, ü) nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Zeichenkette in Kleinbuchstaben zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtolower</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Mary Hat Ein Kleines Lamm, und Sie LIEBT Es So."; @@ -31,19 +60,30 @@ echo $str; // Gibt aus: mary hat ein kleines lamm, und sie liebt es so. ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtoupper</function></member> + <member><function>ucfirst</function></member> + <member><function>ucwords</function></member> + <member><function>mb_strtolower</function></member> + </simplelist> + </para> + </refsect1> - ¬e.bin-safe; +</refentry> - <para> - Siehe auch <function>strtoupper</function>, - <function>ucfirst</function>, - <function>ucwords</function> und - <function>mb_strtolower</function>. - </para> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtoupper.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtoupper.xml diff -u phpdoc-de/reference/strings/functions/strtoupper.xml:1.5 phpdoc-de/reference/strings/functions/strtoupper.xml:1.6 --- phpdoc-de/reference/strings/functions/strtoupper.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtoupper.xml Thu Oct 18 22:41:24 2007 @@ -1,29 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtoupper" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtoupper</refname> - <refpurpose>Setzt einen String in Großbuchstaben um</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtoupper</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben - in Großbuchstaben umgewandelt wurden. - </para> - <para> - Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist - z. B. die Voreinstellung für locale "C", werden Sonderzeichen - wie Umlaute (ä, ö, ü) nicht umgewandelt. - </para> - <example> - <title><function>strtoupper</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtoupper"> + <refnamediv> + <refname>strtoupper</refname> + <refpurpose>Wandelt alle Zeichen eines Strings in Großbuchstaben um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtoupper</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben + in Großbuchstaben umgewandelt wurden. + </para> + <para> + Beachten Sie, dass die Erkennung von 'Buchstaben' vom Wert locale abhängig + ist. Ist z. B. die Voreinstellung für locale "C", werden Sonderzeichen + wie Umlaute (ä, ö, ü) nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Zeichenkette in Großbuchstaben zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtoupper</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Mary Hat Ein Kleines Lamm, und Sie LIEBT Es So."; @@ -31,21 +60,31 @@ echo $str; // Gibt aus: MARY HAT EIN KLEINES LAMM, UND SIE LIEBT ES SO. ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtolower</function></member> + <member><function>ucfirst</function></member> + <member><function>ucwords</function></member> + <member><function>mb_strtoupper</function></member> + </simplelist> + </para> + </refsect1> - ¬e.bin-safe; +</refentry> - <para> - Siehe auch <function>strtolower</function>, - <function>ucfirst</function>, - <function>ucwords</function> und - <function>mb_strtoupper</function>. - </para> - </refsect1> - </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr-compare.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/substr-compare.xml diff -u phpdoc-de/reference/strings/functions/substr-compare.xml:1.2 phpdoc-de/reference/strings/functions/substr-compare.xml:1.3 --- phpdoc-de/reference/strings/functions/substr-compare.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr-compare.xml Thu Oct 18 22:41:24 2007 @@ -1,53 +1,131 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> - <refentry xml:id="function.substr-compare" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr_compare</refname> - <refpurpose> - Binärdaten-sicherer Vergleich zweier Strings, beginnend an einer bestimmten - Position und endend nach einer festgelegten Länge. Der durchgeführte Vergleich - berücksichtigt optional Groß- und Kleinschreibung. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>substr_compare</methodname> - <methodparam><type>string</type><parameter>main_str</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>case_insensitivity</parameter></methodparam> - </methodsynopsis> - - <para> - <function>substr_compare</function> vergleicht <parameter>main_str</parameter> - ab der in <parameter>offset</parameter> definierten Position mit - <parameter>str</parameter>. Die Länge des verglichenen String-Bestandteils - wird vom <parameter>length</parameter>-Parameter bestimmt. - </para> - <para> - Gibt eine Zahl <0 zurück, wenn <parameter>main_str</parameter> ab der in - <parameter>offset</parameter> festgelegten Position kürzer ist als - <parameter>str</parameter>, eine Zahl >0, wenn der ermittelte String länger - ist als <parameter>str</parameter>, und 0, wenn sie gleich sind. - Wenn der Parameter <parameter>length</parameter> gesetzt und gleich oder größer - als die Länge von <parameter>main_str</parameter> ist, gibt - <function>substr_compare</function> eine Warnung aus und hat den - Rückgabewert &false;. - </para> - <para> - Wenn <parameter>case_insensitivity</parameter> &true; ist, wird - der Vergleich unabhängig von der Groß- und Kleinschreibung durchgeführt. - </para> - <para> - <example> - <title>Ein <function>substr_compare</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-compare"> + <refnamediv> + <refname>substr_compare</refname> + <refpurpose>Binärdaten-sicherer Vergleich zweier Strings, beginnend an einer bestimmten + Position und endend nach einer festgelegten Länge</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>substr_compare</methodname> + <methodparam><type>string</type><parameter>main_str</parameter></methodparam> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>case_insensitivity</parameter></methodparam> + </methodsynopsis> + <para> + <function>substr_compare</function> vergleicht <parameter>main_str</parameter> + ab der in <parameter>offset</parameter> definierten Position mit + <parameter>str</parameter>. Die Länge des verglichenen String-Bestandteils + wird vom <parameter>length</parameter>-Parameter bestimmt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>main_str</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Die Anfangsposition für den Vergleich. Wenn der Wert negativ ist, wird + rückwärts vom Ende der Zeichenkette an gezählt. + The start position for the comparison. If negative, it starts counting + from the end of the string. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Die Länge der zu vergleichenden Zeichensequenz. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>case_insensitivity</parameter></term> + <listitem> + <para> + Wenn <parameter>case_insensitivity</parameter> den Wert &true; hat, + wird der Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung + durchgeführt. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Zahl <0 zurück, wenn <parameter>main_str</parameter> ab der in + <parameter>offset</parameter> festgelegten Position kürzer ist als + <parameter>str</parameter>, eine Zahl >0, wenn der ermittelte String länger + ist als <parameter>str</parameter>, und 0, wenn sie gleich sind. + Wenn der Parameter <parameter>length</parameter> gesetzt und gleich oder größer + als die Länge von <parameter>main_str</parameter> ist, gibt + <function>substr_compare</function> eine Warnung aus und hat den + Rückgabewert &false;. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + Die Möglichkeit, einen negativen Wert für <parameter>offset</parameter> + festzulegen, wurde eingeführt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>substr_compare</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo substr_compare("abcde", "bc", 1, 2); // 0 +echo substr_compare("abcde", "de", -2, 2); // 0 echo substr_compare("abcde", "bcg", 1, 2); // 0 echo substr_compare("abcde", "BC", 1, 2, true); // 0 echo substr_compare("abcde", "bc", 1, 3); // 1 @@ -55,12 +133,13 @@ echo substr_compare("abcde", "abc", 5, 1); // warning ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr-replace.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/substr-replace.xml diff -u phpdoc-de/reference/strings/functions/substr-replace.xml:1.5 phpdoc-de/reference/strings/functions/substr-replace.xml:1.6 --- phpdoc-de/reference/strings/functions/substr-replace.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr-replace.xml Thu Oct 18 22:41:24 2007 @@ -1,54 +1,103 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.substr-replace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr_replace</refname> - <refpurpose>Ersetzt Text innerhalb einer Zeichenkette</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>substr_replace</methodname> - <methodparam><type>mixed</type><parameter>string</parameter></methodparam> - <methodparam><type>string</type><parameter>replacement</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - <function>substr_replace</function> ersetzt in einer Kopie von - <parameter>string</parameter> alle Zeichen, die sich innerhalb der - durch die Parameter <parameter>start</parameter> und (optional) - <parameter>length</parameter> festgelegten Grenze befinden, mit der in - <parameter>replacement</parameter> angegebenen Zeichenkette. Der dabei - entstandene String wird zurückgegeben. Ist <parameter>string</parameter> - ein Array, wird auch ein Array zurückgegeben. - </para> - <para> - Ist <parameter>start</parameter> positiv, beginnt die Ersetzung ab der - im Offset-Parameter <parameter>start</parameter> definierten Stelle - innerhalb von <parameter>string</parameter>. - </para> - <para> - Ist <parameter>start</parameter> negativ, wird vom Ende der - Zeichenkette <parameter>string</parameter> bis zum Wert von - <parameter>start</parameter> rückwärts gezählt und dort mit dem - Austausch begonnen. - </para> - <para> - Ist <parameter>length</parameter> angegeben und positiv, stellt - dieser Parameter die Länge des auszuwechselnden Teils von - <parameter>string</parameter> dar. Ist der Wert negativ, gibt er - die Zeichenzahl an, um die ab Ende von <parameter>string</parameter> - rückwärts gezählt wird. Bis zu dieser Stelle erfolgt dann der Austausch. - Ist der Parameter nicht angegeben, wird standardmäßig eine Ersetzung bis - zum Ende des Strings (strlen(<parameter>string</parameter> )) durchgeführt. - </para> - <para> - <example> - <title><function>substr_replace</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-replace"> + <refnamediv> + <refname>substr_replace</refname> + <refpurpose>Ersetzt Text innerhalb einer Zeichenkette</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>substr_replace</methodname> + <methodparam><type>mixed</type><parameter>string</parameter></methodparam> + <methodparam><type>string</type><parameter>replacement</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + <function>substr_replace</function> ersetzt in einer Kopie von + <parameter>string</parameter> alle Zeichen, die sich innerhalb der + durch die Parameter <parameter>start</parameter> und (optional) + <parameter>length</parameter> festgelegten Grenze befinden, mit der in + <parameter>replacement</parameter> angegebenen Zeichenkette. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replacement</parameter></term> + <listitem> + <para> + Die Ersetzungszeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Ist <parameter>start</parameter> positiv, beginnt die Ersetzung ab der + im Offset-Parameter <parameter>start</parameter> definierten Stelle + innerhalb von <parameter>string</parameter>. + </para> + <para> + Ist <parameter>start</parameter> negativ, wird vom Ende der + Zeichenkette <parameter>string</parameter> bis zum Wert von + <parameter>start</parameter> rückwärts gezählt und dort mit dem + Austausch begonnen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Ist der Parameter angegeben und positiv, stellt + dieser Parameter die Länge des auszuwechselnden Teils von + <parameter>string</parameter> dar. Ist der Wert negativ, gibt er + die Zeichenzahl an, um die ab Ende von <parameter>string</parameter> + rückwärts gezählt wird. Bis zu dieser Stelle erfolgt dann der Austausch. + Ist der Parameter nicht angegeben, wird standardmäßig eine Ersetzung bis + zum Ende des Strings (strlen(<parameter>string</parameter> )) durchgeführt, + das heißt, die Ersetzung endet mit dem Ende von <parameter>string</parameter>. + Sollte <parameter>length</parameter> den Wert null haben, wird die + Funktion die Zeichenkette <parameter>replacement</parameter> in + <parameter>string</parameter> an der durch <parameter>start</parameter> + bezeichneten Stelle einfügen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Der entstehende String wird zurückgegeben. Ist <parameter>string</parameter> + ein Array, wird auch ein Array zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>substr_replace</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $var = 'ABCDEFGH:/MNRPQR/'; @@ -62,7 +111,7 @@ /* Einfügen von 'bob' direkt am Anfang von $var. */ echo substr_replace($var, 'bob', 0, 0) . "<br />\n"; -/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var +/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var durch 'bob'. */ echo substr_replace($var, 'bob', 10, -1) . "<br />\n"; echo substr_replace($var, 'bob', -7, -1) . "<br />\n"; @@ -71,18 +120,28 @@ echo substr_replace($var, '', 10, -1) . "<br />\n"; ?> ]]> - </programlisting> - </example> - </para> - - ¬e.bin-safe; - - <para> - Siehe auch <function>str_replace</function> und - <function>substr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>str_replace</function></member> + <member><function>substr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/substr.xml diff -u phpdoc-de/reference/strings/functions/substr.xml:1.8 phpdoc-de/reference/strings/functions/substr.xml:1.9 --- phpdoc-de/reference/strings/functions/substr.xml:1.8 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr.xml Thu Oct 18 22:41:24 2007 @@ -1,64 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.12 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.substr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr</refname> - <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>substr</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - <function>substr</function> gibt den Teil von - <parameter>string</parameter> zurück, der durch die Parameter - <parameter>start</parameter> und <parameter>length</parameter> - definiert wurde. - </para> - <para> - Wenn <parameter>start</parameter> nicht negativ ist, beginnt der zurück - gegebene String an der <parameter>start</parameter>-Position von - <parameter>string</parameter>, angefangen bei <literal>0</literal> - (Null). So ist z.B. im String '<literal>abcdef</literal>' das Zeichen - an der Position <literal>0</literal> gleich '<literal>a</literal>', - das Zeichen an der Position <literal>2</literal> ist - '<literal>c</literal>' usw. - </para> - <example> - <title>Generelle Verwendung von <function>substr</function></title> - <programlisting role="php"> -<![CDATA[ -<?php -echo substr('abcdef', 1); // bcdef -echo substr('abcdef', 1, 3); // bcd -echo substr('abcdef', 0, 4); // abcd -echo substr('abcdef', 0, 8); // abcdef -echo substr('abcdef', -1, 1); // f +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr"> + <refnamediv> + <refname>substr</refname> + <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> + </refnamediv> -// Auf ein einzelnes Zeichen eines Strings kann auch mittels -// geschweifter Klammern zugegriffen werden -$string = 'abcdef'; -echo $string{0}; // a -echo $string{3}; // d -echo $string{strlen($string)-1}; // f + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>substr</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + Gibt den Teil von <parameter>string</parameter> zurück, der durch die + Parameter <parameter>start</parameter> und <parameter>length</parameter> + definiert wurde. + </para> + </refsect1> -?> -]]> - </programlisting> - </example> - <para> - Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene - String bei dem in <parameter>start</parameter> festgelegten Zeichen - vom Ende von <parameter>string</parameter> aus betrachtet. - </para> - <example> - <title>Negativen <parameter>start</parameter>-Wert verwenden</title> - <programlisting role="php"> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Wenn <parameter>start</parameter> nicht negativ ist, beginnt der + zurückgegebene String an der <parameter>start</parameter>-Position von + <parameter>string</parameter>, angefangen bei <literal>0</literal> + (Null). So ist z.B. im String '<literal>abcdef</literal>' das Zeichen + an der Position <literal>0</literal> gleich '<literal>a</literal>', + das Zeichen an der Position <literal>2</literal> ist + '<literal>c</literal>' usw. + </para> + <para> + Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene + String bei dem in <parameter>start</parameter> festgelegten Zeichen + vom Ende von <parameter>string</parameter> aus betrachtet. + </para> + <para> + <example> + <title>Negativen <parameter>start</parameter>-Wert verwenden</title> + <programlisting role="php"> <![CDATA[ <?php $rest = substr("abcdef", -1); // gibt "f" zurück @@ -66,27 +62,33 @@ $rest = substr("abcdef", -3, 1); // gibt "d" zurück ?> ]]> - </programlisting> - </example> - <para> - Ist <parameter>length</parameter> angegeben und positiv, enthält der - zurückgegebene String höchstens <parameter>length</parameter> Zeichen - ab <parameter>start</parameter> (abhängig von der Länge von - <parameter>string</parameter>). Ist <parameter>string</parameter> - kürzer als oder gleich <parameter>start</parameter> Zeichen, wird &false; - zurückgegeben. - </para> - <para> - Ist <parameter>length</parameter> angegeben und negativ, werden - genau so viele Zeichen vom Ende von <parameter>string</parameter> - abgeschnitten (nachdem die Startposition ermittelt wurde, sollte - <parameter>start</parameter> negativ sein). Gibt - <parameter>start</parameter> eine Position hinter dem abzuschneidenden - Teil an, wird ein leerer String zurückgegeben. - </para> - <example> - <title>Negativen <parameter>length</parameter>-Wert verwenden</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Ist <parameter>length</parameter> angegeben und positiv, enthält der + zurückgegebene String höchstens <parameter>length</parameter> Zeichen + ab <parameter>start</parameter> (abhängig von der Länge von + <parameter>string</parameter>). Ist <parameter>string</parameter> + kürzer als oder gleich <parameter>start</parameter> Zeichen, wird &false; + zurückgegeben. + </para> + <para> + Ist <parameter>length</parameter> angegeben und negativ, werden + genau so viele Zeichen vom Ende von <parameter>string</parameter> + abgeschnitten (nachdem die Startposition ermittelt wurde, sollte + <parameter>start</parameter> negativ sein). Gibt + <parameter>start</parameter> eine Position hinter dem abzuschneidenden + Teil an, wird ein leerer String zurückgegeben. + </para> + <example> + <title>Negativen <parameter>length</parameter>-Wert verwenden</title> + <programlisting role="php"> <![CDATA[ <?php $rest = substr("abcdef", 0, -1); // gibt "abcde" zurück @@ -95,19 +97,65 @@ $rest = substr("abcdef", -3, -1); // gibt "de" zurück ?> ]]> - </programlisting> - </example> - <para> - Siehe auch - <function>strrchr</function>, - <function>substr_replace</function>, - <function>preg_match</function>, - <function>trim</function>, - <function>mb_substr</function> und - <function>wordwrap</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den extrahierten Teil der Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Generelle Verwendung von <function>substr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo substr('abcdef', 1); // bcdef +echo substr('abcdef', 1, 3); // bcd +echo substr('abcdef', 0, 4); // abcd +echo substr('abcdef', 0, 8); // abcdef +echo substr('abcdef', -1, 1); // f + +// Auf ein einzelnes Zeichen eines Strings kann auch mittels +// geschweifter Klammern zugegriffen werden +$string = 'abcdef'; +echo $string{0}; // a +echo $string{3}; // d +echo $string{strlen($string)-1}; // f + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strrchr</function></member> + <member><function>substr_replace</function></member> + <member><function>preg_match</function></member> + <member><function>trim</function></member> + <member><function>mb_substr</function></member> + <member><function>wordwrap</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/language-defs.ent?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/language-defs.ent diff -u phpdoc-de/language-defs.ent:1.16 phpdoc-de/language-defs.ent:1.17 --- phpdoc-de/language-defs.ent:1.16 Tue Sep 13 16:22:18 2005 +++ phpdoc-de/language-defs.ent Thu Oct 18 22:41:24 2007 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='ISO-8859-1' ?> -<!-- EN-Revision: 1.28 Maintainer: betz Status: ready --> -<!-- CREDITS: mk --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.32 Maintainer: sammywg Status: ready --> <!-- Part titles used mostly in manual.xml itself --> <!ENTITY PHPManual "PHP Handbuch"> @@ -19,6 +19,7 @@ <!ENTITY FAQ "FAQ: Frequently Asked Questions"> <!ENTITY FAQabbrev "FAQ"> <!ENTITY Internals "PHP und Zend Engine Interna"> +<!ENTITY Internals2 "PHP im Kern: Das Entwicklerhandbuch für die Zend Engine"> <!ENTITY ZendAPI "Zend API: Hacking the Core of PHP"> <!ENTITY FunctionIndex "Funktions-Index"> <!ENTITY CHMEdition "Windows HTML Hilfe"> @@ -42,8 +43,10 @@ <!ENTITY reftitle.constants '<title>Vordefinierte Konstanten</title>'> <!ENTITY reftitle.constructor '<title>Konstruktor</title>'> <!ENTITY reftitle.description '<title>Beschreibung</title>'> +<!ENTITY reftitle.encoding '<title>Encoding</title>'> <!ENTITY reftitle.examples '<title>Beispiele</title>'> <!ENTITY reftitle.exceptions '<title>Exceptions</title>'> +<!ENTITY reftitle.errors '<title>Fehler/Exceptions</title>'> <!ENTITY reftitle.install '<title>Installation</title>'> <!ENTITY reftitle.intro '<title>Einführung</title>'> <!ENTITY reftitle.methods '<title>Methoden</title>'> http://cvs.php.net/viewvc.cgi/phpdoc-de/preface.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-de/preface.xml diff -u phpdoc-de/preface.xml:1.20 phpdoc-de/preface.xml:1.21 --- phpdoc-de/preface.xml:1.20 Wed Oct 10 10:20:10 2007 +++ phpdoc-de/preface.xml Thu Oct 18 22:41:24 2007 @@ -1,12 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.31 Maintainer: betz Status: ready --> -<!-- CREDITS: mk --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.35 Maintainer: sammywg Status: ready --> <preface xml:id="preface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <info> - <title>Vorwort</title> - + <info><title>Vorwort</title> <abstract> <simpara> <acronym>PHP</acronym> ist die Abkürzung für "PHP: Hypertext @@ -27,7 +24,6 @@ wichtigsten <link linkend="features">Features</link> und weitere <link linkend="appendices">ergänzende Informationen</link>. </para> - <para> Sie können dieses Handbuch in verschiedenen Formaten unter <link xlink:href="&url.php.doc.downloads;">&url.php.doc.downloads;</link> @@ -39,7 +35,6 @@ </para> &contributors; - </preface> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strrev.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strrev.xml diff -u phpdoc-de/reference/strings/functions/strrev.xml:1.5 phpdoc-de/reference/strings/functions/strrev.xml:1.6 --- phpdoc-de/reference/strings/functions/strrev.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strrev.xml Thu Oct 18 22:41:24 2007 @@ -1,33 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.strrev" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strrev</refname> - <refpurpose>Kehrt einen String um</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>strrev</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> in umgekehrter Reihenfolge zurück. - <example> - <title>Umkehren eines Strings mit <function>strrev</function></title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrev"> + <refnamediv> + <refname>strrev</refname> + <refpurpose>Kehrt einen String um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strrev</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> in umgekehrter Reihenfolge zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die umzukehrende Zeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die umgekehrte Zeichenfolge zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Umkehren eines Strings mit <function>strrev</function></title> + <programlisting role="php"> <![CDATA[ <?php echo strrev("Hallo Welt!"); // Ausgabe: "!tleW ollaH" ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strripos.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/strings/functions/strripos.xml diff -u phpdoc-de/reference/strings/functions/strripos.xml:1.4 phpdoc-de/reference/strings/functions/strripos.xml:1.5 --- phpdoc-de/reference/strings/functions/strripos.xml:1.4 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strripos.xml Thu Oct 18 22:41:24 2007 @@ -1,45 +1,87 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.strripos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strripos</refname> - <refpurpose> - Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, - unabhängig von Groß- und Kleinschreibung. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strripos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die numerische Position des letzten Vorkommens von - <parameter>needle</parameter> im - <parameter>haystack</parameter> String. Im Unterschied zu - <function>strrpos</function> berücksichtigt <function>strripos</function> - die Groß- und Kleinschreibung nicht. Beachten Sie außerdem, dass die - Funktion bei 0 zu zählen beginnt, nicht bei 1. - </para> - <para> - Beachten Sie: <parameter>needle</parameter> kann eine Zeichenkette aus einem - oder mehreren Zeichen sein. - </para> - <para> - Wenn <parameter>needle</parameter> nicht gefunden wird, gibt die Funktion - &false; zurück. - </para> - - &return.falseproblem; - - <para> - <example> - <title>Ein einfaches <function>strripos</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.2 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strripos"> + <refnamediv> + <refname>strripos</refname> + <refpurpose>Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, + unabhängig von Groß- und Kleinschreibung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strripos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, + unabhängig von Groß- und Kleinschreibung. Im Gegensatz zu + <function>strrpos</function> beachtet <function>strripos</function> die + Groß- und Kleinschreibung nicht. + </para> + <refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + Beachten Sie, dass <parameter>needle</parameter> eine Zeichenkette aus + einem oder mehreren Zeichen sein kann. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Der Parameter <parameter>offset</parameter> kann angegeben werden, wenn + eine beliebige Anzahl Zeichen in einem String gesucht werden soll. + </para> + <para> + Negative Offset-Werte beginnen die Suche bei dem in + <parameter>offset</parameter> angegebenen Zeichen ab + <emphasis>Beginn</emphasis> des Strings. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die numerische Position des letzten Vorkommens von + <parameter>needle</parameter> zurück. Beachten Sie außerdem, dass die + Funktion bei 0 zu zählen beginnt, nicht bei 1. + </para> + <para> + Wenn <parameter>needle</parameter> nicht gefunden wird, gibt die Funktion + &false; zurück. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein einfaches <function>strripos</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $haystack = 'ababcd'; @@ -55,35 +97,34 @@ } ?> ]]> - </programlisting> - <para> - Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Glückwunsch! Das letzte Vorkommen von (aB) in (ababcd) ist an Position (2). ]]> - </screen> - </example> - </para> - <simpara> - Der Parameter <parameter>offset</parameter> kann angegeben werden, wenn - eine beliebige Anzahl Zeichen in einem String gesucht werden soll. - </simpara> - <simpara> - Negative Offset-Werte beginnen die Suche bei dem in - <parameter>offset</parameter> angegebenen Zeichen ab - <emphasis>Beginn</emphasis> des Strings. - </simpara> - <para> - Siehe auch <function>strrpos</function>, - <function>strrchr</function>, - <function>substr</function>, <function>stripos</function> und - <function>stristr</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>stripos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strrpos.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/strrpos.xml diff -u phpdoc-de/reference/strings/functions/strrpos.xml:1.8 phpdoc-de/reference/strings/functions/strrpos.xml:1.9 --- phpdoc-de/reference/strings/functions/strrpos.xml:1.8 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strrpos.xml Thu Oct 18 22:41:24 2007 @@ -1,39 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.12 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.5 --> - <refentry xml:id="function.strrpos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strrpos</refname> - <refpurpose> - Findet das letzte Vorkommen eines Zeichens innerhalb einer Zeichenkette - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>int</type><methodname>strrpos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> - Gibt die numerische Position des letzten Vorkommens von - <parameter>needle</parameter> innerhalb von <parameter>haystack</parameter> - zurück. Beachten Sie, dass needle unter PHP 4 in diesem Fall nur ein - einzelnes Zeichen sein kann. Wenn Sie eine Zeichenkette als needle übergeben, - wird nur deren erstes Zeichen verwendet. - </para> - <para> - Wurde <parameter>needle</parameter> nicht gefunden, wird &false; - zurückgegeben. - </para> - <para> - Es liegt nahe, einen Fehler bei der Auswertung der Rückgabewerte von - "Zeichen an Position 0 gefunden" und "Zeichen nicht gefunden" zu begehen. - Am einfachsten finden Sie den Unterschied wie folgt heraus: - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.17 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrpos"> + <refnamediv> + <refname>strrpos</refname> + <refpurpose>Findet das letzte Vorkommen eines Zeichens innerhalb einer Zeichenkette</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strrpos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> + Gibt die numerische Position des letzten Vorkommens von + <parameter>needle</parameter> innerhalb der Zeichenkette + <parameter>haystack</parameter> zurück. Beachten Sie, dass needle unter + PHP 4 in diesem Fall nur ein einzelnes Zeichen sein kann. Wenn Sie eine + Zeichenkette als needle übergeben, wird nur deren erstes Zeichen verwendet. + </para> + <para> + Wurde <parameter>needle</parameter> nicht gefunden, wird &false; + zurückgegeben. + </para> + <para> + Es liegt nahe, einen Fehler bei der Auswertung der Rückgabewerte von + "Zeichen an Position 0 gefunden" und "Zeichen nicht gefunden" zu begehen. + Am einfachsten finden Sie den Unterschied wie folgt heraus: + <informalexample> + <programlisting role="php"> <![CDATA[ <?php @@ -50,37 +48,81 @@ } ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <note> - <simpara> - Seit PHP 5.0.0 kann <parameter>offset</parameter> den Anfangspunkt - der Suche einer beliebigen Anzahl Zeichen innerhalb des Strings angeben. - Negative Werte beenden die Suche an einem beliebigen Punkt vor dem Ende - der Zeichenkette. - </simpara> - </note> - <note> - <simpara> - Der Parameter <parameter>needle</parameter> kann seit PHP 5.0.0 auch ein - String aus mehr als einem Zeichen sein. - </simpara> - </note> - <para> - Siehe auch <function>strpos</function>, - <function>strripos</function>, - <function>strrchr</function>, - <function>substr</function>, - <function>stristr</function> und - <function>strstr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </informalexample> + </para> + <para> + Ist <parameter>needle</parameter> kein String, wird der Parameter in einen + Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. + </para> + <note> + <simpara> + Seit PHP 5.0.0 kann <parameter>offset</parameter> den Anfangspunkt + der Suche ab einer beliebigen Anzahl Zeichen innerhalb des Strings angeben. + Negative Werte beenden die Suche an einem beliebigen Punkt vor dem Ende + der Zeichenkette. + </simpara> + </note> + <note> + <simpara> + Der Parameter <parameter>needle</parameter> kann seit PHP 5.0.0 auch ein + String aus mehr als einem Zeichen sein. + </simpara> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>strripos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strspn.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strspn.xml diff -u phpdoc-de/reference/strings/functions/strspn.xml:1.5 phpdoc-de/reference/strings/functions/strspn.xml:1.6 --- phpdoc-de/reference/strings/functions/strspn.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strspn.xml Thu Oct 18 22:41:24 2007 @@ -1,68 +1,146 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: ready --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.strspn" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strspn</refname> - <refpurpose> - Ermittelt die Länge der übereinstimmenden Zeichen - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strspn</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <simpara> - Gibt die Länge des Abschnittes am Anfang von <parameter>str1</parameter> - zurück, der vollständig aus in <parameter>str2</parameter> angegebenen - Zeichen besteht. - </simpara> - <para> - Die Zeile - <informalexample> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strspn"> + <refnamediv> + <refname>strspn</refname> + <refpurpose>Ermittelt die Länge der übereinstimmenden Zeichen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strspn</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + Ermittelt die Länge der übereinstimmenden Zeichen. + </para> + <para> + Die Zeile + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $var = strspn("42 ist die Antwort, was ist die Frage?", "1234567890"); ?> ]]> - </programlisting> - </informalexample> - ordnet 2 der Variable <varname>$var</varname> zu, da der String "42" das - längste Segment darstellt, das Zeichen der Menge "1234567890" enthält. - </para> - <simpara> - Seit PHP 4.3.0 akzeptiert <function>strspn</function> zwei optionale - Parameter vom Typ <type>integer</type>, die dazu verwendet werden können, - die Anfangsposition (<parameter>start</parameter>) sowie die Länge - (<parameter>length</parameter>) des zu untersuchenden Stringteils zu - bestimmen. - </simpara> - <para> - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + ordnet 2 der Variable <varname>$var</varname> zu, da der String "42" das + längste Segment darstellt, das Zeichen der Menge "1234567890" enthält. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str1</parameter></term> + <listitem> + <para> + Die erste Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str2</parameter></term> + <listitem> + <para> + Die zweite Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Die Anfangsstelle der zu untersuchenden Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Die Länge der zu untersuchenden Zeichensequenz. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des Abschnittes am Anfang von <parameter>str1</parameter> + zurück, der vollständig aus in <parameter>str2</parameter> angegebenen + Zeichen besteht. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + Die Parameter <parameter>start</parameter> und <parameter>length</parameter> + wurden hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strspn</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo strspn("foo", "o", 1, 2); // 2 ?> ]]> - </programlisting> - </informalexample> - </para> - - ¬e.bin-safe; - - <simpara> - Siehe auch <function>strcspn</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strcspn</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strstr.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/strings/functions/strstr.xml diff -u phpdoc-de/reference/strings/functions/strstr.xml:1.10 phpdoc-de/reference/strings/functions/strstr.xml:1.11 --- phpdoc-de/reference/strings/functions/strstr.xml:1.10 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strstr.xml Thu Oct 18 22:41:24 2007 @@ -1,76 +1,153 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.strstr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strstr</refname> - <refpurpose>Findet das erste Vorkommen eines Strings</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strstr</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - </methodsynopsis> - <para> - Gibt den Teil von <parameter>haystack</parameter> ab dem ersten - Vorkommen von <parameter>needle</parameter> bis zum Ende von - <parameter>haystack</parameter> zurück. - </para> - <para> - Falls <parameter>needle</parameter> nicht gefunden wird, wird &false; - zurückgegeben. - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <note> - <para> - Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. - Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, - verwenden Sie <function>stristr</function>. - </para> - </note> - <para> - <example> - <title><function>strstr</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.13 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr"> + <refnamediv> + <refname>strstr</refname> + <refpurpose>Findet das erste Vorkommen eines Strings</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strstr</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + <methodparam><type>bool</type><parameter>before_needle</parameter></methodparam> + </methodsynopsis> + <para> + Gibt den Teil der Zeichenkette <parameter>haystack</parameter> ab dem + ersten Vorkommen von <parameter>needle</parameter> bis zum Ende von + <parameter>haystack</parameter> zurück. + </para> + <note> + <para> + Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. + Soll die Suche nicht zwischen Groß- und Kleinschreibung unterscheiden, + verwenden Sie <function>stristr</function>. + </para> + </note> + <note> + <para> + Wenn Sie nur herausfinden möchten, ob ein bestimmter + <parameter>needle</parameter> innerhalb von + <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen + die schnellere und weniger speicherintensive Funktion + <function>strpos</function>. + </para> + </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>needle</parameter></term> + <listitem> + <para> + Ist <parameter>needle</parameter> kein String, wird der Parameter in einen + Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>before_needle</parameter></term> + <listitem> + <para> + Ist der Wert auf &true; gesetzt (der Standardwert ist &false;), gibt + <function>strstr</function> den Teil von <parameter>haystack</parameter> + zurück, der sich vor dem ersten Vorkommen von <parameter>needle</parameter> + befindet. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen Teil der Zeichenkette zurück. Wird <parameter>needle</parameter> + nicht gefunden, wird &false; zurückgegeben. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>6.0.0</entry> + <entry> + Der Parameter <parameter>before_needle</parameter> wurde hinzugefügt. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + <function>strstr</function> ist nun binary safe. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strstr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php -$email = 'user@example.com'; +$email = 'name@example.com'; $domain = strstr($email, '@'); echo $domain; // Ausgabe: @example.com + +$user = strstr($email, '@', true); +echo $user; // Ausgabe: name ?> ]]> - </programlisting> - </example> - </para> - <para> - <note> - <para> - Wenn Sie nur herausfinden möchten, ob ein bestimmter - <parameter>needle</parameter> innerhalb von - <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen - die schnellere und weniger speicherintensive Funktion - <function>strpos</function>. - </para> - </note> - </para> - <para> - <function>strstr</function> ist binary safe seit PHP 4.3.0 - </para> - <para> - Siehe auch - <function>preg_match</function>, - <function>stristr</function>, - <function>strpos</function>, - <function>strrchr</function> und - <function>substr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>stristr</function></member> + <member><function>strpos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtolower.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtolower.xml diff -u phpdoc-de/reference/strings/functions/strtolower.xml:1.5 phpdoc-de/reference/strings/functions/strtolower.xml:1.6 --- phpdoc-de/reference/strings/functions/strtolower.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtolower.xml Thu Oct 18 22:41:24 2007 @@ -1,29 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtolower" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtolower</refname> - <refpurpose>Setzt einen String in Kleinbuchstaben um</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtolower</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben - in Kleinbuchstaben umgewandelt wurden. - </para> - <para> - Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist - z. B. die Voreinstellung für locale "C", werden Sonderzeichen - wie Umlaute (ä, ö, ü) nicht umgewandelt. - </para> - <example> - <title><function>strtolower</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtolower"> + <refnamediv> + <refname>strtolower</refname> + <refpurpose>Setzt einen String in Kleinbuchstaben um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtolower</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben + in Kleinbuchstaben umgewandelt wurden. + </para> + <para> + Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist + z. B. die Voreinstellung für locale "C", werden Sonderzeichen + wie Umlaute (ä, ö, ü) nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Zeichenkette in Kleinbuchstaben zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtolower</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Mary Hat Ein Kleines Lamm, und Sie LIEBT Es So."; @@ -31,19 +60,30 @@ echo $str; // Gibt aus: mary hat ein kleines lamm, und sie liebt es so. ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtoupper</function></member> + <member><function>ucfirst</function></member> + <member><function>ucwords</function></member> + <member><function>mb_strtolower</function></member> + </simplelist> + </para> + </refsect1> - ¬e.bin-safe; +</refentry> - <para> - Siehe auch <function>strtoupper</function>, - <function>ucfirst</function>, - <function>ucwords</function> und - <function>mb_strtolower</function>. - </para> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strtoupper.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/strtoupper.xml diff -u phpdoc-de/reference/strings/functions/strtoupper.xml:1.5 phpdoc-de/reference/strings/functions/strtoupper.xml:1.6 --- phpdoc-de/reference/strings/functions/strtoupper.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strtoupper.xml Thu Oct 18 22:41:24 2007 @@ -1,29 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.6 Maintainer: sammywg Status: working --> - <refentry xml:id="function.strtoupper" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strtoupper</refname> - <refpurpose>Setzt einen String in Großbuchstaben um</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strtoupper</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben - in Großbuchstaben umgewandelt wurden. - </para> - <para> - Beachten Sie, dass 'Buchstaben' vom Wert locale abhängig ist. Ist - z. B. die Voreinstellung für locale "C", werden Sonderzeichen - wie Umlaute (ä, ö, ü) nicht umgewandelt. - </para> - <example> - <title><function>strtoupper</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtoupper"> + <refnamediv> + <refname>strtoupper</refname> + <refpurpose>Wandelt alle Zeichen eines Strings in Großbuchstaben um</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strtoupper</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>string</parameter> zurück, in dem alle Buchstaben + in Großbuchstaben umgewandelt wurden. + </para> + <para> + Beachten Sie, dass die Erkennung von 'Buchstaben' vom Wert locale abhängig + ist. Ist z. B. die Voreinstellung für locale "C", werden Sonderzeichen + wie Umlaute (ä, ö, ü) nicht umgewandelt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Zeichenkette in Großbuchstaben zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strtoupper</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Mary Hat Ein Kleines Lamm, und Sie LIEBT Es So."; @@ -31,21 +60,31 @@ echo $str; // Gibt aus: MARY HAT EIN KLEINES LAMM, UND SIE LIEBT ES SO. ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strtolower</function></member> + <member><function>ucfirst</function></member> + <member><function>ucwords</function></member> + <member><function>mb_strtoupper</function></member> + </simplelist> + </para> + </refsect1> - ¬e.bin-safe; +</refentry> - <para> - Siehe auch <function>strtolower</function>, - <function>ucfirst</function>, - <function>ucwords</function> und - <function>mb_strtoupper</function>. - </para> - </refsect1> - </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr-compare.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/strings/functions/substr-compare.xml diff -u phpdoc-de/reference/strings/functions/substr-compare.xml:1.2 phpdoc-de/reference/strings/functions/substr-compare.xml:1.3 --- phpdoc-de/reference/strings/functions/substr-compare.xml:1.2 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr-compare.xml Thu Oct 18 22:41:24 2007 @@ -1,53 +1,131 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: sammywg Status: working --> - <refentry xml:id="function.substr-compare" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr_compare</refname> - <refpurpose> - Binärdaten-sicherer Vergleich zweier Strings, beginnend an einer bestimmten - Position und endend nach einer festgelegten Länge. Der durchgeführte Vergleich - berücksichtigt optional Groß- und Kleinschreibung. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>substr_compare</methodname> - <methodparam><type>string</type><parameter>main_str</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>case_insensitivity</parameter></methodparam> - </methodsynopsis> - - <para> - <function>substr_compare</function> vergleicht <parameter>main_str</parameter> - ab der in <parameter>offset</parameter> definierten Position mit - <parameter>str</parameter>. Die Länge des verglichenen String-Bestandteils - wird vom <parameter>length</parameter>-Parameter bestimmt. - </para> - <para> - Gibt eine Zahl <0 zurück, wenn <parameter>main_str</parameter> ab der in - <parameter>offset</parameter> festgelegten Position kürzer ist als - <parameter>str</parameter>, eine Zahl >0, wenn der ermittelte String länger - ist als <parameter>str</parameter>, und 0, wenn sie gleich sind. - Wenn der Parameter <parameter>length</parameter> gesetzt und gleich oder größer - als die Länge von <parameter>main_str</parameter> ist, gibt - <function>substr_compare</function> eine Warnung aus und hat den - Rückgabewert &false;. - </para> - <para> - Wenn <parameter>case_insensitivity</parameter> &true; ist, wird - der Vergleich unabhängig von der Groß- und Kleinschreibung durchgeführt. - </para> - <para> - <example> - <title>Ein <function>substr_compare</function> Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.7 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-compare"> + <refnamediv> + <refname>substr_compare</refname> + <refpurpose>Binärdaten-sicherer Vergleich zweier Strings, beginnend an einer bestimmten + Position und endend nach einer festgelegten Länge</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>substr_compare</methodname> + <methodparam><type>string</type><parameter>main_str</parameter></methodparam> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>case_insensitivity</parameter></methodparam> + </methodsynopsis> + <para> + <function>substr_compare</function> vergleicht <parameter>main_str</parameter> + ab der in <parameter>offset</parameter> definierten Position mit + <parameter>str</parameter>. Die Länge des verglichenen String-Bestandteils + wird vom <parameter>length</parameter>-Parameter bestimmt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>main_str</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>offset</parameter></term> + <listitem> + <para> + Die Anfangsposition für den Vergleich. Wenn der Wert negativ ist, wird + rückwärts vom Ende der Zeichenkette an gezählt. + The start position for the comparison. If negative, it starts counting + from the end of the string. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Die Länge der zu vergleichenden Zeichensequenz. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>case_insensitivity</parameter></term> + <listitem> + <para> + Wenn <parameter>case_insensitivity</parameter> den Wert &true; hat, + wird der Vergleich ohne Berücksichtigung der Groß- und Kleinschreibung + durchgeführt. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Zahl <0 zurück, wenn <parameter>main_str</parameter> ab der in + <parameter>offset</parameter> festgelegten Position kürzer ist als + <parameter>str</parameter>, eine Zahl >0, wenn der ermittelte String länger + ist als <parameter>str</parameter>, und 0, wenn sie gleich sind. + Wenn der Parameter <parameter>length</parameter> gesetzt und gleich oder größer + als die Länge von <parameter>main_str</parameter> ist, gibt + <function>substr_compare</function> eine Warnung aus und hat den + Rückgabewert &false;. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.1.0</entry> + <entry> + Die Möglichkeit, einen negativen Wert für <parameter>offset</parameter> + festzulegen, wurde eingeführt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>substr_compare</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo substr_compare("abcde", "bc", 1, 2); // 0 +echo substr_compare("abcde", "de", -2, 2); // 0 echo substr_compare("abcde", "bcg", 1, 2); // 0 echo substr_compare("abcde", "BC", 1, 2, true); // 0 echo substr_compare("abcde", "bc", 1, 3); // 1 @@ -55,12 +133,13 @@ echo substr_compare("abcde", "abc", 5, 1); // warning ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> - </refsect1> - </refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr-replace.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/substr-replace.xml diff -u phpdoc-de/reference/strings/functions/substr-replace.xml:1.5 phpdoc-de/reference/strings/functions/substr-replace.xml:1.6 --- phpdoc-de/reference/strings/functions/substr-replace.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr-replace.xml Thu Oct 18 22:41:24 2007 @@ -1,54 +1,103 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.5 Maintainer: sammywg Status: working --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> - <refentry xml:id="function.substr-replace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr_replace</refname> - <refpurpose>Ersetzt Text innerhalb einer Zeichenkette</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>substr_replace</methodname> - <methodparam><type>mixed</type><parameter>string</parameter></methodparam> - <methodparam><type>string</type><parameter>replacement</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - <function>substr_replace</function> ersetzt in einer Kopie von - <parameter>string</parameter> alle Zeichen, die sich innerhalb der - durch die Parameter <parameter>start</parameter> und (optional) - <parameter>length</parameter> festgelegten Grenze befinden, mit der in - <parameter>replacement</parameter> angegebenen Zeichenkette. Der dabei - entstandene String wird zurückgegeben. Ist <parameter>string</parameter> - ein Array, wird auch ein Array zurückgegeben. - </para> - <para> - Ist <parameter>start</parameter> positiv, beginnt die Ersetzung ab der - im Offset-Parameter <parameter>start</parameter> definierten Stelle - innerhalb von <parameter>string</parameter>. - </para> - <para> - Ist <parameter>start</parameter> negativ, wird vom Ende der - Zeichenkette <parameter>string</parameter> bis zum Wert von - <parameter>start</parameter> rückwärts gezählt und dort mit dem - Austausch begonnen. - </para> - <para> - Ist <parameter>length</parameter> angegeben und positiv, stellt - dieser Parameter die Länge des auszuwechselnden Teils von - <parameter>string</parameter> dar. Ist der Wert negativ, gibt er - die Zeichenzahl an, um die ab Ende von <parameter>string</parameter> - rückwärts gezählt wird. Bis zu dieser Stelle erfolgt dann der Austausch. - Ist der Parameter nicht angegeben, wird standardmäßig eine Ersetzung bis - zum Ende des Strings (strlen(<parameter>string</parameter> )) durchgeführt. - </para> - <para> - <example> - <title><function>substr_replace</function>-Beispiel</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr-replace"> + <refnamediv> + <refname>substr_replace</refname> + <refpurpose>Ersetzt Text innerhalb einer Zeichenkette</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>substr_replace</methodname> + <methodparam><type>mixed</type><parameter>string</parameter></methodparam> + <methodparam><type>string</type><parameter>replacement</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + <function>substr_replace</function> ersetzt in einer Kopie von + <parameter>string</parameter> alle Zeichen, die sich innerhalb der + durch die Parameter <parameter>start</parameter> und (optional) + <parameter>length</parameter> festgelegten Grenze befinden, mit der in + <parameter>replacement</parameter> angegebenen Zeichenkette. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replacement</parameter></term> + <listitem> + <para> + Die Ersetzungszeichenkette + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Ist <parameter>start</parameter> positiv, beginnt die Ersetzung ab der + im Offset-Parameter <parameter>start</parameter> definierten Stelle + innerhalb von <parameter>string</parameter>. + </para> + <para> + Ist <parameter>start</parameter> negativ, wird vom Ende der + Zeichenkette <parameter>string</parameter> bis zum Wert von + <parameter>start</parameter> rückwärts gezählt und dort mit dem + Austausch begonnen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Ist der Parameter angegeben und positiv, stellt + dieser Parameter die Länge des auszuwechselnden Teils von + <parameter>string</parameter> dar. Ist der Wert negativ, gibt er + die Zeichenzahl an, um die ab Ende von <parameter>string</parameter> + rückwärts gezählt wird. Bis zu dieser Stelle erfolgt dann der Austausch. + Ist der Parameter nicht angegeben, wird standardmäßig eine Ersetzung bis + zum Ende des Strings (strlen(<parameter>string</parameter> )) durchgeführt, + das heißt, die Ersetzung endet mit dem Ende von <parameter>string</parameter>. + Sollte <parameter>length</parameter> den Wert null haben, wird die + Funktion die Zeichenkette <parameter>replacement</parameter> in + <parameter>string</parameter> an der durch <parameter>start</parameter> + bezeichneten Stelle einfügen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Der entstehende String wird zurückgegeben. Ist <parameter>string</parameter> + ein Array, wird auch ein Array zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>substr_replace</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $var = 'ABCDEFGH:/MNRPQR/'; @@ -62,7 +111,7 @@ /* Einfügen von 'bob' direkt am Anfang von $var. */ echo substr_replace($var, 'bob', 0, 0) . "<br />\n"; -/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var +/* Die nächsten beiden Beispiele ersetzen 'MNRPQR' in $var durch 'bob'. */ echo substr_replace($var, 'bob', 10, -1) . "<br />\n"; echo substr_replace($var, 'bob', -7, -1) . "<br />\n"; @@ -71,18 +120,28 @@ echo substr_replace($var, '', 10, -1) . "<br />\n"; ?> ]]> - </programlisting> - </example> - </para> - - ¬e.bin-safe; - - <para> - Siehe auch <function>str_replace</function> und - <function>substr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + ¬e.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>str_replace</function></member> + <member><function>substr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/substr.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/strings/functions/substr.xml diff -u phpdoc-de/reference/strings/functions/substr.xml:1.8 phpdoc-de/reference/strings/functions/substr.xml:1.9 --- phpdoc-de/reference/strings/functions/substr.xml:1.8 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/substr.xml Thu Oct 18 22:41:24 2007 @@ -1,64 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.12 Maintainer: sammywg Status: ready --> - <refentry xml:id="function.substr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>substr</refname> - <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>substr</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam><type>int</type><parameter>start</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> - <para> - <function>substr</function> gibt den Teil von - <parameter>string</parameter> zurück, der durch die Parameter - <parameter>start</parameter> und <parameter>length</parameter> - definiert wurde. - </para> - <para> - Wenn <parameter>start</parameter> nicht negativ ist, beginnt der zurück - gegebene String an der <parameter>start</parameter>-Position von - <parameter>string</parameter>, angefangen bei <literal>0</literal> - (Null). So ist z.B. im String '<literal>abcdef</literal>' das Zeichen - an der Position <literal>0</literal> gleich '<literal>a</literal>', - das Zeichen an der Position <literal>2</literal> ist - '<literal>c</literal>' usw. - </para> - <example> - <title>Generelle Verwendung von <function>substr</function></title> - <programlisting role="php"> -<![CDATA[ -<?php -echo substr('abcdef', 1); // bcdef -echo substr('abcdef', 1, 3); // bcd -echo substr('abcdef', 0, 4); // abcd -echo substr('abcdef', 0, 8); // abcdef -echo substr('abcdef', -1, 1); // f +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.15 Maintainer: sammywg Status: ready --> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr"> + <refnamediv> + <refname>substr</refname> + <refpurpose>Gibt einen Teil eines Strings zurück</refpurpose> + </refnamediv> -// Auf ein einzelnes Zeichen eines Strings kann auch mittels -// geschweifter Klammern zugegriffen werden -$string = 'abcdef'; -echo $string{0}; // a -echo $string{3}; // d -echo $string{strlen($string)-1}; // f + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>substr</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam><type>int</type><parameter>start</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> + <para> + Gibt den Teil von <parameter>string</parameter> zurück, der durch die + Parameter <parameter>start</parameter> und <parameter>length</parameter> + definiert wurde. + </para> + </refsect1> -?> -]]> - </programlisting> - </example> - <para> - Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene - String bei dem in <parameter>start</parameter> festgelegten Zeichen - vom Ende von <parameter>string</parameter> aus betrachtet. - </para> - <example> - <title>Negativen <parameter>start</parameter>-Wert verwenden</title> - <programlisting role="php"> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>string</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Wenn <parameter>start</parameter> nicht negativ ist, beginnt der + zurückgegebene String an der <parameter>start</parameter>-Position von + <parameter>string</parameter>, angefangen bei <literal>0</literal> + (Null). So ist z.B. im String '<literal>abcdef</literal>' das Zeichen + an der Position <literal>0</literal> gleich '<literal>a</literal>', + das Zeichen an der Position <literal>2</literal> ist + '<literal>c</literal>' usw. + </para> + <para> + Ist <parameter>start</parameter> negativ, beginnt der zurückgegebene + String bei dem in <parameter>start</parameter> festgelegten Zeichen + vom Ende von <parameter>string</parameter> aus betrachtet. + </para> + <para> + <example> + <title>Negativen <parameter>start</parameter>-Wert verwenden</title> + <programlisting role="php"> <![CDATA[ <?php $rest = substr("abcdef", -1); // gibt "f" zurück @@ -66,27 +62,33 @@ $rest = substr("abcdef", -3, 1); // gibt "d" zurück ?> ]]> - </programlisting> - </example> - <para> - Ist <parameter>length</parameter> angegeben und positiv, enthält der - zurückgegebene String höchstens <parameter>length</parameter> Zeichen - ab <parameter>start</parameter> (abhängig von der Länge von - <parameter>string</parameter>). Ist <parameter>string</parameter> - kürzer als oder gleich <parameter>start</parameter> Zeichen, wird &false; - zurückgegeben. - </para> - <para> - Ist <parameter>length</parameter> angegeben und negativ, werden - genau so viele Zeichen vom Ende von <parameter>string</parameter> - abgeschnitten (nachdem die Startposition ermittelt wurde, sollte - <parameter>start</parameter> negativ sein). Gibt - <parameter>start</parameter> eine Position hinter dem abzuschneidenden - Teil an, wird ein leerer String zurückgegeben. - </para> - <example> - <title>Negativen <parameter>length</parameter>-Wert verwenden</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Ist <parameter>length</parameter> angegeben und positiv, enthält der + zurückgegebene String höchstens <parameter>length</parameter> Zeichen + ab <parameter>start</parameter> (abhängig von der Länge von + <parameter>string</parameter>). Ist <parameter>string</parameter> + kürzer als oder gleich <parameter>start</parameter> Zeichen, wird &false; + zurückgegeben. + </para> + <para> + Ist <parameter>length</parameter> angegeben und negativ, werden + genau so viele Zeichen vom Ende von <parameter>string</parameter> + abgeschnitten (nachdem die Startposition ermittelt wurde, sollte + <parameter>start</parameter> negativ sein). Gibt + <parameter>start</parameter> eine Position hinter dem abzuschneidenden + Teil an, wird ein leerer String zurückgegeben. + </para> + <example> + <title>Negativen <parameter>length</parameter>-Wert verwenden</title> + <programlisting role="php"> <![CDATA[ <?php $rest = substr("abcdef", 0, -1); // gibt "abcde" zurück @@ -95,19 +97,65 @@ $rest = substr("abcdef", -3, -1); // gibt "de" zurück ?> ]]> - </programlisting> - </example> - <para> - Siehe auch - <function>strrchr</function>, - <function>substr_replace</function>, - <function>preg_match</function>, - <function>trim</function>, - <function>mb_substr</function> und - <function>wordwrap</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den extrahierten Teil der Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Generelle Verwendung von <function>substr</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +echo substr('abcdef', 1); // bcdef +echo substr('abcdef', 1, 3); // bcd +echo substr('abcdef', 0, 4); // abcd +echo substr('abcdef', 0, 8); // abcdef +echo substr('abcdef', -1, 1); // f + +// Auf ein einzelnes Zeichen eines Strings kann auch mittels +// geschweifter Klammern zugegriffen werden +$string = 'abcdef'; +echo $string{0}; // a +echo $string{3}; // d +echo $string{strlen($string)-1}; // f + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strrchr</function></member> + <member><function>substr_replace</function></member> + <member><function>preg_match</function></member> + <member><function>trim</function></member> + <member><function>mb_substr</function></member> + <member><function>wordwrap</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: