costra Sun Jun 9 15:27:27 2002 EDT
Modified files:
/phpdoc-cs/reference/strings/functions echo.xml explode.xml
get-html-translation-table.xml
get-meta-tags.xml
htmlentities.xml
Log:
Updated
Modified Files:
echo.xml (en rev. 1.3)
explode.xml (1.2)
get-html-translation-table.xml (1.2)
get-meta-tags.xml (1.2)
htmlentities.xml (1.5)
Index: phpdoc-cs/reference/strings/functions/echo.xml
diff -u phpdoc-cs/reference/strings/functions/echo.xml:1.1
phpdoc-cs/reference/strings/functions/echo.xml:1.2
--- phpdoc-cs/reference/strings/functions/echo.xml:1.1 Sun Apr 14 19:48:06 2002
+++ phpdoc-cs/reference/strings/functions/echo.xml Sun Jun 9 15:27:27 2002
@@ -14,28 +14,76 @@
<methodparam
choice="opt"><type>string</type><parameter>argn...</parameter></methodparam>
</methodsynopsis>
<simpara>
- Outputs all parameters.
+ Vytiskne v�echny parametry.
</simpara>
<para>
<function>echo</function> vlastn� nen� funkce (je to jazykov� konstrukt),
- tak�e u n�j nemus�te pou��vat z�vorky.
+ tak�e u n�j nemus�te pou��vat z�vorky. Opravdu, pokud byste pot�ebovali
+ vytisknout v�ce ne� jeden parametr, nemohli byste dokonce z�vorky
+ v�bec pou��t.
+ Proto nelze pou��t <function>echo</function> ani pro
+ <link linkend="functions.variable-functions">prom�nnou funkci</link>,
+ ov�em m�sto toho m��ete pou��t funkci <function>print</function>.
<example>
<title>Uk�zka <function>echo</function></title>
<programlisting role="php">
-echo "Hello World";
+<![CDATA[
+<?php
+echo "Nazdar sv�te";
echo "Toto zab�r�
n�kolik ��dk�. Konce ��dk� se
vytisknou tak�";
echo "Toto zab�r�\nn�kolik ��dk�. Konce ��dk� se\nvytisknou tak�.";
+
+echo "Speci�ln� znaky p�ed�azen� zp�tn�mi lom�tky lze pou��t i v �et�zci \"jako
+toto\".";
+
+//Prom�nn� lze pou��t i uvnit� p��kazu echo
+$foo = "foobar";
+$bar = "barbaz";
+
+echo "foo je $foo"; // foo je foobar
+
+// Pou�it�m jednoduch�ch uvozovek vyp��te jm�no prom�nn�, nikoli jej� hodnotu
+echo 'foo je $foo'; // foo je $foo
+
+// Jestli�e nepot�ebujete vypisovat dal�� znaky, m��ete rovnou uv�st jen n�zvy
+prom�nn�ch
+echo $foo; // foobar
+echo $foo, $bar; // foobarbarbaz
+
+echo <<<END
+Toto pou��v� "dokumentovou" syntaxi pro v�ce��dkov� v�stup
+s vlo�n�mi $prommenymi. Uv�domte si, �e ukon�ovac� �et�zec
+se st�edn�kem mus� b�t na za��tku nov�ho ��dku (bez mezer �i
+tabul�tor�).
+END;
+
+// Proto�e echo nen� funkce, n�sleduj�c� k�d je neplatn�
+($some_var) ? echo('true'): echo('false');
+
+// Nicm�n� tento p��klad fungovat bude
+($some_var) ? print('true'): print('false'); // print je funkce
+echo $some_var ? 'true': 'false'; // p��kaz mus�te uv�st p�edt�m
+?>
+]]>
</programlisting>
</example>
</para>
+ <para>
+ <function>echo</function> tak� m� zkr�cenou syntaxi, kdy je mo�n� n�sledn� za
+otv�rac�m php tagem pou��t jen znak rovn� se.
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+M�m <?=$foo?> foo.
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
<note>
<para>
- Pokud chcete echo p�edat v�ce argument�, argumenty dokonce uz�vorkovat
- nesm�te.
+ Tato zkr�cen� syntaxe bude fungovat pouze jsou-li povoleny zkr�cen� otv�rac�
+php tagy;
+ <link linkend="ini.short-open-tag">short_open_tag</link> je nastaveno na
+"on".
</para>
</note>
<simpara>
Index: phpdoc-cs/reference/strings/functions/explode.xml
diff -u phpdoc-cs/reference/strings/functions/explode.xml:1.1
phpdoc-cs/reference/strings/functions/explode.xml:1.2
--- phpdoc-cs/reference/strings/functions/explode.xml:1.1 Sun Apr 14 19:48:06
2002
+++ phpdoc-cs/reference/strings/functions/explode.xml Sun Jun 9 15:27:27 2002
@@ -4,7 +4,7 @@
<refentry id="function.explode">
<refnamediv>
<refname>explode</refname>
- <refpurpose>Rozd�lit �et�zec na jin�m �et�zci</refpurpose>
+ <refpurpose>Rozd�luje �et�zec jin�m �et�zcem</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -17,12 +17,20 @@
<para>
Vrac� pole �et�zc�, z nich� ka�d� je ��st� argumentu
<parameter>string</parameter> vznikl� jeho rozd�len�m na hranic�ch
- tvo�en�ch �et�zcem <parameter>delim</parameter>.
+ tvo�en�ch �et�zcem <parameter>separator</parameter>.
Pokud je definov�n <parameter>limit</parameter>, vr�cen� pole bude obsahovat
maxim�ln� <parameter>limit</parameter> prvk�, a posledn� prvek bude
obsahovat cel� zbytek <parameter>string</parameter>.
</para>
<note>
+ <para>
+ Je-li <parameter>separator</parameter> pr�zdn� �et�zec (""),
+ <function>explode</function> vr�t� &false;. Pokud
+ <parameter>separator</parameter> obsahuje hodnotu, kter� nen� obsa�ena
+ v <parameter>string</parameter>, pak <function>explode</function> vr�t�
+ pole obsahuj�c� cel� <parameter>string</parameter>.
+ </para>
+
<para>
Argument <parameter>limit</parameter> byl p�id�n v PHP 4.0.1
</para>
@@ -31,8 +39,13 @@
<example>
<title>Uk�zka <function>explode</function></title>
<programlisting role="php">
+<![CDATA[
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode (" ", $pizza);
+
+$data = "foo:*:1023:1000::/home/foo:/bin/sh";
+list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":",$data);
+]]>
</programlisting>
</example>
</para>
@@ -45,7 +58,10 @@
</para>
</note>
<para>
- Viz tak�: <function>split</function> a
+ Viz tak�:
+ <function>preg_split</function>,
+ <function>spliti</function>,
+ <function>split</function> a
<function>implode</function>.
</para>
</refsect1>
Index: phpdoc-cs/reference/strings/functions/get-html-translation-table.xml
diff -u phpdoc-cs/reference/strings/functions/get-html-translation-table.xml:1.1
phpdoc-cs/reference/strings/functions/get-html-translation-table.xml:1.2
--- phpdoc-cs/reference/strings/functions/get-html-translation-table.xml:1.1 Sun
Apr 14 19:48:06 2002
+++ phpdoc-cs/reference/strings/functions/get-html-translation-table.xml Sun
+Jun 9 15:27:27 2002
@@ -5,7 +5,7 @@
<refnamediv>
<refname>get_html_translation_table</refname>
<refpurpose>
- Vr�tit p�ekladovou tabulku pou��vanou v
+ Vrac� p�ekladovou tabulku pou��vanou v
<function>htmlspecialchars</function> a
<function>htmlentities</function>
</refpurpose>
Index: phpdoc-cs/reference/strings/functions/get-meta-tags.xml
diff -u phpdoc-cs/reference/strings/functions/get-meta-tags.xml:1.1
phpdoc-cs/reference/strings/functions/get-meta-tags.xml:1.2
--- phpdoc-cs/reference/strings/functions/get-meta-tags.xml:1.1 Sun Apr 14 19:48:06
2002
+++ phpdoc-cs/reference/strings/functions/get-meta-tags.xml Sun Jun 9 15:27:27
+2002
@@ -5,7 +5,7 @@
<refnamediv>
<refname>get_meta_tags</refname>
<refpurpose>
- Z�skat hodnoty content atribut� v�ech meta tag� v souboru a vr�tit pole
+ Z�sk� hodnoty content atribut� v�ech meta tag� v souboru a vr�t� pole
</refpurpose>
</refnamediv>
<refsect1>
Index: phpdoc-cs/reference/strings/functions/htmlentities.xml
diff -u phpdoc-cs/reference/strings/functions/htmlentities.xml:1.1
phpdoc-cs/reference/strings/functions/htmlentities.xml:1.2
--- phpdoc-cs/reference/strings/functions/htmlentities.xml:1.1 Sun Apr 14 19:48:09
2002
+++ phpdoc-cs/reference/strings/functions/htmlentities.xml Sun Jun 9 15:27:27
+2002
@@ -12,6 +12,7 @@
<type>string</type><methodname>htmlentities</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>
Tato funkce je ve v�em shodn� s <function>htmlspecialchars</function> krom�
@@ -24,9 +25,31 @@
uvozovky bez konverze.
</para>
<para>
- V sou�asnosti se pou��v� znakov� sada ISO-8859-1. Voliteln� druh� argument
+ V sou�asnosti se jako v�choz� znakov� sada pou��v� ISO-8859-1. Voliteln� druh�
+argument
byl p�id�n v PHP 3.0.17 a PHP 4.0.3.
</para>
+ <para>
+ Stejn� jako <function>htmlspecialchars</function> lze pomoc� t�et�ho parametru
+nastavit znakovou sadu, kter� m� b�t pou�ita p�i konverzi �et�zce. Tento t�et�
+parametr byl p�id�n v PHP 4.1.0.
+ </para>
+ <para>
+ Neexistuje ��dn� zp�tn� funkce. Ka�dop�dn� si m��ete vytvo�it vlastn�.
+N�sleduje p��klad jak na to.
+ </para>
+ <example>
+ <title>Zp�tn� <function>htmlentities</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function unhtmlentities ($string)
+{
+ $trans_tbl = get_html_translation_table (HTML_ENTITIES);
+ $trans_tbl = array_flip ($trans_tbl);
+ return strtr ($string, $trans_tbl);
+}
+?>
+]]>
+ </programlisting>
+ </example>
+
<para>
Viz tak�: <function>htmlspecialchars</function> a
<function>nl2br</function>.
