cvs: phpdoc-cs /reference/strings/functions echo.xml explode.xml get-html-translation-table.xml get-meta-tags.xml htmlentities.xml
| From: | Pavel Novak | Date: | Sun, 09 Jun 2002 19:27:27 +0000 |
| Subject: | cvs: phpdoc-cs /reference/strings/functions echo.xml explode.xml get-html-translation-table.xml get-meta-tags.xml htmlentities.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969346299@lists.php.net to get a copy of this message | ||
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>.
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>.