cvs: phpdoc-de /reference/strings/functions chunk-split.xml count-chars.xml crc32.xml get-html-translation-table.xml htmlentities.xml
| From: | Thomas Schoefbeck | Date: | Sun, 02 Feb 2003 21:39:08 +0000 |
| Subject: | cvs: phpdoc-de /reference/strings/functions chunk-split.xml count-chars.xml crc32.xml get-html-translation-table.xml htmlentities.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-497@lists.php.net to get a copy of this message | ||
tom Sun Feb 2 16:39:08 2003 EDT
Modified files:
/phpdoc-de/reference/strings/functions chunk-split.xml
count-chars.xml crc32.xml
get-html-translation-table.xml
htmlentities.xml
Log:
sync to en
Index: phpdoc-de/reference/strings/functions/chunk-split.xml diff -u phpdoc-de/reference/strings/functions/chunk-split.xml:1.3 phpdoc-de/reference/strings/functions/chunk-split.xml:1.4 --- phpdoc-de/reference/strings/functions/chunk-split.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/chunk-split.xml Sun Feb 2 16:39:08 2003 @@ -1,19 +1,17 @@ <?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 'chunk-split' 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.chunk-split"> <refnamediv> <refname>chunk_split</refname> <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>chunk_split</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam><type>string</type><parameter>body</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> </methodsynopsis> @@ -29,19 +27,19 @@ <example> <title><function>chunk_split</function> Beispiel:</title> <programlisting role="php"> +<![CDATA[ # Formatiere den String $daten in die RFC 2045 Schreibweise -$neuer_string = chunk_split (base64_encode($daten)); +$neuer_string = chunk_split(base64_encode($daten)); +]]> </programlisting> </example> - Diese Funktion arbeitet wesentlich schneller als - <function>ereg_replace</function>. - <note> - <para> - <function>chunk_split</function> ist ab Version 3.0.6 vorhanden. - </para> - </note> </para> + <simpara> + Siehe auch <function>explode</function>, <function>split</function> + <function>wordwrap</function> und + <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/count-chars.xml diff -u phpdoc-de/reference/strings/functions/count-chars.xml:1.3 phpdoc-de/reference/strings/functions/count-chars.xml:1.4 --- phpdoc-de/reference/strings/functions/count-chars.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/count-chars.xml Sun Feb 2 16:39:08 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.3 --> -<!-- last change to 'count-chars' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.count-chars"> <refnamediv> <refname>count_chars</refname> @@ -13,55 +11,54 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>mixed</type><methodname>count_chars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type></type><parameter> - mode - </parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Zählt die Häufigkeit des Vorkommens jedes einzelnen Byte-Wertes (0..255) in <parameter>string</parameter> und gibt sie auf verschiedene Arten zurück. Der optionale Parameter - <parameter>mode</parameter> ist voreingestellt auf 0. - In Abhängigkeit des <parameter>mode</parameter>-Wertes gibt - <function>count_chars</function> das folgende zurück: + <parameter>mode</parameter> ist auf 0 voreingestellt. + Abhängig von <parameter>mode</parameter> gibt + <function>count_chars</function> folgendes zurück: <itemizedlist> <listitem> <simpara> - 0 - ein Array mit Byte-Werten für die Häufigkeit (auch 0-Vorkommen) - jedes Zeichens. + 0 - ein Array mit den Byte-Werten als Schlüssel und deren Häufigkeit + jedes Bytes als Wert. </simpara> </listitem> <listitem> <simpara> - 1 - wie 0, aber nur Häufigkeiten grösser 0. + 1 - wie 0, allerdings werden nur Byte-Werte mit einer Häufigkeit + grösser 0 aufgelistet. </simpara> </listitem> <listitem> <simpara> - 2 - wie 0, aber nur Häufigkeiten gleich 0. + 2 - wie 0, allerdings werden nur Byte-Werte mit einer Häufigkeit + von 0 aufgelistet. </simpara> </listitem> <listitem> <simpara> - 3 - ein String der überhaupt vorkommenden Zeichen enthält. + 3 - einen String der alle vorkommenden Zeichen enthält. </simpara> </listitem> <listitem> <simpara> - 4 - ein String der alle nicht vorkommenden Zeichen enthält. + 4 - einen String der alle nicht vorkommenden Zeichen enthält. </simpara> </listitem> </itemizedlist> </para> - <note> - <para> - Diese Funktion existiert ab PHP 4.0. - </para> - </note> + <simpara> + Siehe auch <function>strpos</function> und + <function>substr_count</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/crc32.xml diff -u phpdoc-de/reference/strings/functions/crc32.xml:1.3 phpdoc-de/reference/strings/functions/crc32.xml:1.4 --- phpdoc-de/reference/strings/functions/crc32.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/crc32.xml Sun Feb 2 16:39:08 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.22 --> -<!-- last change to 'crc32' in en/ tree in rev 1.37 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.37 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.crc32"> <refnamediv> <refname>crc32</refname> @@ -12,18 +10,43 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>crc32</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> Berechnet die zyklisch redundante polynomische Prüfsumme mit einer - Länge von 32-Bit für <parameter>str</parameter>. Dies wird regulär + Länge von 32-Bit für <parameter>str</parameter>. Dies wird gewöhnlich für die Integritätsprüfung übermittelter Daten verwendet. </para> <para> - Siehe auch: <function>md5</function>. + <note> + <para> + Da der Datentyp Integer von PHP vorzeichenbehaftet ('signed') ist + und viele Prüfsummen negative Interger-Werte ergeben, müssen Sie die + Formatierungsanweisung "%u" von <function>sprintf</function> oder + <function>printf</function> verwenden, um die String-Repräsentation + der nicht vorzeichenbehafteten ('unsigned') crc32 Prüfsumme zu + erhalten. + </para> + </note> + Das folgende Beispiel zeigt, wie eine konvertierte Prüfsumme mittels der + Funktion <function>printf</function> ausgegeben wird: + <example> + <title>Anzeigen einer crc32 Prüfsumme</title> + <programlisting role="php"> +<![CDATA[ +<?php +$checksum = crc32("The quick brown fox jumped over the lazy dog."); +printf("%u\n", $checksum); +?> +]]> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>md5</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/get-html-translation-table.xml diff -u phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.3 phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.4 --- phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/get-html-translation-table.xml Sun Feb 2 16:39:08 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 'get-html-translation-table' 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.get-html-translation-table"> <refnamediv> <refname>get_html_translation_table</refname> @@ -14,7 +12,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>get_html_translation_table</methodname> <methodparam><type>int</type><parameter>table</parameter></methodparam> @@ -23,46 +21,43 @@ <para> <function>get_html_translation_table</function> ermittelt die intern benutzte Übersetzungs-Tabelle, die von den Funktionen - <function>htmlspecialchars</function> und<function> - htmlentities</function> benutzt wird. Es gibt zwei neue - Parameter (<parameter>HTML_ENTITIES</parameter> und - <parameter>HTML_SPECIALCHARS</parameter>), die es ihnen - ermöglichen, die gewünschte Tabelle auszuwählen und wie bei den - <function>htmlspecialchars</function> bzw. - <function>htmlentities</function>-Funktionen können Sie optional - den Quote-Stil, mit dem Sie arbeiten, angeben. Voreingestellt ist - der ENT_COMPAT-Modus. Vergleichen Sie dazu die Modus-Beschreibung - unter <function>htmlspecialchars</function>. + <function>htmlspecialchars</function> und + <function>htmlentities</function> benutzt wird. Es gibt zwei + neue Definitionen (<parameter>HTML_ENTITIES</parameter> und + <parameter>HTML_SPECIALCHARS</parameter>), mit denen Sie die + gewünschte Tabelle auswählen können. Weiters können Sie wie bei + den Funktionen <function>htmlspecialchars</function> bzw. + <function>htmlentities</function> optional den gewünschten + Quote-Stil (die Art, wie mit Anführungszeichen umgegangen wird) + angeben. Voreingestellt ist der ENT_COMPAT-Modus. Vergleichen Sie + dazu die Modus-Beschreibung unter <function>htmlspecialchars</function>. <example> <title>Beispiel zur Übersetzungs-Tabelle</title> <programlisting role="php"> -$trans = get_html_translation_table (HTML_ENTITIES); -$str = "Hallo & <Frau> & Krämer"; -$encoded = strtr ($str, $trans); +<![CDATA[ +$trans = get_html_translation_table(HTML_ENTITIES); +$str = "Hallo & <Frau> & Krämer"; +$encoded = strtr($str, $trans); +]]> </programlisting> </example> - Die <literal>$encoded</literal>-Variable wird jetzt "Hallo - &<sgmltag>amp</sgmltag>; - &<sgmltag>lt</sgmltag>;Frau&<sgmltag>gt</sgmltag>; - &<sgmltag>amp</sgmltag>; Kr&<sgmltag>auml</sgmltag>;mer". - enthalten. + Die Variable <literal>$encoded</literal> enthält nun: + <literal>"Hallo &amp; &lt;Frau&gt; &amp; + Kr&auml;mer".</literal> </para> <para> Mittels <function>array_flip</function> können Sie die Richtung der Übersetzung umkehren. <informalexample> <programlisting role="php"> -$trans = array_flip ($trans); -$original = strtr ($str, $trans); +<![CDATA[ +$trans = array_flip($trans); +$original = strtr($encoded, $trans); +]]> </programlisting> </informalexample> Der Inhalt von <literal>$original</literal> wird "Hallo & <Frau> & Krämer" sein. - <note> - <para> - Diese Funktion wurde in PHP 4.0 neu hinzu gefügt. - </para> - </note> </para> <para> Siehe auch <function>htmlspecialchars</function>, Index: phpdoc-de/reference/strings/functions/htmlentities.xml diff -u phpdoc-de/reference/strings/functions/htmlentities.xml:1.5 phpdoc-de/reference/strings/functions/htmlentities.xml:1.6 --- phpdoc-de/reference/strings/functions/htmlentities.xml:1.5 Mon Aug 26 23:39:41 2002 +++ phpdoc-de/reference/strings/functions/htmlentities.xml Sun Feb 2 16:39:08 2003 @@ -1,9 +1,7 @@ <?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 'htmlentities' 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.8 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.htmlentities"> <refnamediv> <refname>htmlentities</refname> @@ -12,7 +10,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>htmlentities</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> @@ -20,28 +18,61 @@ <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion ist völlig identisch zu - <function>htmlspecialchars</function>, ausser dass alle Zeichen, - die HTML-Code-Entsprechungen haben, in diese Codes umgewandelt - werden. Wie bei htmlspecialchars() gibt es ein optionales zweites - Argument, das die Behandlung von einfachen bzw. den doppelten - Anführungszeichen beeinflusst. Im Modus ENT_COMPAT (default) - werden nur die doppelten, im Modus ENT_QUOTES beide Arten und im - Modus ENT_NOQUOTES keine Anführungszeichen umgewandelt. + Diese Funktion ist mit <function>htmlspecialchars</function> + identisch, ausser dass alle Zeichen, die HTML-Code-Entsprechungen + haben, in diese Codes umgewandelt werden. </para> <para> - Gegenwärtig wird der ISO-8859-1-Zeichensatz verwendet. Beachten - Sie, dass das optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP - 4.0.3. verfügbar ist. + Wie bei <function>htmlspecialchars</function> können Sie mit dem + optionalen zweiten Parameter <parameter>quote_style</parameter> + definieren, wie die 'einfachen' und "doppelten" Anführungszeichen + behandelt werden. Es gibt drei Konstanten, wobei + <constant>ENT_COMPAT</constant> voreingestellt ist: + <table> + <title>Verfügbare <parameter>quote_style</parameter> Konstanten</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Konstante</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>ENT_COMPAT</constant></entry> + <entry>Konvertiert nur doppelte Anführungszeichen.</entry> + </row> + <row> + <entry><constant>ENT_QUOTES</constant></entry> + <entry>Konvertiert doppelte und einfache Anführungszeichen.</entry> + </row> + <row> + <entry><constant>ENT_NOQUOTES</constant></entry> + <entry>Lässt doppelte und einfache Anführungszeichen unverändert.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Die Unterstützung für den optionalen Parameter + <parameter>quote</parameter> wurde in PHP 4.0.3. eingeführt. </para> <para> Wie auch bei <function>htmlspecialchars</function>, kann man als dritten - optionalen Parameter den Zeichensatz angeben, der zur konvertierung verwendet - wird. Diese Feature wurde in PHP 4.1.0 eingeführt. + optionalen Parameter den Zeichensatz angeben, der zur Konvertierung + verwendet wird. Diese Feature wurde in PHP 4.1.0 eingeführt. Gegenwärtig + wird standardmäßig der ISO-8859-1 Zeichensatz verwendet. + </para> + <para> + Möchten Sie stattdessen die HTML Entities dekodieren, verwenden Sie + bitte die Funktion <function>html_entity_decode</function>. </para> <para> - Siehe auch <function>htmlspecialchars</function> und - <function>nl2br</function>. + Siehe auch <function>html_entity_decode</function>, + <function>get_html_translation_table</function>, + <function>htmlspecialchars</function>, <function>nl2br</function> + und <function>urlencode</function>. </para> </refsect1> </refentry>
Index: phpdoc-de/reference/strings/functions/chunk-split.xml diff -u phpdoc-de/reference/strings/functions/chunk-split.xml:1.3 phpdoc-de/reference/strings/functions/chunk-split.xml:1.4 --- phpdoc-de/reference/strings/functions/chunk-split.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/chunk-split.xml Sun Feb 2 16:39:08 2003 @@ -1,19 +1,17 @@ <?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 'chunk-split' 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.chunk-split"> <refnamediv> <refname>chunk_split</refname> <refpurpose>Zerlegt einen String in Teile gleicher Länge</refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>chunk_split</methodname> - <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam><type>string</type><parameter>body</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam> </methodsynopsis> @@ -29,19 +27,19 @@ <example> <title><function>chunk_split</function> Beispiel:</title> <programlisting role="php"> +<![CDATA[ # Formatiere den String $daten in die RFC 2045 Schreibweise -$neuer_string = chunk_split (base64_encode($daten)); +$neuer_string = chunk_split(base64_encode($daten)); +]]> </programlisting> </example> - Diese Funktion arbeitet wesentlich schneller als - <function>ereg_replace</function>. - <note> - <para> - <function>chunk_split</function> ist ab Version 3.0.6 vorhanden. - </para> - </note> </para> + <simpara> + Siehe auch <function>explode</function>, <function>split</function> + <function>wordwrap</function> und + <ulink url="&url.rfc;rfc2045.html">RFC 2045</ulink>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/count-chars.xml diff -u phpdoc-de/reference/strings/functions/count-chars.xml:1.3 phpdoc-de/reference/strings/functions/count-chars.xml:1.4 --- phpdoc-de/reference/strings/functions/count-chars.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/count-chars.xml Sun Feb 2 16:39:08 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.3 --> -<!-- last change to 'count-chars' in en/ tree in rev 1.4 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.4 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.count-chars"> <refnamediv> <refname>count_chars</refname> @@ -13,55 +11,54 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>mixed</type><methodname>count_chars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type></type><parameter> - mode - </parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Zählt die Häufigkeit des Vorkommens jedes einzelnen Byte-Wertes (0..255) in <parameter>string</parameter> und gibt sie auf verschiedene Arten zurück. Der optionale Parameter - <parameter>mode</parameter> ist voreingestellt auf 0. - In Abhängigkeit des <parameter>mode</parameter>-Wertes gibt - <function>count_chars</function> das folgende zurück: + <parameter>mode</parameter> ist auf 0 voreingestellt. + Abhängig von <parameter>mode</parameter> gibt + <function>count_chars</function> folgendes zurück: <itemizedlist> <listitem> <simpara> - 0 - ein Array mit Byte-Werten für die Häufigkeit (auch 0-Vorkommen) - jedes Zeichens. + 0 - ein Array mit den Byte-Werten als Schlüssel und deren Häufigkeit + jedes Bytes als Wert. </simpara> </listitem> <listitem> <simpara> - 1 - wie 0, aber nur Häufigkeiten grösser 0. + 1 - wie 0, allerdings werden nur Byte-Werte mit einer Häufigkeit + grösser 0 aufgelistet. </simpara> </listitem> <listitem> <simpara> - 2 - wie 0, aber nur Häufigkeiten gleich 0. + 2 - wie 0, allerdings werden nur Byte-Werte mit einer Häufigkeit + von 0 aufgelistet. </simpara> </listitem> <listitem> <simpara> - 3 - ein String der überhaupt vorkommenden Zeichen enthält. + 3 - einen String der alle vorkommenden Zeichen enthält. </simpara> </listitem> <listitem> <simpara> - 4 - ein String der alle nicht vorkommenden Zeichen enthält. + 4 - einen String der alle nicht vorkommenden Zeichen enthält. </simpara> </listitem> </itemizedlist> </para> - <note> - <para> - Diese Funktion existiert ab PHP 4.0. - </para> - </note> + <simpara> + Siehe auch <function>strpos</function> und + <function>substr_count</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/crc32.xml diff -u phpdoc-de/reference/strings/functions/crc32.xml:1.3 phpdoc-de/reference/strings/functions/crc32.xml:1.4 --- phpdoc-de/reference/strings/functions/crc32.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/crc32.xml Sun Feb 2 16:39:08 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.22 --> -<!-- last change to 'crc32' in en/ tree in rev 1.37 --> -<!-- EN-Revision: 1.2 Maintainer: tschuer Status: ready --> -<!-- OLD-Revision: 1.58/EN.1.37 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.crc32"> <refnamediv> <refname>crc32</refname> @@ -12,18 +10,43 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>int</type><methodname>crc32</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> Berechnet die zyklisch redundante polynomische Prüfsumme mit einer - Länge von 32-Bit für <parameter>str</parameter>. Dies wird regulär + Länge von 32-Bit für <parameter>str</parameter>. Dies wird gewöhnlich für die Integritätsprüfung übermittelter Daten verwendet. </para> <para> - Siehe auch: <function>md5</function>. + <note> + <para> + Da der Datentyp Integer von PHP vorzeichenbehaftet ('signed') ist + und viele Prüfsummen negative Interger-Werte ergeben, müssen Sie die + Formatierungsanweisung "%u" von <function>sprintf</function> oder + <function>printf</function> verwenden, um die String-Repräsentation + der nicht vorzeichenbehafteten ('unsigned') crc32 Prüfsumme zu + erhalten. + </para> + </note> + Das folgende Beispiel zeigt, wie eine konvertierte Prüfsumme mittels der + Funktion <function>printf</function> ausgegeben wird: + <example> + <title>Anzeigen einer crc32 Prüfsumme</title> + <programlisting role="php"> +<![CDATA[ +<?php +$checksum = crc32("The quick brown fox jumped over the lazy dog."); +printf("%u\n", $checksum); +?> +]]> + </programlisting> + </example> + </para> + <para> + Siehe auch <function>md5</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/strings/functions/get-html-translation-table.xml diff -u phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.3 phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.4 --- phpdoc-de/reference/strings/functions/get-html-translation-table.xml:1.3 Sun Jun 9 06:56:15 2002 +++ phpdoc-de/reference/strings/functions/get-html-translation-table.xml Sun Feb 2 16:39:08 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 'get-html-translation-table' 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.get-html-translation-table"> <refnamediv> <refname>get_html_translation_table</refname> @@ -14,7 +12,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>get_html_translation_table</methodname> <methodparam><type>int</type><parameter>table</parameter></methodparam> @@ -23,46 +21,43 @@ <para> <function>get_html_translation_table</function> ermittelt die intern benutzte Übersetzungs-Tabelle, die von den Funktionen - <function>htmlspecialchars</function> und<function> - htmlentities</function> benutzt wird. Es gibt zwei neue - Parameter (<parameter>HTML_ENTITIES</parameter> und - <parameter>HTML_SPECIALCHARS</parameter>), die es ihnen - ermöglichen, die gewünschte Tabelle auszuwählen und wie bei den - <function>htmlspecialchars</function> bzw. - <function>htmlentities</function>-Funktionen können Sie optional - den Quote-Stil, mit dem Sie arbeiten, angeben. Voreingestellt ist - der ENT_COMPAT-Modus. Vergleichen Sie dazu die Modus-Beschreibung - unter <function>htmlspecialchars</function>. + <function>htmlspecialchars</function> und + <function>htmlentities</function> benutzt wird. Es gibt zwei + neue Definitionen (<parameter>HTML_ENTITIES</parameter> und + <parameter>HTML_SPECIALCHARS</parameter>), mit denen Sie die + gewünschte Tabelle auswählen können. Weiters können Sie wie bei + den Funktionen <function>htmlspecialchars</function> bzw. + <function>htmlentities</function> optional den gewünschten + Quote-Stil (die Art, wie mit Anführungszeichen umgegangen wird) + angeben. Voreingestellt ist der ENT_COMPAT-Modus. Vergleichen Sie + dazu die Modus-Beschreibung unter <function>htmlspecialchars</function>. <example> <title>Beispiel zur Übersetzungs-Tabelle</title> <programlisting role="php"> -$trans = get_html_translation_table (HTML_ENTITIES); -$str = "Hallo & <Frau> & Krämer"; -$encoded = strtr ($str, $trans); +<![CDATA[ +$trans = get_html_translation_table(HTML_ENTITIES); +$str = "Hallo & <Frau> & Krämer"; +$encoded = strtr($str, $trans); +]]> </programlisting> </example> - Die <literal>$encoded</literal>-Variable wird jetzt "Hallo - &<sgmltag>amp</sgmltag>; - &<sgmltag>lt</sgmltag>;Frau&<sgmltag>gt</sgmltag>; - &<sgmltag>amp</sgmltag>; Kr&<sgmltag>auml</sgmltag>;mer". - enthalten. + Die Variable <literal>$encoded</literal> enthält nun: + <literal>"Hallo &amp; &lt;Frau&gt; &amp; + Kr&auml;mer".</literal> </para> <para> Mittels <function>array_flip</function> können Sie die Richtung der Übersetzung umkehren. <informalexample> <programlisting role="php"> -$trans = array_flip ($trans); -$original = strtr ($str, $trans); +<![CDATA[ +$trans = array_flip($trans); +$original = strtr($encoded, $trans); +]]> </programlisting> </informalexample> Der Inhalt von <literal>$original</literal> wird "Hallo & <Frau> & Krämer" sein. - <note> - <para> - Diese Funktion wurde in PHP 4.0 neu hinzu gefügt. - </para> - </note> </para> <para> Siehe auch <function>htmlspecialchars</function>, Index: phpdoc-de/reference/strings/functions/htmlentities.xml diff -u phpdoc-de/reference/strings/functions/htmlentities.xml:1.5 phpdoc-de/reference/strings/functions/htmlentities.xml:1.6 --- phpdoc-de/reference/strings/functions/htmlentities.xml:1.5 Mon Aug 26 23:39:41 2002 +++ phpdoc-de/reference/strings/functions/htmlentities.xml Sun Feb 2 16:39:08 2003 @@ -1,9 +1,7 @@ <?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 'htmlentities' 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.8 Maintainer: tom Status: ready --> +<!-- CREDITS: tschuer --> <refentry id="function.htmlentities"> <refnamediv> <refname>htmlentities</refname> @@ -12,7 +10,7 @@ </refpurpose> </refnamediv> <refsect1> - <title>Beschreibung:</title> + <title>Beschreibung</title> <methodsynopsis> <type>string</type><methodname>htmlentities</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> @@ -20,28 +18,61 @@ <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion ist völlig identisch zu - <function>htmlspecialchars</function>, ausser dass alle Zeichen, - die HTML-Code-Entsprechungen haben, in diese Codes umgewandelt - werden. Wie bei htmlspecialchars() gibt es ein optionales zweites - Argument, das die Behandlung von einfachen bzw. den doppelten - Anführungszeichen beeinflusst. Im Modus ENT_COMPAT (default) - werden nur die doppelten, im Modus ENT_QUOTES beide Arten und im - Modus ENT_NOQUOTES keine Anführungszeichen umgewandelt. + Diese Funktion ist mit <function>htmlspecialchars</function> + identisch, ausser dass alle Zeichen, die HTML-Code-Entsprechungen + haben, in diese Codes umgewandelt werden. </para> <para> - Gegenwärtig wird der ISO-8859-1-Zeichensatz verwendet. Beachten - Sie, dass das optionale 2. Argument erst ab PHP 3.0.17 bzw. PHP - 4.0.3. verfügbar ist. + Wie bei <function>htmlspecialchars</function> können Sie mit dem + optionalen zweiten Parameter <parameter>quote_style</parameter> + definieren, wie die 'einfachen' und "doppelten" Anführungszeichen + behandelt werden. Es gibt drei Konstanten, wobei + <constant>ENT_COMPAT</constant> voreingestellt ist: + <table> + <title>Verfügbare <parameter>quote_style</parameter> Konstanten</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Konstante</entry> + <entry>Beschreibung</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>ENT_COMPAT</constant></entry> + <entry>Konvertiert nur doppelte Anführungszeichen.</entry> + </row> + <row> + <entry><constant>ENT_QUOTES</constant></entry> + <entry>Konvertiert doppelte und einfache Anführungszeichen.</entry> + </row> + <row> + <entry><constant>ENT_NOQUOTES</constant></entry> + <entry>Lässt doppelte und einfache Anführungszeichen unverändert.</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Die Unterstützung für den optionalen Parameter + <parameter>quote</parameter> wurde in PHP 4.0.3. eingeführt. </para> <para> Wie auch bei <function>htmlspecialchars</function>, kann man als dritten - optionalen Parameter den Zeichensatz angeben, der zur konvertierung verwendet - wird. Diese Feature wurde in PHP 4.1.0 eingeführt. + optionalen Parameter den Zeichensatz angeben, der zur Konvertierung + verwendet wird. Diese Feature wurde in PHP 4.1.0 eingeführt. Gegenwärtig + wird standardmäßig der ISO-8859-1 Zeichensatz verwendet. + </para> + <para> + Möchten Sie stattdessen die HTML Entities dekodieren, verwenden Sie + bitte die Funktion <function>html_entity_decode</function>. </para> <para> - Siehe auch <function>htmlspecialchars</function> und - <function>nl2br</function>. + Siehe auch <function>html_entity_decode</function>, + <function>get_html_translation_table</function>, + <function>htmlspecialchars</function>, <function>nl2br</function> + und <function>urlencode</function>. </para> </refsect1> </refentry>