cvs: phpdoc-de /reference/strings/functions sscanf.xml str-ireplace.xml str-pad.xml str-repeat.xml str-replace.xml str-rot13.xml str-shuffle.xml
str-split.xml strcasecmp.xml strchr.xml strcmp.xml strcoll.xml strcspn.xml stripcslashes.xml

From:	Carola 'Sammy' Kummert	Date:	Wed, 24 Oct 2007 22:20:05 +0000
Subject:	cvs: phpdoc-de /reference/strings/functions sscanf.xml str-ireplace.xml str-pad.xml str-repeat.xml str-replace.xml str-rot13.xml str-shuffle.xml str-split.xml strcasecmp.xml strchr.xml strcmp.xml strcoll.xml strcspn.xml stripcslashes.xml
Groups:	php.doc.de
Request:	Send a blank email to doc-de+get-2257@lists.php.net to get a copy of this message

sammywg Wed Oct 24 22:20:05 2007 UTC Modified files: /phpdoc-de/reference/strings/functions sscanf.xml str-ireplace.xml str-pad.xml str-repeat.xml str-replace.xml str-rot13.xml str-shuffle.xml str-split.xml strcasecmp.xml strchr.xml strcmp.xml strcoll.xml strcspn.xml stripcslashes.xml Log: sync to en

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/sscanf.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/strings/functions/sscanf.xml diff -u phpdoc-de/reference/strings/functions/sscanf.xml:1.6 phpdoc-de/reference/strings/functions/sscanf.xml:1.7 --- phpdoc-de/reference/strings/functions/sscanf.xml:1.6 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/sscanf.xml Wed Oct 24 22:20:05 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - + + <refentry xml:id="function.sscanf" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>sscanf</refname> @@ -60,7 +60,7 @@ // Ermittlung der Autoren-Info und Erzeugung eines DocBook-Eintrages $auth = "24\tLewis Carroll"; $n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); -echo "<author xml:id='$id'> +echo "<author id='$id'> <firstname>$first</firstname> <surname>$last</surname> </author>\n"; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/strings/functions/str-ireplace.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/strings/functions/str-ireplace.xml diff -u phpdoc-de/reference/strings/functions/str-ireplace.xml:1.5 phpdoc-de/reference/strings/functions/str-ireplace.xml:1.6 --- phpdoc-de/reference/strings/functions/str-ireplace.xml:1.5 Sat Jun 23 13:21:50 2007 +++ phpdoc-de/reference/strings/functions/str-ireplace.xml Wed Oct 24 22:20:05 2007 @@ -1,88 +1,157 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - <refentry xml:id="function.str-ireplace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_ireplace</refname> - <refpurpose> - Groß- und Kleinschreibungsunabhängige Version von - <function>str_replace</function>. - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>mixed</type><methodname>str_ireplace</methodname> - <methodparam><type>mixed</type><parameter>search</parameter></methodparam> - <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> - <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">count</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion gibt einen String oder ein Array zurück, in dem alle - Vorkommen von <parameter>search</parameter> innerhalb von - <parameter>subject</parameter> unabhängig von deren Groß- oder Kleinschreibung - gegen den entsprechenden <parameter>replace</parameter>-Wert ausgetauscht - wurden. Sofern Sie keine speziellen Ersetzungsregeln verwenden, sollten Sie - diese Funktion grundsätzlich anstelle von <function>eregi_replace</function> - oder <function>preg_replace</function> mit <literal>i</literal>-Modifier - verwenden. - </para> - <para> - Ist <parameter>subject</parameter> ein Array, wird die - Suchen-Ersetzen-Funktionalität auf jedes Element von - <parameter>subject</parameter> angewendet. Die Funktion gibt - dann natürlich ein Array zurück. - </para> - <para> - Sind <parameter>search</parameter> und <parameter>replace</parameter> - Arrays, dann verwendet <function>str_ireplace</function> aus beiden Arrays - den Wert der aktuellen Zeigerposition, um damit ein Suchen und Ersetzen - in <parameter>subject</parameter> durchzuführen. Hat - <parameter>replace</parameter> weniger Werte als <parameter>search</parameter> - wird ein leerer String als Wert zum Ersetzen verwendet. Isst - <parameter>search</parameter> ein Array und <parameter>replace</parameter> - ein String, wird dieser String als Ersetzung für jeden Wert von - <parameter>search</parameter> verwendet. - </para> - <note> - <para> - Jede Ersetzung aus dem <parameter>search</parameter>-Array wird auf dem - Ergebnis der jeweils vorhergehenden Ersetzung ausgeführt. - </para> - </note> - <para> - <example> - <title><function>str_ireplace</function> Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-ireplace"> + <refnamediv> + <refname>str_ireplace</refname> + <refpurpose>Groß- und kleinschreibungsunabhängige Version von + <function>str_replace</function></refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>str_ireplace</methodname> + <methodparam><type>mixed</type><parameter>search</parameter></methodparam> + <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> + <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">count</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion gibt einen String oder ein Array zurück, in dem alle + Vorkommen von <parameter>search</parameter> innerhalb von + <parameter>subject</parameter> unabhängig von deren Groß- oder Kleinschreibung + gegen den entsprechenden <parameter>replace</parameter>-Wert ausgetauscht + wurden. Sofern Sie keine speziellen Ersetzungsregeln verwenden, sollten Sie + diese Funktion grundsätzlich anstelle von <function>eregi_replace</function> + oder <function>preg_replace</function> mit <literal>i</literal>-Modifier + verwenden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>search</parameter></term> + <listitem> + <note> + <para> + Jede Ersetzung aus dem <parameter>search</parameter>-Array wird auf dem + Ergebnis der jeweils vorhergehenden Ersetzung ausgeführt. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replace</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>subject</parameter></term> + <listitem> + <para> + Ist <parameter>subject</parameter> ein Array, wird die + Suchen-Ersetzen-Funktionalität auf jedes Element von + <parameter>subject</parameter> angewendet. Die Funktion gibt + dann natürlich ein Array zurück. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>count</parameter></term> + <listitem> + <para> + Die Anzahl der gefundenen und ersetzten Textstellen <parameter>needle</parameter> + wird mittels der an den Parameter <parameter>count</parameter> als + Referenz übergebenen Variablen zurückgegeben. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Sind <parameter>search</parameter> und <parameter>replace</parameter> + Arrays, dann verwendet <function>str_ireplace</function> aus beiden Arrays + den Wert der aktuellen Zeigerposition, um damit ein Suchen und Ersetzen + in <parameter>subject</parameter> durchzuführen. Hat + <parameter>replace</parameter> weniger Werte als <parameter>search</parameter>, + wird ein leerer String als Wert zum Ersetzen der verbleibenden Elemente + verwendet. Ist <parameter>search</parameter> ein Array und + <parameter>replace</parameter> ein String, wird dieser String als Ersetzung + für jeden Wert von <parameter>search</parameter> verwendet. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Zeichenkette oder ein Array mit ersetzten Werten 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> + Der Parameter <parameter>count</parameter> wurde hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>str_ireplace</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $bodytag = str_ireplace("%body%", "schwarz", "<body text=%BODY%>"); ?> ]]> - </programlisting> - </example> - </para> - <para> - Diese Funktion ist binary safe. - </para> - <note> - <simpara> - Seit PHP 5.0.0 wird die Anzahl der gefundenen und ersetzten - <parameter>needles</parameter> im Parameter - <parameter>count</parameter> als Referenz zurückgegeben. - Der Parameter steht nicht in PHP-Versionen vor 5.0.0 zur Verfügung. - </simpara> - </note> - <para> - Siehe auch: - <function>str_replace</function>, - <function>preg_replace</function> und - <function>strtr</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>str_replace</function></member> + <member><function>preg_replace</function></member> + <member><function>strtr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.str-pad" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_pad</refname> - <refpurpose> - Erweitert einen String auf eine bestimmte Länge unter Verwendung - eines anderen Strings - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>str_pad</methodname> - <methodparam><type>string</type><parameter>input</parameter></methodparam> - <methodparam><type>int</type><parameter>pad_length</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>pad_string</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>pad_type</parameter></methodparam> - </methodsynopsis> - <para> - Die Funktion gibt den <parameter>input</parameter>-String, erweitert auf - der linken, rechten oder auf beiden Seiten um die angegebene Länge, zurück. - Wenn das optionale Argument <parameter>pad_string</parameter> nicht - angegeben ist, wird <parameter>input</parameter> durch Leerzeichen - erweitert, anderenfalls bis zum Ende durch die in - <parameter>pad_string</parameter> angegebenen Zeichen. - </para> - <para> - Das optionale Argument <parameter>pad_type</parameter> kann - <constant>STR_PAD_RIGHT</constant>, <constant>STR_PAD_LEFT</constant> oder - <constant>STR_PAD_BOTH</constant> sein. Wird - <parameter>pad_type</parameter> nicht angegeben, so wird standardmäßig von - <constant>STR_PAD_RIGHT</constant> ausgegangen. - </para> - <para> - Ist der Wert von <parameter>pad_length</parameter> negativ oder - kleiner als die Länge des Input-Strings, wird keine Erweiterung - vorgenommen. - </para> - <para> - <example> - <title><function>str_pad</function>-Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-pad"> + <refnamediv> + <refname>str_pad</refname> + <refpurpose>Erweitert einen String unter Verwendung eines anderen Strings + auf eine bestimmte Länge</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>str_pad</methodname> + <methodparam><type>string</type><parameter>input</parameter></methodparam> + <methodparam><type>int</type><parameter>pad_length</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>pad_string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>pad_type</parameter></methodparam> + </methodsynopsis> + <para> + Die Funktion gibt den <parameter>input</parameter>-String, erweitert auf + der linken, rechten oder auf beiden Seiten um die angegebene Länge, zurück. + Wenn das optionale Argument <parameter>pad_string</parameter> nicht + angegeben ist, wird <parameter>input</parameter> durch Leerzeichen + erweitert, anderenfalls bis zum Ende durch die in + <parameter>pad_string</parameter> angegebenen Zeichen. + </para> + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>input</parameter></term> + <listitem> + <para> + Die Eingabezeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pad_length</parameter></term> + <listitem> + <para> + Ist der Wert von <parameter>pad_length</parameter> negativ oder + kleiner als die Länge des Input-Strings, wird keine Erweiterung + vorgenommen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>pad_string</parameter></term> + <listitem> + <note> + <para> + Das optionale Argument <parameter>pad_type</parameter> kann + <constant>STR_PAD_RIGHT</constant>, <constant>STR_PAD_LEFT</constant> oder + <constant>STR_PAD_BOTH</constant> sein. Wird + <parameter>pad_type</parameter> nicht angegeben, so wird standardmäßig von + <constant>STR_PAD_RIGHT</constant> ausgegangen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die erweiterte Zeichenkette zurück. + </para> + </refsect1> + + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>str_pad</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $input = "Alien"; @@ -52,19 +90,13 @@ echo str_pad($input, 6 , "___"); // ergibt "Alien_" ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - <parameter>pad_string</parameter> kann abgeschnitten werden, wenn die - erforderliche Anzahl der erweiternden Zeichen aufgrund der Länge von - <parameter>pad_string</parameter> nicht in zwei gleiche Teile geteilt - werden kann. - </para> - </note> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.str-repeat" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_repeat</refname> - <refpurpose>Wiederholt einen String</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>str_repeat</methodname> - <methodparam><type>string</type><parameter>input</parameter></methodparam> - <methodparam><type>int</type><parameter>multiplier</parameter></methodparam> - </methodsynopsis> - <para> - Gibt <parameter>input</parameter> <parameter>multiplier</parameter> - mal zurück, wobei <parameter>multiplier</parameter> größer als oder gleich - 0 sein muss. Wenn <parameter>multiplier</parameter> den Wert 0 hat, gibt - die Funktion einen leeren String zurück. - </para> - <example> - <title><function>str_repeat</function>-Beispiel:</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-repeat"> + <refnamediv> + <refname>str_repeat</refname> + <refpurpose>Wiederholt einen String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>str_repeat</methodname> + <methodparam><type>string</type><parameter>input</parameter></methodparam> + <methodparam><type>int</type><parameter>multiplier</parameter></methodparam> + </methodsynopsis> + <para> + Gibt <parameter>input</parameter> <parameter>multiplier</parameter> + mal zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>input</parameter></term> + <listitem> + <para> + Die zu wiederholende Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>multiplier</parameter></term> + <listitem> + <para> + Die Anzahl der Wiederholungen, die auf <parameter>input</parameter> + angewendet werden sollen. + </para> + <para> + <parameter>multiplier</parameter> muss größer als oder gleich 0 sein. + Wenn <parameter>multiplier</parameter> den Wert 0 hat, gibt + die Funktion einen leeren String zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die wiederholte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <example> + <title><function>str_repeat</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php echo str_repeat("-=", 10); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ -=-=-=-=-=-=-=-=-=-= ]]> - </screen> - </example> - <para> - Siehe auch <link linkend="control-structures.for">for</link>, - <function>str_pad</function> und - <function>substr_count</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><link linkend="control-structures.for">for</link></member> + <member><function>str_pad</function></member> + <member><function>substr_count</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.str-replace" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_replace</refname> - <refpurpose> - Ersetzt alle Vorkommen des Suchstrings durch einen anderen String - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>str_replace</methodname> - <methodparam><type>mixed</type><parameter>search</parameter></methodparam> - <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> - <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter role="reference">count</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion gibt einen String oder ein Array zurück, in dem alle - Vorkommen von <parameter>search</parameter> innerhalb von - <parameter>subject</parameter> durch den angegebenen - <parameter>replace</parameter>-Wert ersetzt wurden. Wenn Sie keine - ausgefallenen Ersetzungsregeln (wie Regular Expressions) benötigen, sollten - Sie immer diese Funktion anstelle von <function>ereg_replace</function> - oder <function>preg_replace</function> verwenden. - </para> - <para> - Seit PHP 4.0.5 kann jeder Parameter von <function>str_replace</function> - vom Type <type>array</type> sein. - </para> - <warning> - <simpara> - Die PHP-Versionen vor PHP 4.3.3 enthalten einen Bug, der bei der - Verwendung von Arrays für <parameter>search</parameter> und - <parameter>replace</parameter> dazu führt, dass leere - <parameter>search</parameter>-Indexe übersprungen werden, ohne dabei den - internen Zeiger innerhalb des <parameter>replace</parameter>-Arrays - ebenfalls weiter zu bewegen. Dies wurde in PHP 4.3.3 korrigiert. Alle - Skripte, die sich auf diesen Bug verlassen, sollten leere Suchwerte - entfernen, bevor diese Funktion aufgerufen wird, um die ursprüngliche - Verhalten zu imitieren. - </simpara> - </warning> - <para> - Ist <parameter>subject</parameter> ein Array, erfolgt das Suchen - und Ersetzen für jeder Wert von <parameter>subject</parameter>, - und der Rückgabewert ist ebenfalls ein Array. - </para> - <para> - Sind <parameter>search</parameter> und <parameter>replace</parameter> - Arrays, nimmt <function>str_replace</function> je einen Wert beider Arrays - und verwendet diese zum Suchen und Ersetzen in - <parameter>subject</parameter>. Hat <parameter>replace</parameter> - weniger Werte als <parameter>search</parameter>, so wird ein leerer - String zum Ersetzen für den Rest der Werte verwendet. Ist - <parameter>search</parameter> ein Array und <parameter>replace</parameter> - ein String, dann wird dieser String für jeden Wert von - <parameter>search</parameter> angewandt. Das Gegenteil ist nicht sinnvoll. - </para> - <para> - Sind <parameter>search</parameter> und/oder <parameter>replace</parameter> - Arrays, werden ihre Elemente vom ersten zum letzten hin verarbeitet. - </para> - <para> - <example> - <title><function>str_replace</function>-Beispiele</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-replace"> + <refnamediv> + <refname>str_replace</refname> + <refpurpose>Ersetzt alle Vorkommen des Suchstrings durch einen anderen String</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>str_replace</methodname> + <methodparam><type>mixed</type><parameter>search</parameter></methodparam> + <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> + <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">count</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion gibt einen String oder ein Array zurück, in dem alle + Vorkommen von <parameter>search</parameter> innerhalb von + <parameter>subject</parameter> durch den angegebenen + <parameter>replace</parameter>-Wert ersetzt wurden. + </para> + <para> + Wenn Sie keine ausgefallenen Ersetzungsregeln (wie Reguläre Ausdrücke) + benötigen, sollten Sie immer diese Funktion anstelle von + <function>ereg_replace</function> oder <function>preg_replace</function> + verwenden. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + Sind <parameter>search</parameter> und <parameter>replace</parameter> + Arrays, nimmt <function>str_replace</function> je einen Wert beider Arrays + und verwendet diese zum Suchen und Ersetzen in + <parameter>subject</parameter>. Hat <parameter>replace</parameter> + weniger Werte als <parameter>search</parameter>, so wird ein leerer + String zum Ersetzen für den Rest der Werte verwendet. Ist + <parameter>search</parameter> ein Array und <parameter>replace</parameter> + ein String, dann wird dieser String für jeden Wert von + <parameter>search</parameter> angewandt. Das Gegenteil ist nicht sinnvoll. + </para> + <para> + Sind <parameter>search</parameter> und/oder <parameter>replace</parameter> + Arrays, werden ihre Elemente vom ersten zum letzten hin verarbeitet. + </para> + <para> + <variablelist> + <varlistentry> + <term><parameter>search</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>replace</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>subject</parameter></term> + <listitem> + <para> + Ist <parameter>subject</parameter> ein Array, erfolgt das Suchen + und Ersetzen für jeder Wert von <parameter>subject</parameter>, + und der Rückgabewert ist ebenfalls ein Array. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>count</parameter></term> + <listitem> + <note> + <simpara> + Sofern angegeben, enthält der Parameter die Anzahl der gefunden und + ersetzten Textstellen. + </simpara> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten + 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> + Der Parameter <parameter>count</parameter> wurde hinzugefügt. + </entry> + </row> + <row> + <entry>4.3.3</entry> + <entry> + Das Verhalten der Funktion wurde verändert. Ältere Versionen enthalten + einen Bug, der bei der Verwendung von Arrays für + <parameter>search</parameter> und <parameter>replace</parameter> dazu + führt, dass leere <parameter>search</parameter>-Indexe übersprungen + werden, ohne dabei den internen Zeiger innerhalb des + <parameter>replace</parameter>-Arrays ebenfalls weiter zu bewegen. Dies + wurde in PHP 4.3.3 korrigiert. Alle Skripte, die sich auf diesen Bug + verlassen, sollten leere Suchwerte entfernen, bevor diese Funktion + aufgerufen wird, um die ursprüngliche Verhalten zu imitieren. + </entry> + </row> + <row> + <entry>4.0.5</entry> + <entry> + Die meisten Parameter können vom Typ <type>array</type> sein. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>str_replace</function>-Beispiele</title> + <programlisting role="php"> <![CDATA[ <?php // Liefert: <body text='schwarz'> @@ -94,31 +173,45 @@ // Verarbeitet \r\n's zuerst, so dass sie nicht doppelt konvertiert werden $newstr = str_replace($order, $replace, $str); +// Ausgabe: apearpearle pear +$letters = array('a', 'p'); +$fruit = array('apple', 'pear'); +$text = 'a p'; +$output = str_replace($letters, $fruit, $text); +echo $output; ?> ]]> - </programlisting> - </example> - </para> - - &note.bin-safe; - - <note> - <simpara> - Ab PHP 5.0.0 wird die Anzahl der gefundenen und ersetzten Suchbegriffe - (<parameter>search</parameter>) mittels <parameter>count</parameter> - zurück gegeben, der als Referenz übergeben wird. Vor PHP 5.0.0 ist dieser - Parameter nicht verfügbar. - </simpara> - </note> - <para> - Siehe auch - <function>str_ireplace</function>, - <function>substr_replace</function>, - <function>preg_replace</function> und - <function>strtr</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + <note> + <para> + Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie + <function>str_ireplace</function>, wenn Sie beim Ersetzen unabhängig von + der Groß- und Kleinschreibung sein wollen. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>str_ireplace</function></member> + <member><function>substr_replace</function></member> + <member><function>preg_replace</function></member> + <member><function>strtr</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id='function.str-rot13' xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_rot13</refname> - <refpurpose>Führt die rot13-Transformation auf einen String aus</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>str_rot13</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion führt die ROT13-Transformation auf die Zeichenkette - <parameter>str</parameter> aus und liefert den Ergebnisstring zurück. - ROT13 verschiebt einfach jeden Buchstaben um 13 Stellen im Alphabet. - Zeichen, die keine Buchstaben sind, bleiben unverändert. Verschlüsselung - und Entschlüsselung werden von derselben Funktion durchgeführt. Bei - Übergabe eines verschlüsselten Strings wird der Originalstring - zurückgegeben. - </para> - <para> - <example> - <title><function>str_rot13</function>-Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id='function.str-rot13'> + <refnamediv> + <refname>str_rot13</refname> + <refpurpose>Führt die ROT13-Transformation auf einen String aus</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>str_rot13</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion führt die ROT13-Transformation auf die Zeichenkette + <parameter>str</parameter> aus und liefert den Ergebnisstring zurück. + </para> + <para> + Die ROT13-Kodierung verschiebt einfach jeden Buchstaben um 13 Stellen im Alphabet. + Zeichen, die keine Buchstaben sind, bleiben unverändert. Verschlüsselung + und Entschlüsselung werden von derselben Funktion durchgeführt. Bei + Übergabe eines verschlüsselten Strings wird der Originalstring + zurückgegeben. + </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 ROT13-Version der angegebenen Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>str_rot13</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php @@ -32,18 +62,39 @@ ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Das Verhalten dieser Funktion war vor PHP Version 4.3.0 fehlerhaft. Davor - wurde der <parameter>str</parameter>-Parameter selbst verändert, wenn er - als Reference übergeben wurde. - </para> - </note> - </refsect1> - </refentry> + </programlisting> + </example> + </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> + Das Verhalten dieser Funktion wurde korrigiert. Vor der Korrektur + wurde der <parameter>str</parameter>-Parameter selbst ebenfalls + verändert, als wenn er als Reference übergeben worden wäre. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.str-shuffle" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_shuffle</refname> - <refpurpose>Mischt einen String nach dem Zufallsprinzip</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>string</type><methodname>str_shuffle</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>str_shuffle</function> mischt eine Zeichenkette. Es entsteht eine - Permutation aller vorhandenen Zeichen. - </simpara> - <para> - <example> - <title><function>str_shuffle</function> Beispiel</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-shuffle"> + <refnamediv> + <refname>str_shuffle</refname> + <refpurpose>Mischt einen String nach dem Zufallsprinzip</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>str_shuffle</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <simpara> + <function>str_shuffle</function> mischt eine Zeichenkette. Es entsteht eine + Permutation aller vorhandenen Zeichen. + </simpara> + </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 vermischte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>str_shuffle</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $str = 'abcdef'; @@ -29,14 +57,23 @@ echo $shuffled; ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch <function>shuffle</function> und <function>rand</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shuffle</function></member> + <member><function>rand</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - <refentry xml:id="function.str-split" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>str_split</refname> - <refpurpose> - Konvertiert einen String in ein Array - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>str_split</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>split_length</parameter></methodparam> - </methodsynopsis> - <para> - Konvertiert einen String in ein Array. Wenn der optionale Parameter - <parameter>split_length</parameter> angegeben ist, enthält das zurückgegebene - Array Elemente mit der in <parameter>split_length</parameter> definierten - Länge, andernfalls enthält jedes Element ein einzelnes Zeichen. - </para> - <para> - &false; wird zurückgegeben, wenn <parameter>split_length</parameter> kleiner - als 1 ist. Wenn der Parameter <parameter>split_length</parameter> größer - als <parameter>string</parameter> ist, wird der gesamte String - als ein erstes (und einziges) Array-Element zurückgegeben. - </para> - <para> - <example> - <title>Beispiel für die Verwendung von <function>str_split</function></title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-split"> + <refnamediv> + <refname>str_split</refname> + <refpurpose>Konvertiert einen String in ein Array</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>str_split</methodname> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>split_length</parameter></methodparam> + </methodsynopsis> + <para> + Konvertiert einen String in ein Array. + </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>split_length</parameter></term> + <listitem> + <para> + Maximale Länge eines Teilstücks. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Wenn der optionale Parameter <parameter>split_length</parameter> angegeben + ist, enthält das zurückgegebene Array Elemente mit der in + <parameter>split_length</parameter> definierten Länge, andernfalls enthält + jedes Element ein einzelnes Zeichen. + </para> + <para> + &false; wird zurückgegeben, wenn <parameter>split_length</parameter> kleiner + als 1 ist. Wenn der Parameter <parameter>split_length</parameter> größer + als <parameter>string</parameter> ist, wird der gesamte String + als ein erstes (und einziges) Array-Element zurückgegeben. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Beispiel für die Verwendung von <function>str_split</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -44,11 +78,9 @@ ?> ]]> - </programlisting> - <para> - Die Ausgabe sieht dann so aus: - </para> - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -74,20 +106,27 @@ [3] => und ) ]]> - </screen> - </example> - </para> - <para> - Siehe auch - <function>chunk_split</function>, - <function>preg_split</function>, - <function>explode</function>, - <function>count_chars</function>, - <function>str_word_count</function> und - <link linkend="control-structures.for">for</link>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>chunk_split</function></member> + <member><function>preg_split</function></member> + <member><function>explode</function></member> + <member><function>count_chars</function></member> + <member><function>str_word_count</function></member> + <member><link linkend="control-structures.for">for</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.strcasecmp" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strcasecmp</refname> - <refpurpose>Binärer Vergleich von Zeichenketten ohne Unterscheidung - der Groß- und Kleinschreibung</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strcasecmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <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. - <example> - <title><function>strcasecmp</function>-Beispiel:</title> - <programlisting role="php"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strcasecmp"> + <refnamediv> + <refname>strcasecmp</refname> + <refpurpose>Vergleich von Zeichenketten ohne Unterscheidung + der Groß- und Kleinschreibung (Binary safe)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strcasecmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + </methodsynopsis> + <para> + Groß- und kleinschreibungsunabhängiger Vergleich zweier Zeichenketten, der + binary safe ausgeführt wird. + </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> + Ist <parameter>str1</parameter> kleiner als + <parameter>str2</parameter> wird ein Wert < 0 zurückgegeben, ist + <parameter>str1</parameter> größer als <parameter>str2</parameter> ein Wert + > 0, und bei Gleichheit gibt die Funktion 0 zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>strcasecmp</function>-Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php $var1 = "Hallo"; @@ -33,20 +71,27 @@ } ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strncasecmp</function> und - <function>strstr</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>preg_match</function></member> + <member><function>strcmp</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.strchr" xmlns="http://docbook.org/ns/docbook"> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strchr"> <refnamediv> <refname>strchr</refname> <refpurpose>&Alias; <function>strstr</function></refpurpose> @@ -15,8 +14,10 @@ <function>strstr</function>. </simpara> </refsect1> + </refentry> +  - - - <refentry xml:id="function.strcmp" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strcmp</refname> - <refpurpose>Binärer Vergleich zweier Strings</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strcmp</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <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> - Beachten Sie, dass zwischen Groß- und Kleinschreibung - unterschieden wird. - </simpara> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcasecmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strncasecmp</function>, - <function>strncmp</function> und - <function>strstr</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strcmp"> + <refnamediv> + <refname>strcmp</refname> + <refpurpose>Vergleich zweier Strings (Binary safe)</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strcmp</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + </methodsynopsis> + <simpara> + Beachten Sie, dass zwischen Groß- und Kleinschreibung + unterschieden wird. + </simpara> + </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> + Ist <parameter>str1</parameter> kleiner als + <parameter>str2</parameter> wird ein Wert < 0 zurückgegeben, ist + <parameter>str1</parameter> größer als <parameter>str2</parameter> ein Wert + > 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>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> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - <refentry xml:id="function.strcoll" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strcoll</refname> - <refpurpose>Locale-basierter Zeichenkettenvergleich</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>strcoll</methodname> - <methodparam><type>string</type><parameter>str1</parameter></methodparam> - <methodparam><type>string</type><parameter>str2</parameter></methodparam> - </methodsynopsis> - <simpara> - Gibt einen Wert <0 zurück, wenn <parameter>str1</parameter> kürzer ist als - <parameter>str2</parameter>, >0, wenn <parameter>str1</parameter> länger ist - als <parameter>str2</parameter>, und 0, wenn sie gleich sind. - <function>strcoll</function> legt dem Vergleich die aktuellen locale-Angabe - zu Grunde. Ist deren Wert C oder POSIX, verhält sich diese Funktion äquivalent - zu <function>strcmp</function>. - </simpara> - <simpara> - Beachten Sie, dass der Vergleich Groß- und Kleinschreibung berücksichtigt. - Im Gegensatz zu <function>strcmp</function> ist die Funktion zudem nicht - binary safe. - </simpara> - <note> - <para> - <function>strcoll</function> steht in PHP seit Version 4.0.5 zur Verfügung, - wurde jedoch erst in Version 4.2.3 für Win32-Systeme bereitgestellt. - </para> - </note> - <simpara> - Siehe auch - <function>preg_match</function>, - <function>strcmp</function>, - <function>strcasecmp</function>, - <function>substr</function>, - <function>stristr</function>, - <function>strncasecmp</function>, - <function>strncmp</function>, - <function>strstr</function> und - <function>setlocale</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strcoll"> + <refnamediv> + <refname>strcoll</refname> + <refpurpose>Locale-basierter Zeichenkettenvergleich</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strcoll</methodname> + <methodparam><type>string</type><parameter>str1</parameter></methodparam> + <methodparam><type>string</type><parameter>str2</parameter></methodparam> + </methodsynopsis> + <para> + Beachten Sie, dass der Vergleich Groß- und Kleinschreibung berücksichtigt. + Im Gegensatz zu <function>strcmp</function> ist die Funktion zudem nicht + binary safe. + </para> + <para> + <function>strcoll</function> legt dem Vergleich die aktuellen locale-Angabe + zu Grunde. Ist deren Wert C oder POSIX, verhält sich diese Funktion äquivalent + zu <function>strcmp</function>. + </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="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.3</entry> + <entry> + Die Funktion ist jetzt auch unter Win32-Systemen nutzbar. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </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.strcspn" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>strcspn</refname> - <refpurpose> - Ermittelt die Anzahl der nicht übereinstimmenden Zeichen - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>strcspn</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 von <parameter>str1</parameter> zurück, bis zu der - <emphasis>kein</emphasis> Zeichen aus <parameter>str2</parameter> - vorkommt. - </simpara> - <simpara> - Seit PHP 4.3.0 akzeptiert <function>strcspn</function> zwei optionale - <type>integer</type>-Parameter, die verwendet werden können, um die - <parameter>start</parameter>-Position und die zu untersuchende - Länge des Strings (<parameter>length</parameter>) festzulegen. - </simpara> - - &note.bin-safe; - - <simpara> - Siehe auch - <function>strspn</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strcspn"> + <refnamediv> + <refname>strcspn</refname> + <refpurpose>Ermittelt die Anzahl der nicht übereinstimmenden Zeichen</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>strcspn</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> + Gibt die Länge von <parameter>str1</parameter> zurück, bis zu der + <emphasis>kein</emphasis> Zeichen aus <parameter>str2</parameter> + vorkommt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str1</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>str2</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>start</parameter></term> + <listitem> + <para> + Die Anfangsposition der zu untersuchenden Zeichenkette. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter></term> + <listitem> + <para> + Die Länge der zu untersuchenden Zeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Länge des gefundenen Segments als Integerwert 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>4.3.0</entry> + <entry> + Die Parameter <parameter>start</parameter> und <parameter>length</parameter> + wurden eingeführt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>strspn</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> +  - - - - - <refentry xml:id="function.stripcslashes" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>stripcslashes</refname> - <refpurpose>Umkehrung / Gegenstück zu addcslashes</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>stripcslashes</methodname> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - </methodsynopsis> - <para> - Gibt einen String ohne "\" zurück. Wie in C werden - <literal>\n</literal>, <literal>\r</literal> ..., oktal- - und hexadezimal-Vorkommen erkannt. - <note> - <simpara> - Verfügbar seit PHP4b3-dev. - </simpara> - </note> - </para> - <simpara> - Siehe auch <function>addcslashes</function>. - </simpara> - </refsect1> - </refentry> + + +<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripcslashes"> + <refnamediv> + <refname>stripcslashes</refname> + <refpurpose>Entfernt Quotes aus mit <function>addcslashes</function> behandelten Strings</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>stripcslashes</methodname> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + </methodsynopsis> + <para> + Gibt einen String zurück, aus dem die Backslashes ("\") entfernt wurden. + Wie in C werden <literal>\n</literal>, <literal>\r</literal> ..., oktal- + und hexadezimal-Vorkommen erkannt. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>str</parameter></term> + <listitem> + <para> + Die zu demaskierende Zeichenkette. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die demaskierte Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>addcslashes</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables:

cvs: phpdoc-de /reference/strings/functions sscanf.xml str-ireplace.xml str-pad.xml str-repeat.xml str-replace.xml str-rot13.xml str-shuffle.xml str-split.xml strcasecmp.xml strchr.xml strcmp.xml strcoll.xml strcspn.xml stripcslashes.xml

cvs: phpdoc-de /reference/strings/functions sscanf.xml str-ireplace.xml str-pad.xml str-repeat.xml str-replace.xml str-rot13.xml str-shuffle.xml
str-split.xml strcasecmp.xml strchr.xml strcmp.xml strcoll.xml strcspn.xml stripcslashes.xml