Re: cvs: phpdoc /en/reference/strings/functions get-html-translation-table.xml

Hi Jakub, The real problem is that the array_flip() example does not work! This was the point of my bug report. I suppose it should work, but I was told, that this is not the intention of the PHP implementation of get_html_translation_table(). I see you removed a duplicate. The other instance of the example should note that it is not working always as expected, and special care should be taken with the multiple representations. Goba > vrana Fri Jul 8 04:57:40 2005 EDT > > Modified files: > /phpdoc/en/reference/strings/functions > get-html-translation-table.xml > Log: > Returns only one form (bug #33553) > Remove duplicate example, add see also > > > http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/get-html-translation-table.xml?r1=1.7&r2=1.8&ty=u > Index: phpdoc/en/reference/strings/functions/get-html-translation-table.xml > diff -u phpdoc/en/reference/strings/functions/get-html-translation-table.xml:1.7 > phpdoc/en/reference/strings/functions/get-html-translation-table.xml:1.8 > --- phpdoc/en/reference/strings/functions/get-html-translation-table.xml:1.7 Thu Aug 12 > 14:11:59 2004 > +++ phpdoc/en/reference/strings/functions/get-html-translation-table.xml Fri Jul 8 04:57:39 > 2005 > @@ -1,5 +1,5 @@ > <?xml version="1.0" encoding="iso-8859-1"?> > -<!-- $Revision: 1.7 $ --> > +<!-- $Revision: 1.8 $ --> > <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> > <refentry id="function.get-html-translation-table"> > <refnamediv> > @@ -35,6 +35,15 @@ > <constant>ENT_COMPAT</constant> mode. See the description of these modes in > <function>htmlspecialchars</function>. > </para> > + <note> > + <para> > + Special characters can be encoded in several ways. E.g. > + <literal>"</literal> can be encoded as > <literal>&amp;quot;</literal>, > + <literal>&amp;#34;</literal> or > <literal>&amp;#x22</literal>. > + <function>get_html_translation_table</function> returns only the most > + common form for them. > + </para> > + </note> > <para> > <example> > <title>Translation Table Example</title> > @@ -53,26 +62,9 @@ > Kr&amp;auml;mer".</literal> > </para> > <para> > - Another interesting use of this function is to, with help of > <function>array_flip</function>, > - change the direction of the translation. > - <informalexample> > - <programlisting role="php"> > -<![CDATA[ > -<?php > -$trans = array_flip($trans); > -$original = strtr($encoded, $trans); > -?> > -]]> > - </programlisting> > - </informalexample> > - The content of <literal>$original</literal> would be: "Hallo &amp; > - &lt;Frau> &amp; Kr&auml;mer". > - </para> > - <para> > See also <function>htmlspecialchars</function>, > - <function>htmlentities</function>, > - <function>strtr</function>, and > - <function>array_flip</function>. > + <function>htmlentities</function>, and > + <function>html_entity_decode</function>. > </para> > </refsect1> > </refentry> >