cvs: phpdoc-de /reference/strings/functions strip-tags.xml stripos.xml stripslashes.xml stristr.xml strlen.xml strnatcasecmp.xml strnatcmp.xml
strncasecmp.xml strncmp.xml strpbrk.xml strpos.xml strrchr.xml

From:	Carola 'Sammy' Kummert	Date:	Tue, 23 Oct 2007 23:12:48 +0000
Subject:	cvs: phpdoc-de /reference/strings/functions strip-tags.xml stripos.xml stripslashes.xml stristr.xml strlen.xml strnatcasecmp.xml strnatcmp.xml strncasecmp.xml strncmp.xml strpbrk.xml strpos.xml strrchr.xml
Groups:	php.doc.de
Request:	Send a blank email to doc-de+get-2256@lists.php.net to get a copy of this message

sammywg Tue Oct 23 23:12:48 2007 UTC Modified files: /phpdoc-de/reference/strings/functions strip-tags.xml stripos.xml stripslashes.xml stristr.xml strlen.xml strnatcasecmp.xml strnatcmp.xml strncasecmp.xml strncmp.xml strpbrk.xml strpos.xml strrchr.xml Log: sync to en

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strip-tags.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/strip-tags.xml diff -u phpdoc-de/reference/strings/functions/strip-tags.xml:1.6 phpdoc-de/reference/strings/functions/strip-tags.xml:1.7 --- phpdoc-de/reference/strings/functions/strip-tags.xml:1.6 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strip-tags.xml Tue Oct 23 23:12:47 2007 @@ -1,58 +1,108 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - <refentry xml:id="function.strip-tags" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strip_tags</refname> - <refpurpose>Entfernt HTML- und PHP-Tags aus einem String</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>strip_tags</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion versucht einen String zurückzugeben, der die um alle HTML- - und PHP-Tags reduzierte Version von <parameter>str</parameter> darstellt. - Sie verwendet die gleiche Engine zum Entfernen der Tags wie - <function>fgetss</function>. - </para> - <para> - Sie können den optionalen zweiten Parameter dazu verwenden, Tags, die nicht - entfernt werden sollen, anzugeben. - <note> - <para> - <parameter>allowable_tags</parameter> steht ab PHP 3.0.13 bzw. - PHP 4.0.0 zur Verfügung. - </para> - <para> - Since PHP 4.3.0, HTML comments are also stripped. This is hardcoded and can - not be changed with <parameter>allowable_tags</parameter>. - </para> - </note> - <warning> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strip-tags"> + <refnamediv> + <refname>strip_tags</refname> + <refpurpose>Entfernt HTML- und PHP-Tags aus einem String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strip_tags</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion versucht, einen String zurückzugeben, der die um alle HTML- + und PHP-Tags reduzierte Version von <parameter>str</parameter> darstellt. + Sie verwendet die gleiche Engine zum Entfernen der Tags wie + <function>fgetss</function>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> <para> - Da <function>strip_tags</function> HTML nicht wirklich validiert, kann es - passieren, dass bei unvollständigen oder unkorrekten Tags mehr Text/Daten - gelöscht werden als erwartet. + Die Eingabezeichenkette. </para> - </warning> - <warning> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>allowable_tags</parameter></term> + <listitem> <para> - Diese Funktion modifiziert keine Attribute bei Tags, die via - <parameter>allowable_tags</parameter> erlaubt wurden, dies betrifft auch - <literal>style</literal> und <literal>onmouseover</literal> Attribute, - die ein böswilliger User verwenden kann, um einen Text zu posten, der - von anderen Usern gesehen werden soll. + Sie können die optionalen zweiten Parameter verwenden, um die Tags anzugeben, + die nicht entfernt werden sollen. </para> - </warning> - </para> - <para> - <example> - <title><function>strip_tags</function>-Beispiel</title> - <programlisting role="php"> + <note> + <para> + HTML-Kommentare werden ebenfalls entfernt. Dieses Verhalten ist hartkodiert + und kann nicht mittels <parameter>allowable_tags</parameter> verändert + werden. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die reduzierte Zeichenkette zurück. + </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.0.0</entry> + <entry> + Die Funktion <function>strip_tags</function> ist jetzt Binary safe. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + HTML-Kommentare werden ab jetzt immer entfernt. + </entry> + </row> + <row> + <entry>4.0.0</entry> + <entry> + Der Parameter <parameter>allowable_tags</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strip_tags</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $text = '<p>Test-Absatz.</p> <a href="#fragment">Anderer Text</a>'; @@ -63,25 +113,49 @@ echo strip_tags($text, '<p><a>'); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Test-Absatz. Anderer Text <p>Test-Absatz.</p> <a href="#fragment">Anderer Text</a> ]]> - </screen> - </example> - </para> - <para> - <function>strip_tags</function> ist binary safe seit PHP 5.0.0 - </para> - <para> - Siehe auch - <function>htmlspecialchars</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Da <function>strip_tags</function> HTML nicht wirklich validiert, kann es + passieren, dass bei unvollständigen oder unkorrekten Tags mehr Text/Daten + gelöscht werden als erwartet. + </para> + </warning> + <warning> + <para> + Diese Funktion modifiziert keine Attribute bei Tags, die via + <parameter>allowable_tags</parameter> erlaubt wurden, dies betrifft auch + <literal>style</literal> und <literal>onmouseover</literal> Attribute, + die ein böswilliger User verwenden kann, um einen Text zu posten, der + von anderen Usern gesehen werden soll. + </para> + </warning> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>htmlspecialchars</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.stripos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stripos</refname> - <refpurpose> - Findet das erste Vorkommen eines Strings, unabhängig von Groß- und - Kleinschreibung - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>stripos</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 ersten Vorkommens von - <parameter>needle</parameter> innerhalb des <type>Strings</type> - <parameter>haystack</parameter> zurück. Im Gegensatz zu - <function> strpos</function> ist <function>stripos</function> - unabhängig von Groß- und Kleinschreibung. - </para> - <para> - Beachten Sie, dass <parameter>needle</parameter> eine Zeichenkette von - einem oder mehreren Zeichen sein kann. - </para> - <para> - Wenn <parameter>needle</parameter> nicht gefunden wird, gibt - <function>stripos</function> den <type>boolean</type>-Wert &false; zurück. - </para> - - &return.falseproblem; - - <para> - <example> - <title><function>stripos</function> Beispiele</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripos"> + <refnamediv> + <refname>stripos</refname> + <refpurpose>Findet das erste Vorkommen eines Strings, unabhängig von Groß- und + Kleinschreibung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>stripos</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 ersten Vorkommens von + <parameter>needle</parameter> innerhalb des <type>Strings</type> + <parameter>haystack</parameter> zurück. + </para> + <para> + Im Gegensatz zu + <function> strpos</function> ist <function>stripos</function> + unabhängig von Groß- und Kleinschreibung. + </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 von + einem oder mehreren Zeichen sein kann. + </para> + <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>offset</parameter></term> + <listitem> + <para> + Der optionale Parameter <parameter>offset</parameter> erlaubt Ihnen anzugeben, + ab welchem Zeichen in <parameter>haystack</parameter> die Suche begonnen werden + soll. Die zurückgegebene Position bezieht sich jedoch auf den Anfang von + <parameter>haystack</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Wenn <parameter>needle</parameter> nicht gefunden wird, gibt + <function>stripos</function> den <type>boolean</type>-Wert &false; zurück. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>stripos</function>-Beispiele</title> + <programlisting role="php"> <![CDATA[ <?php $findmich = 'a'; @@ -60,30 +103,34 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <para> - Der optionale Parameter <parameter>offset</parameter> erlaubt Ihnen anzugeben, - ab welchem Zeichen in <parameter>haystack</parameter> die Suche begonnen werden - soll. Die zurückgegebene Position bezieht sich jedoch auf den Anfang von - <parameter>haystack</parameter>. - </para> - - &note.bin-safe; - - <para> - Siehe auch <function>strpos</function>, <function>strrpos</function>, - <function>strrchr</function>, <function>substr</function>, - <function>stristr</function>, <function>strstr</function>, - <function>strripos</function> und <function>str_ireplace</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strpos</function></member> + <member><function>strrpos</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + <member><function>strripos</function></member> + <member><function>str_ireplace</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.stripslashes" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stripslashes</refname> - <refpurpose> - Entfernt Quotes aus einem mittels <function>addslashes</function> - gequoteten String - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>stripslashes</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String zurück, aus dem alle Backslashes ("\") entfernt wurden. - (<literal>\'</literal> wird zu <literal>'</literal> usw.). - Doppelte Rückstriche (<literal>\\</literal>) werden zu einem einfachen - Backslash (<literal>\</literal>) umgesetzt. - </para> - <note> - <para> - Wenn <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link> - eingeschaltet ist, werden keine einfachen Backslashes entfernt, doppelte - jedoch durch einfache Backslashes ersetzt. - </para> - </note> - <para> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripslashes"> + <refnamediv> + <refname>stripslashes</refname> + <refpurpose>Entfernt Quotes aus einem mittels <function>addslashes</function> + gequoteten String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>stripslashes</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Entfernt aus einem gequoteten String alle Quotes. + </para> + <note> + <para> + Wenn <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link> + eingeschaltet ist, werden keine einfachen Backslashes entfernt, doppelte + jedoch durch einfache Backslashes ersetzt. + </para> + </note> + <para> Eine exemplarische Anwendung für <function>stripslashes</function> ergibt sich, wenn die PHP-Direktive <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> auf @@ -37,11 +32,41 @@ übermittelten Daten an anderer Stelle, die eigenes Escaping erfordert (wie z.B. eine Datenbank), einfügen wollen. Zum Beispiel, wenn Sie Daten direkt aus einem HTML-Formular verarbeiten wollen. - </para> - <para> - <example> - <title>Ein <function>stripslashes</function>-Beispiel</title> - <programlisting role="php"> + </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 einen String zurück, aus dem alle Backslashes ("\") entfernt wurden. + (<literal>\'</literal> wird zu <literal>'</literal> usw.). + Doppelte Rückstriche (<literal>\\</literal>) werden zu einem einfachen + Backslash (<literal>\</literal>) umgesetzt. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Ein <function>stripslashes</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = "Ist Ihr Name O\'reilly?"; @@ -50,21 +75,20 @@ echo stripslashes($str); ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - <function>stripslashes</function> ist nicht rekursiv. Wenn Sie die - Funktion auf ein mehrdimensionales Array anwenden wollen, müssen Sie eine - rekursive Funktion verwenden. - </para> - </note> - <para> - <example> - <title>Verwendung von <function>stripslashes</function> in einem - Array</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <note> + <para> + <function>stripslashes</function> ist nicht rekursiv. Wenn Sie die + Funktion auf ein mehrdimensionales Array anwenden wollen, müssen Sie eine + rekursive Funktion verwenden. + </para> + </note> + <para> + <example> + <title>Verwendung von <function>stripslashes</function> in einem Array</title> + <programlisting role="php"> <![CDATA[ <?php function stripslashes_deep($value) @@ -84,9 +108,9 @@ print_r($array); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -100,20 +124,23 @@ ) ]]> - </screen> - </example> - </para> - <para> - Für weitere Informationen über "magic quotes" lesen Sie bitte - <function>get_magic_quotes_gpc</function>. - </para> - <simpara> - Siehe auch - <function>addslashes</function> und - <function>get_magic_quotes_gpc</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>addslashes</function></member> + <member><function>get_magic_quotes_gpc</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.stristr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stristr</refname> - <refpurpose> - Wie <function>strstr</function>, aber ohne Rücksicht auf Groß- bzw. - Kleinschreibung - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>stristr</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - </methodsynopsis> - <para> - Gibt den String <parameter>haystack</parameter> ab dem ersten Vorkommen - von <parameter>needle</parameter> bis zum Ende zurück. - <parameter>needle</parameter> und <parameter>haystack</parameter> - werden dabei ohne Rücksicht auf Groß- oder Kleinschreibung untersucht. - </para> - <para> - Wird <parameter>needle</parameter> nicht gefunden, gibt die Funktion - &false; zurück. - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <para> - <example> - <title><function>stristr</function>-Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stristr"> + <refnamediv> + <refname>stristr</refname> + <refpurpose>Wie <function>strstr</function>, aber ohne Rücksicht auf Groß- bzw. + Kleinschreibung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>stristr</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 String <parameter>haystack</parameter> ab dem ersten Vorkommen + von <parameter>needle</parameter> bis zum Ende zurück. + </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> + 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> + Wenn der Wert auf &true; gesetzt ist (Standardwert ist &false;), gibt + <function>stristr</function> den Teil von <parameter>haystack</parameter> + vor dem ersten Auftreten von <parameter>needle</parameter> zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + <parameter>needle</parameter> und <parameter>haystack</parameter> + werden ohne Rücksicht auf Groß- oder Kleinschreibung untersucht. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den gefundenen Teilstring zurück. Wenn <parameter>needle</parameter> + nicht gefunden wurde, gibt die Funktion &false; zurück. + </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>stristr</function> ist jetzt Binary safe. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>stristr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $email = 'USER@EXAMPLE.com'; - echo stristr($email, 'e'); -// Ausgabe: ER@EXAMPLE.com + echo stristr($email, 'e'); // Ausgabe: ER@EXAMPLE.com + echo stristr($email, 'e', true); // Ausgabe: US ?> ]]> - </programlisting> - </example> - </para> - - <para> - <example> - <title>Prüfen, ob ein String gefunden wurde oder nicht</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title>Prüfen, ob ein String gefunden wurde oder nicht</title> + <programlisting role="php"> <![CDATA[ <?php $string = 'Hallo Welt!'; @@ -58,13 +127,13 @@ // Ausgabe: "Erde" nicht gefunden ?> ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Verwendung eines Wertes, der kein String ist</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + <example> + <title>Verwendung eines Wertes, der kein String ist</title> + <programlisting role="php"> <![CDATA[ <?php $string = 'APFEL'; @@ -72,21 +141,30 @@ // Ausgabe: APFEL ?> ]]> - </programlisting> - </example> - </para> - - &note.bin-safe; - - <para> - Siehe auch - <function>strstr</function>, - <function>strrchr</function>, - <function>substr</function> und - <function>preg_match</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strstr</function></member> + <member><function>strrchr</function></member> + <member><function>substr</function></member> + <member><function>preg_match</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - -<refentry xml:id="function.strlen" xmlns="http://docbook.org/ns/docbook"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strlen"> <refnamediv> <refname>strlen</refname> <refpurpose>Ermitteln der String-Länge</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/strnatcasecmp.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/strings/functions/strnatcasecmp.xml diff -u phpdoc-de/reference/strings/functions/strnatcasecmp.xml:1.7 phpdoc-de/reference/strings/functions/strnatcasecmp.xml:1.8 --- phpdoc-de/reference/strings/functions/strnatcasecmp.xml:1.7 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/strnatcasecmp.xml Tue Oct 23 23:12:47 2007 @@ -1,51 +1,84 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry xml:id="function.strnatcasecmp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>strnatcasecmp</refname> - <refpurpose> - String-Vergleich "natürlicher Ordnung" ohne Unterscheidung der - Schreibweise - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strnatcasecmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion implementiert einen Vergleichsalgorithmus, der - alphanumerische Strings sortiert, wie es ein Mensch täte. Das Verhalten der - Funktion entspricht <function>strnatcmp</function> mit der Ausnahme, dass - der Vergleich ohne Berücksichtigung von Groß- und Kleinschreibungen - durchgeführt wird. Weitere Informationen finden sie auf Martin Pools <link - xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>-Seite. - </para> - <simpara> - Ähnlich anderen String-Vergleichs-Funktionen gibt diese < 0 - zurück, wenn <parameter>str1</parameter> kleiner ist als - <parameter>str2</parameter>, bzw. > 0, wenn - <parameter>str1</parameter> größer ist als - <parameter>str2</parameter>, oder 0, wenn sie gleich sind. - </simpara> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcasecmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strcmp</function>, - <function>strncmp</function>, - <function>strncasecmp</function>, - <function>strnatcmp</function> und - <function>strstr</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.strnatcasecmp"> + <refnamediv> + <refname>strnatcasecmp</refname> + <refpurpose>String-Vergleich "natürlicher Ordnung" ohne Unterscheidung der + Schreibweise</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strnatcasecmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion implementiert einen Vergleichsalgorithmus, der + alphanumerische Strings sortiert, wie es ein Mensch täte. Das Verhalten der + Funktion entspricht <function>strnatcmp</function> mit der Ausnahme, dass + der Vergleich ohne Berücksichtigung von Groß- und Kleinschreibungen + durchgeführt wird. Weitere Informationen finden sie auf Martin Pools <link + xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>-Seite. + </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> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ähnlich anderen String-Vergleichs-Funktionen gibt diese < 0 + zurück, wenn <parameter>str1</parameter> kleiner ist als + <parameter>str2</parameter>, bzw. > 0, wenn + <parameter>str1</parameter> größer ist als + <parameter>str2</parameter>, oder 0, wenn sie gleich sind. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>strcmp</function></member> + <member><function>strcasecmp</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strncasecmp</function></member> + <member><function>strncmp</function></member> + <member><function>strstr</function></member> + <member><function>setlocale</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.strnatcmp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>strnatcmp</refname> - <refpurpose> - String-Vergleich unter Verwendung einer "natürlichen Ordnung" - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strnatcmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <para> + + +<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.strnatcmp"> + <refnamediv> + <refname>strnatcmp</refname> + <refpurpose>String-Vergleich unter Verwendung einer "natürlichen Ordnung"</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strnatcmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + </methodsynopsis> + <para> Diese Funktion implemetiert einen Vergleichsalgorithmus, der alphanumerische Zeichenketten "menschlich" ordnet (auch "natürliche - Ordnung" genannt). Der Unterschied zwischen dieser und der regulären - String-Sortierung eines Computers (wie sie <function>strcmp</function> - verwendet) wird in dem folgenden Beispiel gezeigt: - <informalexample> - <programlisting role="php"> + Ordnung" genannt). Beachten Sie, dass der Vergleich Groß- und Kleinschreibung + berücksichtigt. + </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> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen Wert <0 zurück, wenn <parameter>str1</parameter> kürzer + ist als <parameter>str2</parameter>, einen Wert >0, wenn + <parameter>str1</parameter> länger ist als <parameter>str2</parameter>, + und 0, wenn sie gleich sind. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + Der Unterschied zwischen dieser und der regulären + String-Sortierung eines Computers (wie sie <function>strcmp</function> + verwendet) wird in dem folgenden Beispiel gezeigt: + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $arr1 = $arr2 = array("img12.png", "img10.png", "img2.png", "img1.png"); @@ -34,11 +75,9 @@ print_r($arr2); ?> ]]> - </programlisting> - </informalexample> - Der o.a. Code erzeugt die folgende Ausgabe: - <informalexample> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Normaler String-Vergleich Array @@ -58,37 +97,34 @@ [3] => img12.png ) ]]> - </screen> - </informalexample> - Weitere Informationen finden Sie auf Martin Pools <link - xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>-Seite. - </para> - <simpara> - Ähnlich anderen String-Vergleichs-Funktionen gibt diese < 0 - zurück, wenn <parameter>str1</parameter> kleiner ist als - <parameter>str2</parameter>, bzw. > 0, wenn - <parameter>str1</parameter> größer ist als - <parameter>str2</parameter>, oder 0, wenn sie gleich sind. - </simpara> - <simpara> - Dieser Vergleich berücksichtigt Groß- und Kleinschreibung. - </simpara> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcasecmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strcmp</function>, - <function>strncmp</function>, - <function>strncasecmp</function>, - <function>strnatcasecmp</function>, - <function>strstr</function>, - <function>natsort</function> und - <function>natcasesort</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </informalexample> + Weitere Informationen finden Sie auf Martin Pools <link + xlink:href="&url.strnatcmp;">Natural Order String Comparison</link>-Seite. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>strcasecmp</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strcmp</function></member> + <member><function>strncmp</function></member> + <member><function>strncasecmp</function></member> + <member><function>strnatcasecmp</function></member> + <member><function>strstr</function></member> + <member><function>natsort</function></member> + <member><function>natcasesort</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - + +  - <refentry xml:id="function.strncasecmp" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strncasecmp</refname> - <refpurpose> - Binärdaten-sicherer und groß- und kleinschreibungs-unabhängiger - Stringvergleich der ersten n Zeichen - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strncasecmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam><type>int</type><parameter>len</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion ist identisch zu <function>strcasecmp</function> bis auf den - Unterschied, dass Sie die (Mindest-) Anzahl von Zeichen - (<parameter>len</parameter>), die von jeder Zeichenkette - in den Vergleich einfließen sollen, angeben können.</para> - <simpara> - Gibt einen Wert <0 zurück, wenn <parameter>str1</parameter> kürzer - ist als <parameter>str2</parameter>, einen Wert >0, wenn - <parameter>str1</parameter> länger ist als <parameter>str2</parameter>, - und 0, wenn sie gleich sind. - </simpara> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcasecmp</function>, - <function>strcmp</function>, - <function>substr</function>, - <function>stristr</function> und - <function>strstr</function>. - </simpara> - </refsect1> - </refentry> +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strncasecmp"> + <refnamediv> + <refname>strncasecmp</refname> + <refpurpose>Binärdaten-sicherer und groß- und kleinschreibungs-unabhängiger + Stringvergleich der ersten n Zeichen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strncasecmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + <methodparam><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion ist identisch zu <function>strcasecmp</function> bis auf den + Unterschied, dass Sie die (Mindest-) Anzahl von Zeichen, die von jeder + Zeichenkette in den Vergleich einfließen sollen, angeben können. + </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>len</parameter></term> + <listitem> + <para> + Die Länge der Zeichenkette, die für den Vergleich herangezogen werden soll. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt einen Wert <0 zurück, wenn <parameter>str1</parameter> kürzer + ist als <parameter>str2</parameter>, einen Wert >0, wenn + <parameter>str1</parameter> länger ist als <parameter>str2</parameter>, + und 0, wenn sie gleich sind. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>strcmp</function></member> + <member><function>strcasecmp</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.strncmp" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strncmp</refname> - <refpurpose> - String-Vergleich der ersten n Zeichen (Binary safe) - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strncmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - <methodparam><type>int</type><parameter>len</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion ist ähnlich <function>strcmp</function> mit dem Unterschied, - dass Sie die (maximale) Anzahl Zeichen (<parameter>len</parameter>) angeben - können, die bei jedem String verglichen werden soll. - </para> - <simpara> - Ist <parameter>str1</parameter> kleiner als - <parameter>str2</parameter> wird < 0 zurückgegeben, ist - <parameter>str1</parameter> größer als <parameter>str2</parameter> > 0, - und bei Gleichheit gibt die Funktion 0 zurück. - </simpara> - <simpara> - Dieser Vergleich berücksichtigt Groß- und Kleinschreibung. - </simpara> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strncasecmp</function>, - <function>strcasecmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strcmp</function> und - <function>strstr</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strncmp"> + <refnamediv> + <refname>strncmp</refname> + <refpurpose>String-Vergleich der ersten n Zeichen (Binary safe)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strncmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + <methodparam><type>int</type><parameter>len</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion ist ähnlich <function>strcmp</function> mit dem Unterschied, + dass Sie die (maximale) Anzahl Zeichen (<parameter>len</parameter>) angeben + können, die bei jedem String verglichen werden soll. + </para> + <para> + Beachten Sie, dass der Vergleich Groß- und Kleinschreibung berücksichtigt. + </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>len</parameter></term> + <listitem> + <para> + Die Anzahl der Zeichen, die für den Vergleich herangezogen werden soll. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Ist <parameter>str1</parameter> kleiner als + <parameter>str2</parameter> wird < 0 zurückgegeben, ist + <parameter>str1</parameter> größer als <parameter>str2</parameter> > 0, + und bei Gleichheit gibt die Funktion 0 zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>strcmp</function></member> + <member><function>strcasecmp</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + <member><function>strncasecmp</function></member> + <member><function>strstr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.strpbrk" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strpbrk</refname> - <refpurpose> - Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>strpbrk</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>char_list</parameter></methodparam> - </methodsynopsis> - <para> - <function>strpbrk</function> durchsucht den String <parameter>haystack</parameter> - nach dem ersten Vorkommen eines Zeichens aus <parameter>char_list</parameter>. Die - Funktion gibt den Rest des Strings, beginnend bei der ersten Fundstelle, zurück; - falls kein Zeichen gefunden wird jedoch &false;. - </para> - <note> - <para> - Der <parameter>char_list</parameter> Parameter berücksichtigt - Groß- und Kleinschreibung. - </para> - </note> - <para> - <example> - <title><function>strpbrk</function> Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpbrk"> + <refnamediv> + <refname>strpbrk</refname> + <refpurpose>Durchsucht einen String nach einem Zeichen aus einer Gruppe von Zeichen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strpbrk</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>char_list</parameter></methodparam> + </methodsynopsis> + <para> + <function>strpbrk</function> durchsucht den String <parameter>haystack</parameter> + nach dem ersten Vorkommen eines Zeichens aus <parameter>char_list</parameter>. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>haystack</parameter></term> + <listitem> + <para> + Die Zeichenkette, in der <parameter>char_list</parameter> gesucht werden + soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>char_list</parameter></term> + <listitem> + <para> + Dieser Parameter berücksichtigt Groß- und Kleinschreibung. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Rest des Strings, beginnend bei der ersten Fundstelle, zurück; + falls kein Zeichen gefunden wird jedoch &false;. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strpbrk</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php @@ -43,11 +71,13 @@ echo strpbrk($text, 'T'); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.strpos" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strpos</refname> - <refpurpose> - Sucht das erste Vorkommen des Suchstrings - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strpos</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpos"> + <refnamediv> + <refname>strpos</refname> + <refpurpose>Sucht das erste Vorkommen des Suchstrings</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strpos</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>mixed</type><parameter>needle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para> Gibt die numerische Position des ersten Vorkommens von <parameter>needle</parameter> innerhalb der Zeichenkette <parameter>haystack</parameter> zurück. Anders als - <function>strrpos</function> akzeptiert diese Funktion eine komplette + <function>strrpos</function> vor PHP 5 akzeptiert diese Funktion eine komplette Zeichenkette als <parameter>needle</parameter>-Parameter und verwendet den gesamten String zur Suche. </para> - <para> - Wurde <parameter>needle</parameter> nicht gefunden, gibt - <function>strpos</function> den <type>boolean</type>-Wert &false; zurück. - </para> + </refsect1> - &return.falseproblem; - &note.bin-safe; - <para> - <example> - <title><function>strpos</function>-Beispiel:</title> - <programlisting role="php"> + <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> + 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>offset</parameter></term> + <listitem> + <para> + Der optionale Parameter <parameter>offset</parameter> ermöglicht + es Ihnen, die Startposition für die Suche innerhalb von + <parameter>haystack</parameter> anzugeben. Die zurück gegebene + Positions-Angabe ist dann relativ zum Anfang von + <parameter>haystack</parameter>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Position als Integerwert zurück. Wurde <parameter>needle</parameter> + nicht gefunden, gibt <function>strpos</function> den <type>boolean</type>-Wert + &false; zurück. + </para> + &return.falseproblem; + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strpos</function>-Beispiel:</title> + <programlisting role="php"> <![CDATA[ <?php $meinString = 'abc'; @@ -46,9 +87,9 @@ // nicht das erwartete Ergebnis, da die Position von 'a' die nullte Stelle // (also das erste Zeichen) ist if ($pos === false) { - echo "Der Stringg '$findMich' wurde nicht im String '$meinString' gefunden"; + echo "Der String '$findMich' wurde nicht im String '$meinString' gefunden"; } else { - echo "Der Stringg '$findMich' wurde im String '$meinString' gefunden"; + echo "Der String '$findMich' wurde im String '$meinString' gefunden"; echo " und steht an Stelle $pos"; } @@ -57,32 +98,33 @@ $pos = strpos($newstring, 'a', 1); // $pos = 7, nicht 0 ?> ]]> - </programlisting> - </example> - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - </para> - <para> - Der optionale Parameter <parameter>offset</parameter> ermöglicht - es Ihnen, die Startposition für die Suche innerhalb von - <parameter>haystack</parameter> anzugeben. Die zurück gegebene - Positions-Angabe ist dann relativ zum Anfang von - <parameter>haystack</parameter>. - </para> - <para> - Siehe auch - <function>strrpos</function>, - <function>stripos</function>, - <function>strripos</function>, - <function>strrchr</function>, - <function>substr</function>, - <function>stristr</function> und - <function>strstr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strrpos</function></member> + <member><function>stripos</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> +  - - - <refentry xml:id="function.strrchr" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strrchr</refname> - <refpurpose> - Sucht das letzte Vorkommen eines Zeichens in einem String - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>strrchr</methodname> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion gibt den letzten Teil von <parameter>haystack</parameter> - beginnend mit dem letzten Vorkommen von <parameter>needle</parameter> - bis zum Ende von <parameter>haystack</parameter> zurück. - </para> - <para> - Wird <parameter>needle</parameter> nicht gefunden, gibt die Funktion - &false; zurück. - </para> - <para> - Enthält <parameter>needle</parameter> mehr als ein Zeichen, wird nur das - erste Zeichen verwendet. Damit unterscheidet sich das Verhalten der - Funktion gegenüber <function>strchr</function>. - </para> - <para> - Ist <parameter>needle</parameter> kein String, wird der Parameter in einen - Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. - <example> - <title><function>strrchr</function>-Beispiel:</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strrchr"> + <refnamediv> + <refname>strrchr</refname> + <refpurpose>Sucht das letzte Vorkommen eines Zeichens in einem String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>strrchr</methodname> + <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <methodparam><type>string</type><parameter>needle</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion gibt den letzten Teil von <parameter>haystack</parameter> + beginnend mit dem letzten Vorkommen von <parameter>needle</parameter> + bis zum Ende von <parameter>haystack</parameter> zurück. + </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> + Enthält <parameter>needle</parameter> mehr als ein Zeichen, wird nur das + erste Zeichen verwendet. Damit unterscheidet sich das Verhalten der + Funktion gegenüber <function>strchr</function>. + </para> + <para> + Ist <parameter>needle</parameter> kein String, wird der Parameter in einen + Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Funktion gibt den einen Teil der Zeichenkette zurück, wird + <parameter>needle</parameter> nicht gefunden, ist der 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>4.3.0</entry> + <entry> + Die Funktion ist jetzt Binary safe. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strrchr</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php // hole das letzte Verzeichnis aus $PATH @@ -46,20 +98,29 @@ $last = substr (strrchr ($text, 10), 1 ); ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>strrchr</function> ist binary safe seit PHP 4.3.0 - </para> - <para> - Siehe auch - <function>strstr</function>, - <function>substr</function> und - <function>stristr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strstr</function></member> + <member><function>substr</function></member> + <member><function>stristr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables:

cvs: phpdoc-de /reference/strings/functions strip-tags.xml stripos.xml stripslashes.xml stristr.xml strlen.xml strnatcasecmp.xml strnatcmp.xml strncasecmp.xml strncmp.xml strpbrk.xml strpos.xml strrchr.xml

cvs: phpdoc-de /reference/strings/functions strip-tags.xml stripos.xml stripslashes.xml stristr.xml strlen.xml strnatcasecmp.xml strnatcmp.xml
strncasecmp.xml strncmp.xml strpbrk.xml strpos.xml strrchr.xml