cvs: phpdoc-de /reference/strings/functions htmlspecialchars.xml implode.xml md5.xml nl2br.xml setlocale.xml str-replace.xml stristr.xml strstr.xml
| From: | Thomas Schoefbeck | Date: | Mon, 10 Feb 2003 20:22:58 +0000 |
| Subject: | cvs: phpdoc-de /reference/strings/functions htmlspecialchars.xml implode.xml md5.xml nl2br.xml setlocale.xml str-replace.xml stristr.xml strstr.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-504@lists.php.net to get a copy of this message | ||
tom Mon Feb 10 15:22:58 2003 EDT
Modified files:
/phpdoc-de/reference/strings/functions htmlspecialchars.xml
implode.xml md5.xml
nl2br.xml setlocale.xml
str-replace.xml stristr.xml
strstr.xml
Log:
sync to en
Index: phpdoc-de/reference/strings/functions/htmlspecialchars.xml diff -u phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.3 phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.4 --- phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/htmlspecialchars.xml Mon Feb 10 15:22:57 2003 @@ -1,44 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'htmlspecialchars' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.htmlspecialchars"> <refnamediv> <refname>htmlspecialchars</refname> <refpurpose> - Diese Funktion wandelt Sonderzeichen in HTML-Codes um + Wandelt Sonderzeichen in HTML-Codes um </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>htmlspecialchars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> - Bestimmte Zeichen haben eine spezielle Bedeutung in HTML und + Bestimmte Zeichen haben in HTML eine spezielle Bedeutung und sollten in HTML-Code dargestellt werden, um ihre Bedeutung zu behalten. Diese Funktion liefert einen String zurück, in dem - diese Darstellung / Umsetzung teilweise durchgeführt wird. Die - hier vorgenommenen Umsetzungen sind nützlich für die alltägliche - Web-Programmierung. Sofern Sie eine vollständige Umsetzung der - HTML-Zeichen benötigen, sollten Sie statt dessen + manche dieser Konvertierungen durchgeführt wurden. Die hier + vorgenommenen Umwandlungen sind die nützlichsten für die alltägliche + Web-Programmierung. Sofern Sie eine vollständige Konvertierung der + HTML-Zeichen benötigen, sollten Sie stattdessen <function>htmlentities</function> verwenden. </para> <simpara> - Sinnvoll beim Schutz von benutzerabhängigen Texteingaben (z.B. in - Gästebuch-Formularen). Das optionale 2. Argument (Quote-Stil) - beeinflusst die Behandlung der einfachen und doppelten - Anführungsstriche. Der Modus ENT_COMPAT (default) ist - abwärtskompatibel und behandelt nur die doppelten, nicht aber die - einfachen Anführungsstriche. ENT_QUOTES behandelt beide und - ENT_NOQUOTES keine Art(en) von Anführungszeichen. + Diese Funktion ist nützlich, um vom Benutzer gelieferten Text frei + von HTML-Code zu halten, wie z.B. in Forums- oder Gästebuch- + Applikationen. Das optionale 2. Argument (Quote-Stil) legt fest, wie + die einfachen und doppelten Anführungsstriche behandelt werden sollen. + Der Modus ENT_COMPAT (default) ist abwärtskompatibel und behandelt nur + die doppelten, nicht aber die einfachen Anführungsstriche. ENT_QUOTES + behandelt beide und ENT_NOQUOTES keine Art(en) von Anführungszeichen. </simpara> <para> - Folgende Umsetzungen werden vorgenommen: + Folgende Umwandlungen werden vorgenommen: <itemizedlist> <listitem> <simpara> @@ -48,13 +47,13 @@ <listitem> <simpara> '"' (doppelte Anführungszeichen) wird zu '&quot;', - wenn ENT_NOQUOTES nicht gesetzt ist + wenn ENT_NOQUOTES nicht gesetzt ist </simpara> </listitem> <listitem> <simpara> ''' (einfaches Anführungszeichen) wird zu '&#039;', - wenn ENT_QUOTES gesetzt ist + wenn ENT_QUOTES gesetzt ist </simpara> </listitem> <listitem> @@ -69,22 +68,28 @@ </listitem> </itemizedlist> <example> - <title><function>htmlspecialchars</function>-Beispiel:</title> + <title><function>htmlspecialchars</function> Beispiel</title> <programlisting role="php"> -$neu = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +<![CDATA[ +$neu = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +]]> </programlisting> </example> </para> <para> Beachten Sie, dass diese Funktion nur die o.a. Umwandlungen durchführt. Zur vollständigen Code-Umwandlung siehe - <function>htmlentities</function>. Beachten Sie auch, dass das - optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP 4.0.3. verfügbar - ist. + <function>htmlentities</function>. Das optionale 2. Argument + ist seit PHP 3.0.17 bzw. PHP 4.0.3. verfügbar. </para> <para> - Siehe auch <function>htmlentities</function> und - <function>nl2br</function>. + Das dritte Argument definiert den während der Konvertierung verwendeten + Zeichensatz. Der standardmäßige Zeichensatz ist ISO-8859-1. Das dritte + Argument wurde in PHP 4.1.0 eingeführt. + </para> + <para> + Siehe auch <function>get_html_translation_table</function>, + <function>htmlentities</function> und <function>nl2br</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/implode.xml diff -u phpdoc-de/reference/strings/functions/implode.xml:1.3 phpdoc-de/reference/strings/functions/implode.xml:1.4 --- phpdoc-de/reference/strings/functions/implode.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/implode.xml Mon Feb 10 15:22:58 2003 @@ -1,36 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'implode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.implode"> <refnamediv> <refname>implode</refname> <refpurpose>Verbindet Array-Elemente zu einem String</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>implode</methodname> <methodparam><type>string</type><parameter>glue</parameter></methodparam> <methodparam><type>array</type><parameter>pieces</parameter></methodparam> </methodsynopsis> <para> - Gibt einen String zurück, dessen Inhalt allen Array-Elementen - in der fortlaufenden Reihenfolge ihres Vorkommens im Array - entspricht. Die Stringteile sind durch den im Parameter glue - enthaltenen String verbunden. + Gibt einen String mit einer String-Repräsentation aller Array-Elemente + in der gleichen Reihenfolge wie in dem Array zurück, bei dem die + einzelnen Array-Elemente mit dem im Parameter glue angegebenen String + verbunden werden. <example> - <title><function>implode</function>-Beispiel:</title> + <title><function>implode</function> Beispiel</title> <programlisting role="php"> -$Trennung_durch_Doppelpunkt = implode (":", $array); +<![CDATA[ +<?php + +$array = array('lastname', 'email', 'phone'); +$comma_separated = implode(",", $array); + +print $comma_separated; // lastname,email,phone + +?> +]]> </programlisting> </example> </para> + <note> + <para> + <function>implode</function> aktzeptiert die Parameter aus historischen + Gründen in beiden Reihenfolgen. Dennoch sollten Sie schon wegen der + Übereinstimmung mit <function>explode</function> die dokumentierte und + wahrscheinlich weniger verwirrende Reihenfolge der Argumente verwenden. + </para> + </note> <simpara> - Siehe auch <function>explode</function>, <function>join</function> - und <function>split</function>. + Siehe auch <function>explode</function> und <function>split</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/md5.xml diff -u phpdoc-de/reference/strings/functions/md5.xml:1.2 phpdoc-de/reference/strings/functions/md5.xml:1.3 --- phpdoc-de/reference/strings/functions/md5.xml:1.2 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/md5.xml Mon Feb 10 15:22:58 2003 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'md5' in en/ tree in rev 1.135 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.135 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.md5"> <refnamediv> <refname>md5</refname> <refpurpose>Errechnet den MD5-Code eines Strings</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>md5</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - Berechnet den MD5-Code von <parameter>str</parameter> unter - Verwendung des <ulink url="&url.rfc;rfc1321.html">RSA Data - Security, Inc. MD5 Message-Digest Algorithmus</ulink>. + Berechnet den MD5-Code von <parameter>str</parameter> unter Verwendung + des <ulink url="&url.rfc;rfc1321.html">RSA Data Security, Inc. MD5 + Message-Digest Algorithm</ulink>, und gibt das Ergebnis zurück. Dieser + Code ist eine hexadezimale Zahl mit 32 Zeichen Länge. </para> <para> - Siehe auch: <function>crc32</function>. + Siehe auch <function>crc32</function>, <function>md5_file</function> + und <function>sha1</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/nl2br.xml diff -u phpdoc-de/reference/strings/functions/nl2br.xml:1.3 phpdoc-de/reference/strings/functions/nl2br.xml:1.4 --- phpdoc-de/reference/strings/functions/nl2br.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/nl2br.xml Mon Feb 10 15:22:58 2003 @@ -1,30 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.17 --> -<!-- last change to 'nl2br' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.nl2br"> <refnamediv> <refname>nl2br</refname> <refpurpose> - Fügt HTML-Zeilen-Umbrüche vor Zeilenumbrüche in Strings ein + Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>nl2br</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> </methodsynopsis> <para> - Gibt den <parameter>string</parameter> mit einem eingefügten - '<br />' vor dem Neue-Zeile-Zeichen zurück. + Gibt den <parameter>string</parameter> mit einem vor allen + Neue-Zeile-Zeichen eingefügten '<br />' zurück. </para> + <note> + <para> + Seit PHP 4.0.5 ist <function>nl2br</function> XHTML konform. Vor + PHP 4.0.5 wird <parameter>string</parameter> mit '<br>' + vor allen Zeilenumbrüchen eingefügt, anstatt von '<br />'. + </para> + </note> <para> - Siehe auch <function>htmlspecialchars</function> und - <function>htmlentities</function> and - <function>wordwrap</function>. + Siehe auch <function>htmlspecialchars</function>, + <function>htmlentities</function>, + <function>wordwrap</function>, und + <function>str_replace</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/setlocale.xml diff -u phpdoc-de/reference/strings/functions/setlocale.xml:1.4 phpdoc-de/reference/strings/functions/setlocale.xml:1.5 --- phpdoc-de/reference/strings/functions/setlocale.xml:1.4 Sat Oct 26 12:18:59 2002 +++ phpdoc-de/reference/strings/functions/setlocale.xml Mon Feb 10 15:22:58 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <!-- CREDITS: tschuer --> <refentry id="function.setlocale"> <refnamediv> @@ -77,12 +77,12 @@ es gelingt. Dies ist dann sinnvoll, wenn eine locale auf verschiedenen Systemen unter verschiedenen Namen bekannt ist, oder auch als Fallback für eine eventuell nicht vorhandene locale. - <note> - <simpara> - Das Übergeben von mehreren locales ist erst seit PHP 4.3 verfügbar. - </simpara> - </note> </para> + <note> + <simpara> + Das Übergeben von mehreren locales wird erst seit PHP 4.3 unterstützt. + </simpara> + </note> <para> <function>setlocale</function> gibt die neue Einstellung oder &false; (wenn die locale-Funktionalität auf der System-Plattform @@ -90,21 +90,28 @@ zurück. Ein ungültiger Kategorie-Name erzeugt auch noch eine Warnmeldung. </para> + <note> + <para> + Der Rückgabewert von <function>setlocale</function> ist von dem + System abhängig, auf dem PHP läuft. Es wird genau das zurückgegeben, + was die Systemfunktion setlocale zurückgibt. + </para> + </note> <para> <example> <title><function>setlocale</function> Beispiele</title> <programlisting role="php"> <![CDATA[ <?php - /* locale auf Holland setzen */ - setlocale (LC_ALL, 'nl_NL'); +/* locale auf Holland setzen */ +setlocale (LC_ALL, 'nl_NL'); - /* Ausgabe: vrijdag 22 december 1978 */ - echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); +/* Ausgabe: vrijdag 22 december 1978 */ +echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); - /* versuche verschiedene mögliche locale Namen für Deutsch */ - $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); - echo "Preferred locale for german on this system is '$loc_de'"; +/* versuche verschiedene mögliche locale Namen für Deutsch ab PHP 4.3.0 */ +$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); +echo "Preferred locale for german on this system is '$loc_de'"; ?> ]]> </programlisting> Index: phpdoc-de/reference/strings/functions/str-replace.xml diff -u phpdoc-de/reference/strings/functions/str-replace.xml:1.3 phpdoc-de/reference/strings/functions/str-replace.xml:1.4 --- phpdoc-de/reference/strings/functions/str-replace.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/str-replace.xml Mon Feb 10 15:22:58 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'str-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.str-replace"> <refnamediv> <refname>str_replace</refname> @@ -12,26 +10,49 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <type>string</type><methodname>str_replace</methodname> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <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> </methodsynopsis> <para> Diese Funktion ersetzt alle Vorkommen von - <parameter>needle</parameter> innerhalb der Zeichenkette - <parameter>haystack</parameter> durch den String - <parameter>str</parameter>. Falls Sie keine ausgefallenen + <parameter>search</parameter> innerhalb der Zeichenkette + <parameter>subject</parameter> durch den String + <parameter>replace</parameter>. Falls Sie keine ausgefallenen String-Ersetzungen brauchen, sollten Sie immer dieser Funktion - den Vorzug vor <function>ereg_replace</function> geben. + den Vorzug vor <function>ereg_replace</function> oder + <function>preg_replace</function> geben. + </para> + <para> + Seit PHP 4.0.5 kann jeder Parameter von + <function>str_replace</function> auch ein Array sein. + </para> + <para> + Ist <parameter>subject</parameter> ein Array, erfolgt das Suchen + und Ersetzen an jedem 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> einen Wert von jedem + Array und verwendet ihn zum Suchen und Ersetzen von + <parameter>subject</parameter>. Hat <parameter>replace</parameter> + weniger Werte als <parameter>search</parameter>, so wird ein leerer + String für den Rest der Werte zum Ersetzen 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. </para> <para> <example> - <title><function>str_replace</function>-Beispiel:</title> + <title><function>str_replace</function> Beispiel:</title> <programlisting role="php"> -$bodytag = str_replace ("%body%", "black", "<body text=%body%>"); +<![CDATA[ +$bodytag = str_replace("%body%", "black", "<body text=%body%>"); +]]> </programlisting> </example> </para> @@ -45,7 +66,9 @@ </para> </note> <para> - Siehe auch <function>ereg_replace</function> und + Siehe auch <function>str_ireplace</function>, + <function>ereg_replace</function>, + <function>preg_replace</function> und <function>strtr</function>. </para> </refsect1> Index: phpdoc-de/reference/strings/functions/stristr.xml diff -u phpdoc-de/reference/strings/functions/stristr.xml:1.4 phpdoc-de/reference/strings/functions/stristr.xml:1.5 --- phpdoc-de/reference/strings/functions/stristr.xml:1.4 Sat Jan 4 08:31:43 2003 +++ phpdoc-de/reference/strings/functions/stristr.xml Mon Feb 10 15:22:58 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.5 --> -<!-- last change to 'stristr' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.8 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.stristr"> <refnamediv> <refname>stristr</refname> @@ -13,7 +11,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>stristr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> @@ -26,12 +24,27 @@ </para> <para> Wird <parameter>needle</parameter> nicht gefunden, wird &false; - zurück gegeben. + zurückgegeben. </para> <para> Ist <parameter>needle</parameter> kein String, wird er in einen - Integer-Wert umgesetzt. Dies ASCII-Entsprechung dieses Wertes - wird dann als zu suchendes Zeichen angesehen. + Integer-Wert umgesetzt, und die ASCII-Entsprechung dieses Wertes + als zu suchendes Zeichen angesehen. + </para> + <para> + <example> + <title><function>stristr</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + $email = 'USER@EXAMPLE.com'; + $domain = stristr($email, 'e'); + print $domain; +// Ausgabe: ER@EXAMPLE.com +?> +]]> + </programlisting> + </example> </para> <para> Siehe auch <function>strchr</function>, Index: phpdoc-de/reference/strings/functions/strstr.xml diff -u phpdoc-de/reference/strings/functions/strstr.xml:1.5 phpdoc-de/reference/strings/functions/strstr.xml:1.6 --- phpdoc-de/reference/strings/functions/strstr.xml:1.5 Sun Jan 5 13:05:42 2003 +++ phpdoc-de/reference/strings/functions/strstr.xml Mon Feb 10 15:22:58 2003 @@ -1,25 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'strstr' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.strstr"> <refnamediv> <refname>strstr</refname> <refpurpose>Sucht erstes Vorkommen des Suchstrings und liefert den Reststring</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>strstr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> </methodsynopsis> <para> - Es wird alles von <parameter>haystack</parameter> zurück gegeben - ab der ersten Fundstelle von <parameter>needle</parameter> bis zum - Ende. + Gibt den String <parameter>haystack</parameter> ab dem ersten + Vorkommen von <parameter>needle</parameter> bis zum Ende zurück. </para> <para> Falls <parameter>needle</parameter> nicht gefunden wird, ist das @@ -30,25 +27,41 @@ Integer-Wert umgesetzt und als das diesem Wert entsprechende ASCII-Zeichen angesehen. </para> - <para> - Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. - Ist keine Unterscheidung gewünscht / erforderlich, sollten Sie - <function>stristr</function> verwenden. - </para> + <note> + <para> + Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. + Ist keine Unterscheidung gewünscht / erforderlich, sollten Sie + <function>stristr</function> verwenden. + </para> + </note> <para> <example> - <title><function>strstr</function>-Beispiel:</title> + <title><function>strstr</function> Beispiel</title> <programlisting role="php"> -$email = 'sterling@designmultimedia.com'; -$domain = strstr ($email, '@'); -print $domain; // gibt @designmultimedia.com zurück +<![CDATA[ +$email = 'user@example.com'; +$domain = strstr($email, '@'); +print $domain; // Ausgabe: @example.com +]]> </programlisting> </example> </para> <para> - Siehe auch <function>stristr</function>, - <function>strrchr</function>, <function>substr</function> und - <function>ereg</function>. + <note> + <para> + Wenn Sie nur herausfinden möchten, ob ein bestimmter + <parameter>needle</parameter> innerhalb von + <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen + die schnellere und weniger speicherintesive Funktion + <function>strpos</function>. + </para> + </note> + </para> + <para> + Siehe auch <function>ereg</function>, <function>preg_match</function>, + <function>strchr</function>, <function>stristr</function>, + <function>strpos</function>, <function>strrchr</function> und + <function>substr</function>. </para> </refsect1> </refentry>
Index: phpdoc-de/reference/strings/functions/htmlspecialchars.xml diff -u phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.3 phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.4 --- phpdoc-de/reference/strings/functions/htmlspecialchars.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/htmlspecialchars.xml Mon Feb 10 15:22:57 2003 @@ -1,44 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'htmlspecialchars' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.htmlspecialchars"> <refnamediv> <refname>htmlspecialchars</refname> <refpurpose> - Diese Funktion wandelt Sonderzeichen in HTML-Codes um + Wandelt Sonderzeichen in HTML-Codes um </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>htmlspecialchars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> - Bestimmte Zeichen haben eine spezielle Bedeutung in HTML und + Bestimmte Zeichen haben in HTML eine spezielle Bedeutung und sollten in HTML-Code dargestellt werden, um ihre Bedeutung zu behalten. Diese Funktion liefert einen String zurück, in dem - diese Darstellung / Umsetzung teilweise durchgeführt wird. Die - hier vorgenommenen Umsetzungen sind nützlich für die alltägliche - Web-Programmierung. Sofern Sie eine vollständige Umsetzung der - HTML-Zeichen benötigen, sollten Sie statt dessen + manche dieser Konvertierungen durchgeführt wurden. Die hier + vorgenommenen Umwandlungen sind die nützlichsten für die alltägliche + Web-Programmierung. Sofern Sie eine vollständige Konvertierung der + HTML-Zeichen benötigen, sollten Sie stattdessen <function>htmlentities</function> verwenden. </para> <simpara> - Sinnvoll beim Schutz von benutzerabhängigen Texteingaben (z.B. in - Gästebuch-Formularen). Das optionale 2. Argument (Quote-Stil) - beeinflusst die Behandlung der einfachen und doppelten - Anführungsstriche. Der Modus ENT_COMPAT (default) ist - abwärtskompatibel und behandelt nur die doppelten, nicht aber die - einfachen Anführungsstriche. ENT_QUOTES behandelt beide und - ENT_NOQUOTES keine Art(en) von Anführungszeichen. + Diese Funktion ist nützlich, um vom Benutzer gelieferten Text frei + von HTML-Code zu halten, wie z.B. in Forums- oder Gästebuch- + Applikationen. Das optionale 2. Argument (Quote-Stil) legt fest, wie + die einfachen und doppelten Anführungsstriche behandelt werden sollen. + Der Modus ENT_COMPAT (default) ist abwärtskompatibel und behandelt nur + die doppelten, nicht aber die einfachen Anführungsstriche. ENT_QUOTES + behandelt beide und ENT_NOQUOTES keine Art(en) von Anführungszeichen. </simpara> <para> - Folgende Umsetzungen werden vorgenommen: + Folgende Umwandlungen werden vorgenommen: <itemizedlist> <listitem> <simpara> @@ -48,13 +47,13 @@ <listitem> <simpara> '"' (doppelte Anführungszeichen) wird zu '&quot;', - wenn ENT_NOQUOTES nicht gesetzt ist + wenn ENT_NOQUOTES nicht gesetzt ist </simpara> </listitem> <listitem> <simpara> ''' (einfaches Anführungszeichen) wird zu '&#039;', - wenn ENT_QUOTES gesetzt ist + wenn ENT_QUOTES gesetzt ist </simpara> </listitem> <listitem> @@ -69,22 +68,28 @@ </listitem> </itemizedlist> <example> - <title><function>htmlspecialchars</function>-Beispiel:</title> + <title><function>htmlspecialchars</function> Beispiel</title> <programlisting role="php"> -$neu = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +<![CDATA[ +$neu = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +]]> </programlisting> </example> </para> <para> Beachten Sie, dass diese Funktion nur die o.a. Umwandlungen durchführt. Zur vollständigen Code-Umwandlung siehe - <function>htmlentities</function>. Beachten Sie auch, dass das - optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP 4.0.3. verfügbar - ist. + <function>htmlentities</function>. Das optionale 2. Argument + ist seit PHP 3.0.17 bzw. PHP 4.0.3. verfügbar. </para> <para> - Siehe auch <function>htmlentities</function> und - <function>nl2br</function>. + Das dritte Argument definiert den während der Konvertierung verwendeten + Zeichensatz. Der standardmäßige Zeichensatz ist ISO-8859-1. Das dritte + Argument wurde in PHP 4.1.0 eingeführt. + </para> + <para> + Siehe auch <function>get_html_translation_table</function>, + <function>htmlentities</function> und <function>nl2br</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/implode.xml diff -u phpdoc-de/reference/strings/functions/implode.xml:1.3 phpdoc-de/reference/strings/functions/implode.xml:1.4 --- phpdoc-de/reference/strings/functions/implode.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/implode.xml Mon Feb 10 15:22:58 2003 @@ -1,36 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'implode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.implode"> <refnamediv> <refname>implode</refname> <refpurpose>Verbindet Array-Elemente zu einem String</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>implode</methodname> <methodparam><type>string</type><parameter>glue</parameter></methodparam> <methodparam><type>array</type><parameter>pieces</parameter></methodparam> </methodsynopsis> <para> - Gibt einen String zurück, dessen Inhalt allen Array-Elementen - in der fortlaufenden Reihenfolge ihres Vorkommens im Array - entspricht. Die Stringteile sind durch den im Parameter glue - enthaltenen String verbunden. + Gibt einen String mit einer String-Repräsentation aller Array-Elemente + in der gleichen Reihenfolge wie in dem Array zurück, bei dem die + einzelnen Array-Elemente mit dem im Parameter glue angegebenen String + verbunden werden. <example> - <title><function>implode</function>-Beispiel:</title> + <title><function>implode</function> Beispiel</title> <programlisting role="php"> -$Trennung_durch_Doppelpunkt = implode (":", $array); +<![CDATA[ +<?php + +$array = array('lastname', 'email', 'phone'); +$comma_separated = implode(",", $array); + +print $comma_separated; // lastname,email,phone + +?> +]]> </programlisting> </example> </para> + <note> + <para> + <function>implode</function> aktzeptiert die Parameter aus historischen + Gründen in beiden Reihenfolgen. Dennoch sollten Sie schon wegen der + Übereinstimmung mit <function>explode</function> die dokumentierte und + wahrscheinlich weniger verwirrende Reihenfolge der Argumente verwenden. + </para> + </note> <simpara> - Siehe auch <function>explode</function>, <function>join</function> - und <function>split</function>. + Siehe auch <function>explode</function> und <function>split</function>. </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/md5.xml diff -u phpdoc-de/reference/strings/functions/md5.xml:1.2 phpdoc-de/reference/strings/functions/md5.xml:1.3 --- phpdoc-de/reference/strings/functions/md5.xml:1.2 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/md5.xml Mon Feb 10 15:22:58 2003 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'md5' in en/ tree in rev 1.135 --> -<!-- EN-Revision: 0.0 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.135 --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.md5"> <refnamediv> <refname>md5</refname> <refpurpose>Errechnet den MD5-Code eines Strings</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>md5</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - Berechnet den MD5-Code von <parameter>str</parameter> unter - Verwendung des <ulink url="&url.rfc;rfc1321.html">RSA Data - Security, Inc. MD5 Message-Digest Algorithmus</ulink>. + Berechnet den MD5-Code von <parameter>str</parameter> unter Verwendung + des <ulink url="&url.rfc;rfc1321.html">RSA Data Security, Inc. MD5 + Message-Digest Algorithm</ulink>, und gibt das Ergebnis zurück. Dieser + Code ist eine hexadezimale Zahl mit 32 Zeichen Länge. </para> <para> - Siehe auch: <function>crc32</function>. + Siehe auch <function>crc32</function>, <function>md5_file</function> + und <function>sha1</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/nl2br.xml diff -u phpdoc-de/reference/strings/functions/nl2br.xml:1.3 phpdoc-de/reference/strings/functions/nl2br.xml:1.4 --- phpdoc-de/reference/strings/functions/nl2br.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/nl2br.xml Mon Feb 10 15:22:58 2003 @@ -1,30 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.17 --> -<!-- last change to 'nl2br' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.nl2br"> <refnamediv> <refname>nl2br</refname> <refpurpose> - Fügt HTML-Zeilen-Umbrüche vor Zeilenumbrüche in Strings ein + Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>nl2br</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> </methodsynopsis> <para> - Gibt den <parameter>string</parameter> mit einem eingefügten - '<br />' vor dem Neue-Zeile-Zeichen zurück. + Gibt den <parameter>string</parameter> mit einem vor allen + Neue-Zeile-Zeichen eingefügten '<br />' zurück. </para> + <note> + <para> + Seit PHP 4.0.5 ist <function>nl2br</function> XHTML konform. Vor + PHP 4.0.5 wird <parameter>string</parameter> mit '<br>' + vor allen Zeilenumbrüchen eingefügt, anstatt von '<br />'. + </para> + </note> <para> - Siehe auch <function>htmlspecialchars</function> und - <function>htmlentities</function> and - <function>wordwrap</function>. + Siehe auch <function>htmlspecialchars</function>, + <function>htmlentities</function>, + <function>wordwrap</function>, und + <function>str_replace</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/setlocale.xml diff -u phpdoc-de/reference/strings/functions/setlocale.xml:1.4 phpdoc-de/reference/strings/functions/setlocale.xml:1.5 --- phpdoc-de/reference/strings/functions/setlocale.xml:1.4 Sat Oct 26 12:18:59 2002 +++ phpdoc-de/reference/strings/functions/setlocale.xml Mon Feb 10 15:22:58 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <!-- CREDITS: tschuer --> <refentry id="function.setlocale"> <refnamediv> @@ -77,12 +77,12 @@ es gelingt. Dies ist dann sinnvoll, wenn eine locale auf verschiedenen Systemen unter verschiedenen Namen bekannt ist, oder auch als Fallback für eine eventuell nicht vorhandene locale. - <note> - <simpara> - Das Übergeben von mehreren locales ist erst seit PHP 4.3 verfügbar. - </simpara> - </note> </para> + <note> + <simpara> + Das Übergeben von mehreren locales wird erst seit PHP 4.3 unterstützt. + </simpara> + </note> <para> <function>setlocale</function> gibt die neue Einstellung oder &false; (wenn die locale-Funktionalität auf der System-Plattform @@ -90,21 +90,28 @@ zurück. Ein ungültiger Kategorie-Name erzeugt auch noch eine Warnmeldung. </para> + <note> + <para> + Der Rückgabewert von <function>setlocale</function> ist von dem + System abhängig, auf dem PHP läuft. Es wird genau das zurückgegeben, + was die Systemfunktion setlocale zurückgibt. + </para> + </note> <para> <example> <title><function>setlocale</function> Beispiele</title> <programlisting role="php"> <![CDATA[ <?php - /* locale auf Holland setzen */ - setlocale (LC_ALL, 'nl_NL'); +/* locale auf Holland setzen */ +setlocale (LC_ALL, 'nl_NL'); - /* Ausgabe: vrijdag 22 december 1978 */ - echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); +/* Ausgabe: vrijdag 22 december 1978 */ +echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); - /* versuche verschiedene mögliche locale Namen für Deutsch */ - $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); - echo "Preferred locale for german on this system is '$loc_de'"; +/* versuche verschiedene mögliche locale Namen für Deutsch ab PHP 4.3.0 */ +$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); +echo "Preferred locale for german on this system is '$loc_de'"; ?> ]]> </programlisting> Index: phpdoc-de/reference/strings/functions/str-replace.xml diff -u phpdoc-de/reference/strings/functions/str-replace.xml:1.3 phpdoc-de/reference/strings/functions/str-replace.xml:1.4 --- phpdoc-de/reference/strings/functions/str-replace.xml:1.3 Sun Jun 9 06:56:16 2002 +++ phpdoc-de/reference/strings/functions/str-replace.xml Mon Feb 10 15:22:58 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'str-replace' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.str-replace"> <refnamediv> <refname>str_replace</refname> @@ -12,26 +10,49 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> - <type>string</type><methodname>str_replace</methodname> - <methodparam><type>string</type><parameter>needle</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam><type>string</type><parameter>haystack</parameter></methodparam> + <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> </methodsynopsis> <para> Diese Funktion ersetzt alle Vorkommen von - <parameter>needle</parameter> innerhalb der Zeichenkette - <parameter>haystack</parameter> durch den String - <parameter>str</parameter>. Falls Sie keine ausgefallenen + <parameter>search</parameter> innerhalb der Zeichenkette + <parameter>subject</parameter> durch den String + <parameter>replace</parameter>. Falls Sie keine ausgefallenen String-Ersetzungen brauchen, sollten Sie immer dieser Funktion - den Vorzug vor <function>ereg_replace</function> geben. + den Vorzug vor <function>ereg_replace</function> oder + <function>preg_replace</function> geben. + </para> + <para> + Seit PHP 4.0.5 kann jeder Parameter von + <function>str_replace</function> auch ein Array sein. + </para> + <para> + Ist <parameter>subject</parameter> ein Array, erfolgt das Suchen + und Ersetzen an jedem 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> einen Wert von jedem + Array und verwendet ihn zum Suchen und Ersetzen von + <parameter>subject</parameter>. Hat <parameter>replace</parameter> + weniger Werte als <parameter>search</parameter>, so wird ein leerer + String für den Rest der Werte zum Ersetzen 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. </para> <para> <example> - <title><function>str_replace</function>-Beispiel:</title> + <title><function>str_replace</function> Beispiel:</title> <programlisting role="php"> -$bodytag = str_replace ("%body%", "black", "<body text=%body%>"); +<![CDATA[ +$bodytag = str_replace("%body%", "black", "<body text=%body%>"); +]]> </programlisting> </example> </para> @@ -45,7 +66,9 @@ </para> </note> <para> - Siehe auch <function>ereg_replace</function> und + Siehe auch <function>str_ireplace</function>, + <function>ereg_replace</function>, + <function>preg_replace</function> und <function>strtr</function>. </para> </refsect1> Index: phpdoc-de/reference/strings/functions/stristr.xml diff -u phpdoc-de/reference/strings/functions/stristr.xml:1.4 phpdoc-de/reference/strings/functions/stristr.xml:1.5 --- phpdoc-de/reference/strings/functions/stristr.xml:1.4 Sat Jan 4 08:31:43 2003 +++ phpdoc-de/reference/strings/functions/stristr.xml Mon Feb 10 15:22:58 2003 @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.5 --> -<!-- last change to 'stristr' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.8 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.stristr"> <refnamediv> <refname>stristr</refname> @@ -13,7 +11,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>stristr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> @@ -26,12 +24,27 @@ </para> <para> Wird <parameter>needle</parameter> nicht gefunden, wird &false; - zurück gegeben. + zurückgegeben. </para> <para> Ist <parameter>needle</parameter> kein String, wird er in einen - Integer-Wert umgesetzt. Dies ASCII-Entsprechung dieses Wertes - wird dann als zu suchendes Zeichen angesehen. + Integer-Wert umgesetzt, und die ASCII-Entsprechung dieses Wertes + als zu suchendes Zeichen angesehen. + </para> + <para> + <example> + <title><function>stristr</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + $email = 'USER@EXAMPLE.com'; + $domain = stristr($email, 'e'); + print $domain; +// Ausgabe: ER@EXAMPLE.com +?> +]]> + </programlisting> + </example> </para> <para> Siehe auch <function>strchr</function>, Index: phpdoc-de/reference/strings/functions/strstr.xml diff -u phpdoc-de/reference/strings/functions/strstr.xml:1.5 phpdoc-de/reference/strings/functions/strstr.xml:1.6 --- phpdoc-de/reference/strings/functions/strstr.xml:1.5 Sun Jan 5 13:05:42 2003 +++ phpdoc-de/reference/strings/functions/strstr.xml Mon Feb 10 15:22:58 2003 @@ -1,25 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/strings.xml, last change in rev 1.2 --> -<!-- last change to 'strstr' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.strstr"> <refnamediv> <refname>strstr</refname> <refpurpose>Sucht erstes Vorkommen des Suchstrings und liefert den Reststring</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>strstr</methodname> <methodparam><type>string</type><parameter>haystack</parameter></methodparam> <methodparam><type>string</type><parameter>needle</parameter></methodparam> </methodsynopsis> <para> - Es wird alles von <parameter>haystack</parameter> zurück gegeben - ab der ersten Fundstelle von <parameter>needle</parameter> bis zum - Ende. + Gibt den String <parameter>haystack</parameter> ab dem ersten + Vorkommen von <parameter>needle</parameter> bis zum Ende zurück. </para> <para> Falls <parameter>needle</parameter> nicht gefunden wird, ist das @@ -30,25 +27,41 @@ Integer-Wert umgesetzt und als das diesem Wert entsprechende ASCII-Zeichen angesehen. </para> - <para> - Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. - Ist keine Unterscheidung gewünscht / erforderlich, sollten Sie - <function>stristr</function> verwenden. - </para> + <note> + <para> + Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung. + Ist keine Unterscheidung gewünscht / erforderlich, sollten Sie + <function>stristr</function> verwenden. + </para> + </note> <para> <example> - <title><function>strstr</function>-Beispiel:</title> + <title><function>strstr</function> Beispiel</title> <programlisting role="php"> -$email = 'sterling@designmultimedia.com'; -$domain = strstr ($email, '@'); -print $domain; // gibt @designmultimedia.com zurück +<![CDATA[ +$email = 'user@example.com'; +$domain = strstr($email, '@'); +print $domain; // Ausgabe: @example.com +]]> </programlisting> </example> </para> <para> - Siehe auch <function>stristr</function>, - <function>strrchr</function>, <function>substr</function> und - <function>ereg</function>. + <note> + <para> + Wenn Sie nur herausfinden möchten, ob ein bestimmter + <parameter>needle</parameter> innerhalb von + <parameter>haystack</parameter> vorkommt, verwenden Sie stattdessen + die schnellere und weniger speicherintesive Funktion + <function>strpos</function>. + </para> + </note> + </para> + <para> + Siehe auch <function>ereg</function>, <function>preg_match</function>, + <function>strchr</function>, <function>stristr</function>, + <function>strpos</function>, <function>strrchr</function> und + <function>substr</function>. </para> </refsect1> </refentry>