cynic Wed Jan 24 05:37:49 2001 EDT
Added files:
/phpdoc/cs/functions apache.xml aspell.xml bc.xml com.xml dir.xml
dl.xml filepro.xml gettext.xml http.xml
info.xml mail.xml misc.xml readline.xml
recode.xml strings.xml url.xml
Log:
second attempt :) all files should be completely translated except for
strings.xml which is nowhere near completion
Index: phpdoc/cs/functions/apache.xml
+++ phpdoc/cs/functions/apache.xml
<reference id="ref.apache">
<title>Funkce specifické pro Apache</title>
<titleabbrev>Apache</titleabbrev>
<refentry id="function.apache-lookup-uri">
<refnamediv>
<refname>apache_lookup_uri</refname>
<refpurpose>
Provádí částečný požadavek na zadanou URI a vrací všechno info o ní
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>class <function>apache_lookup_uri</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce provádí částečný požadavek na URI. Jde jen tak daleko, aby
získala všechny důležité informace o daném zdroji a vrací tyto informace
ve třídě. Vlastnosti této třídy jsou:
<simplelist>
<member>status</member>
<member>the_request</member>
<member>status_line</member>
<member>method</member>
<member>content_type</member>
<member>handler</member>
<member>uri</member>
<member>filename</member>
<member>path_info</member>
<member>args</member>
<member>boundary</member>
<member>no_cache</member>
<member>no_local_copy</member>
<member>allowed</member>
<member>send_bodyct</member>
<member>bytes_sent</member>
<member>byterange</member>
<member>clength</member>
<member>unparsed_uri</member>
<member>mtime</member>
<member>request_time</member>
</simplelist>
</para>
<note>
<simpara>
<function>Apache_lookup_uri</function> pouze, pokud je PHP nainstalováno
jako modul Apache.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.apache-note">
<refnamediv>
<refname>apache_note</refname>
<refpurpose>Získává a nastavuje poznámky požadavku u Apache.</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>apache_note</function></funcdef>
<paramdef>string <parameter>note_name</parameter></paramdef>
<paramdef>string
<parameter>
<optional>note_value</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Apache_note</function> je funkce specifická pro Apache, která
získává a nastavuje hodnoty v tabulce <literal>poznámek</literal>
požadavku. Při volání s jedním argumentem vrací současnou hodnotu poznámky
<literal>note_name</literal>. Při volání se dvěma argumenty nastavuje
hodnotu poznámky <literal>note_name</literal> na
<literal>note_value</literal>, a vrací předchozí hodnotu poznámky
<literal>note_name</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.getallheaders">
<refnamediv>
<refname>getallheaders</refname>
<refpurpose>Získává všechny hlavičky HTTP požadavku</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>getallheaders</function></funcdef>
<paramdef>void<parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrací asociativní pole všech HTTP hlaviček v současném
požadavku.
</para>
<para>
<note>
<para>
Hodnotu běžných CGI proměnných můžete také získat tím, že je přečtete
z prostředí, což funguje, ať používáte PHP jako modu Apache nebo ne.
Pokud chcete vidět seznam všech systémových proměnných definovaných tímto
způsobem, použijte <function>phpinfo</function>.
</para>
</note>
</para>
<para>
<example>
<title><function>getallheaders</function> Example</title>
<programlisting role="php">
$headers = getallheaders();
while (list ($header, $value) = each ($headers)) {
echo "$header: $value<br>\n";
}
</programlisting>
</example>
</para>
<para>
Tento příklad zobrazí všechny hlavičky současného požadavku.
<note>
<simpara>
<function>Getallheaders</function> je v současnosti podporována jen když
PHP běží jako modul <productname>Apache</productname>.
</simpara>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.virtual">
<refnamediv>
<refname>virtual</refname>
<refpurpose>Provádí sub-požadavek Apache</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>virtual</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Virtual</function> je funkce specifická pro Apache ekvivalentní
s <!--#include virtual...--> v mod_include.
Provádí sub-požadavek Apache. Je užitečná pro vkládání CGI skriptů nebo
.shtml souborů, nebo čehokoliv jiného, co má Apache parsovat. CGI skripty
musí generovat platné CGI hlavičky. To znamená, že musí přinejmenším
generovat Content-type hlavičku. Pro PHP soubory musíte použít
<function>include</function> nebo <function>require</function>;
<function>virtual</function> se nedá použít k vložení dokumentu, který je
sám PHP skriptem.
</para>
</refsect1>
</refentry>
<refentry id="function.ascii2ebcdic">
<refnamediv>
<refname>ascii2ebcdic</refname>
<refpurpose>Překládá řetězec z ASCII do EBCDIC</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ascii2ebcdic</function></funcdef>
<paramdef>string <parameter>ascii_str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ascii2ebcdic</function> je funkce specifická pro Apache dostupná
pouze na operačních systémech založených na EBCDIC (OS/390, BS2000).
Překládá (binárně bezpečně) řežězec v ASCII kódování
<parameter>ascii_str</parameter> na jeho ekvivalentní EBCDIC reprezentaci,
a vrací výsledek.
</para>
<para>
Viz také opačnou funkci <function>ebcdic2ascii</function>
</para>
</refsect1>
</refentry>
<refentry id="function.ebcdic2ascii">
<refnamediv>
<refname>ebcdic2ascii</refname>
<refpurpose>Překládá řetězec z EBCDIC do ASCII</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ebcdic2ascii</function></funcdef>
<paramdef>string <parameter>ebcdic_str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>ebcdic2ascii</function> je funkce specifická pro Apache dostupná
pouze na operačních systémech založených na EBCDIC (OS/390, BS2000).
Překládá (binárně bezpečně) řežězec v kódování EBCDIC
<parameter>ascii_str</parameter> na jeho ekvivalentní ASCII reprezentaci,
a vrací výsledek.
</para>
<para>
Viz také opačnou funkci <function>ascii2ebcdic</function>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/aspell.xml
+++ phpdoc/cs/functions/aspell.xml
<reference id="ref.aspell">
<title>Aspell funkce</title>
<titleabbrev>Aspell</titleabbrev>
<partintro>
<simpara>
<function>aspell</function> funkce umožňují ověřit hláskování slova
a nabídnout možné opravy.
</simpara>
<note>
<simpara>
aspell funguje pouze s velmi starými (do přibližně .27.*) verzemi
aspell knihovny. Tento modul, ani tyto verze aspell knihovny už nejsou
podporovány. Pokud chcete v PHP použít kontrolu hláskování, použijte
místo toho <link linkend="ref.pspell">pspell</link>. Využívá pspell
knihovnu, a pracuje s novějšími verzemi aspellu.
</simpara>
</note>
<simpara>
Budete potřebovat aspell knihovnu dostupnou z: <ulink
url="&url.aspell;">&url.aspell;</ulink>.
</simpara>
</partintro>
<refentry id="function.aspell-new">
<refnamediv>
<refname>aspell_new</refname>
<refpurpose>Načíst nový slovník</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>aspell_new</function></funcdef>
<paramdef>string <parameter>master</parameter></paramdef>
<paramdef>string <parameter>personal</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Aspell_new</function> otevře nový slovník, a vrátí identifikátor
spojení na tento slovník využitelný s dalšími aspell funkcemi.
</simpara>
<para>
<example>
<title><function>Aspell_new</function></title>
<programlisting role="php">
$aspell_link=aspell_new ("english");
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.aspell-check">
<refnamediv>
<refname>aspell_check</refname>
<refpurpose>Zkontrolovat slovo</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>aspell_check</function></funcdef>
<paramdef>int <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Aspell_check</function> zkontroluje hláskování slova a
vrátí <literal>true</literal>, pokud je hláskování správné, a
<literal>false</literal>, pokud není.
</simpara>
<para>
<example>
<title><function>Aspell_check</function></title>
<programlisting>
$aspell_link=aspell_new ("english");
if (aspell_check ($aspell_link, "testt")) {
echo "Toto je platné hláskování";
} else {
echo "Pardon, špatné hláskování";
}
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.aspell-check-raw">
<refnamediv>
<refname>aspell_check_raw</refname>
<refpurpose>
Zkontrolovat slovo beze změny velikosti písmen nebo pokusů o ořezání
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>aspell_check_raw</function></funcdef>
<paramdef>int <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Aspell_check_raw</function> zkontroluje hláskování slova beze
změn velikosti písmen nebo pokusů ho jakýmkoliv způsobem ořezat, a vrátí
<literal>true</literal>, pokud je hláskování správné, a
<literal>false</literal>, pokud není.
</simpara>
<para>
<example>
<title><function>Aspell_check_raw</function></title>
<programlisting role="php">
$aspell_link=aspell_new ("english");
if (aspell_check_raw ($aspell_link, "test")) {
echo "Toto je platné hláskování";
} else {
echo "Pardon, špatné hláskování";
}
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.aspell-suggest">
<refnamediv>
<refname>aspell_suggest</refname>
<refpurpose>Nabídnout možné hláskování slova</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>aspell_suggest</function></funcdef>
<paramdef>int <parameter>dictionary_link</parameter></paramdef>
<paramdef>string <parameter>word</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Aspell_suggest</function> vrátí pole možných hláskování
daného slova.
</simpara>
<para>
<example>
<title><function>Aspell_suggest</function></title>
<programlisting role="php">
$aspell_link=aspell_new ("english");
if (!aspell_check ($aspell_link, "test")) {
$suggestions=aspell_suggest ($aspell_link, "test");
for ($i=0; $i < count ($suggestions); $i++) {
echo "Možné hláskování: " . $suggestions[$i] . "<br>";
}
}
</programlisting>
</example>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/bc.xml
+++ phpdoc/cs/functions/bc.xml
<reference id="ref.bc">
<title>BCMath funkce pro výpočty s libovolnou přesností</title>
<titleabbrev>BC math</titleabbrev>
<partintro>
<para>
Tyto funkce jsou dostupné pouze pokud bylo PHP zkonfigurováno s
<option role="configure">--enable-bcmath</option>.
</para>
</partintro>
<refentry id="function.bcadd">
<refnamediv>
<refname>bcadd</refname>
<refpurpose>Sečíst dvě čísla s libovolnou přesností</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcadd</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Přičte <parameter>left operand</parameter> k
<parameter>right operand</parameter> a vrátí součet v řetězci.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcsub</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bccomp">
<refnamediv>
<refname>bccomp</refname>
<refpurpose>Porovnat dvě čísla s libovolnou přesností</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>bccomp</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Porovná <parameter>left operand</parameter> s
<parameter>right operand</parameter> a vrátí výsledek jako integer.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst použitých při porovnání. Návratová hodnota
je 0, pokud jsou si oba operandy rovné. Pokud je
<parameter>left operand</parameter> větší než
<parameter>right operand</parameter>, návratová hodnota je +1, a pokud je
<parameter>left operand</parameter> menší než
<parameter>right operand</parameter>, návratová hodnota je -1.
</para>
</refsect1>
</refentry>
<refentry id="function.bcdiv">
<refnamediv>
<refname>bcdiv</refname>
<refpurpose>Dělit dvě čísla s libovolnou přesností</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcdiv</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vydělí argument <parameter>left operand</parameter> argumentem
<parameter>right operand</parameter> a vrátí výsledek.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcmul</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bcmod">
<refnamediv>
<refname>bcmod</refname>
<refpurpose>Získat modulus čísla s libovolnou přesností</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcmod</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>modulus</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí modulus argumentu <parameter>left operand</parameter> s použitím
argumentu <parameter>modulus</parameter>.
</para>
<para>
Viz také <function>bcdiv</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bcmul">
<refnamediv>
<refname>bcmul</refname>
<refpurpose>Vynásobit dvě čísla s libovolnou přesností</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcmul</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vynásobí argument <parameter>left operand</parameter> argumentem
<parameter>right operand</parameter> a vrátí výsledek.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcdiv</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bcpow">
<refnamediv>
<refname>bcpow</refname>
<refpurpose>
Umocnit jedno číslo na jiné s libovolnou přesností
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcpow</function></funcdef>
<paramdef>string <parameter>x</parameter></paramdef>
<paramdef>string <parameter>y</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Umocní <parameter>x</parameter> na <parameter>y</parameter>.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcsqrt</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bcscale">
<refnamediv>
<refname>bcscale</refname>
<refpurpose>Nastavit výchozí škálu pro všechny bc math funkce
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcscale</function></funcdef>
<paramdef>int <parameter>scale</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce nastaví výchozí škálu pro všechna následná volání
bc math funkcí, ktera neudávají explicitně škálu přesnosti.
</para>
</refsect1>
</refentry>
<refentry id="function.bcsqrt">
<refnamediv>
<refname>bcsqrt</refname>
<refpurpose>
Získat druhou odmocninu čísla s libovolnou přesností
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcsqrt</function></funcdef>
<paramdef>string <parameter>operand</parameter></paramdef>
<paramdef>int <parameter>scale</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí druhou odmocninu argumentu <parameter>operand</parameter>.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcpow</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bcsub">
<refnamediv>
<refname>bcsub</refname>
<refpurpose>
Odečíst jedno číslo od druhého s libovolnou přesností
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bcsub</function></funcdef>
<paramdef>string <parameter>left operand</parameter></paramdef>
<paramdef>string <parameter>right operand</parameter></paramdef>
<paramdef>int
<parameter><optional>scale</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Odečte argument <parameter>right operand</parameter> od argumentu
<parameter>left operand</parameter> a vrátí výsledek v řetězci.
Volitelný argument <parameter>scale</parameter> se používá k
určení počtu desetinných míst ve výsledku.
</para>
<para>
Viz také <function>bcadd</function>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/com.xml
+++ phpdoc/cs/functions/com.xml
<reference id="ref.com">
<title>Funkce na podporu COM ve Windows</title>
<titleabbrev>COM</titleabbrev>
<partintro>
<simpara>
Tyto funkce jsou dostupné pouze ve Windows verzi PHP. Tyto funkce byly
přidány v PHP 4.
</simpara>
</partintro>
<refentry id="function.com-load">
<refnamediv>
<refname>com_load</refname>
<refpurpose>
Creates a new reference to a COM component
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>com_load</function></funcdef>
<paramdef>string <parameter>module name</parameter></paramdef>
<paramdef>string
<parameter>
<optional>server name</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>com_load</function> vytváří novou COM komponentu a vrací odkaz
na ni. Při neúspěchu vrací <literal>false</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-invoke">
<refnamediv>
<refname>com_invoke</refname>
<refpurpose>
Volá metodu COM komponenty.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>com_invoke</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>function_name</parameter></paramdef>
<paramdef>mixed
<parameter>
<optional>function parameters, ...</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Com_invoke</function> volá metodu COM komponenty odkazované
<parameter>com_object</parameter>. Pokud dojde k chybě, vrací
<literal>false</literal>, při úspěchu vrací návratovou hodnotu metody
<parameter>function_name</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-propget">
<refnamediv>
<refname>com_propget</refname>
<refpurpose>
Získává hodnotu vlastnosti COM komponenty
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>com_propget</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>property</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce je alias k <function>com_get</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-get">
<refnamediv>
<refname>com_get</refname>
<refpurpose>
Získává hodnotu vlastnosti COM komponenty
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>com_get</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>property</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrací hodnotu <parameter>property</parameter> COM komponenty odkazované
<parameter>com_object</parameter>. Při chybě vrací <literal>false</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-propput">
<refnamediv>
<refname>com_propput</refname>
<refpurpose>
Přiřazuje hodnotu vlastnosti COM komponenty.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>com_propput</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>property</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce je alias ke <function>com_set</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-propset">
<refnamediv>
<refname>com_propset</refname>
<refpurpose>
Přiřazuje hodnotu vlastnosti COM komponenty.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>com_propset</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>property</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce je alias ke <function>com_set</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.com-set">
<refnamediv>
<refname>com_set</refname>
<refpurpose>
Přiřazuje hodnotu vlastnosti COM komponenty.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>com_set</function></funcdef>
<paramdef>resource <parameter>com_object</parameter></paramdef>
<paramdef>string <parameter>property</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Nastavuje hodnotu vlastnosti <parameter>property</parameter> COM
komponent odkazované <parameter>com_object</parameter>.
Vrací <literal>true</literal>, pokud je <parameter>property</parameter>
nastaveno. Při chybě vrací <literal>false</literal>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/dir.xml
+++ phpdoc/cs/functions/dir.xml
<reference id="ref.dir">
<title>Adresářové funkce</title>
<titleabbrev>Adresáře</titleabbrev>
<refentry id="function.chdir">
<refnamediv>
<refname>chdir</refname>
<refpurpose>change directory</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>chdir</function></funcdef>
<paramdef>string <parameter>directory</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Mění aktuální adresář PHP na <parameter>directory</parameter>. Pokud se
nepodařilo změnít adresář, vrací FALSE, jinak TRUE.
</para>
</refsect1>
</refentry>
<refentry id="class.dir">
<refnamediv>
<refname>dir</refname>
<refpurpose>directory class</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>new <function>dir</function></funcdef>
<paramdef>string <parameter>directory</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Pseudo-objektově orientovaný mechanismus pro čtení adresáře. Otevře zadaný
<parameter>directory</parameter>. Po otevření adresáře jsou přístupné dvě
vlastnosti. Vlastnost handle je použitelná s jinými adresářovými funkcemi
jako <function>readdir</function>, <function>rewinddir</function> a
<function>closedir</function>. Hodnotou vlastnosti path je cesta k
otevřenému adresáři. Dále jsou přístupné tři metody:
read, rewind a close.
<example>
<title><function>Dir</function> příklad</title>
<programlisting role="php">
$d = dir("/etc");
echo "Handle: ".$d->handle."<br>\n";
echo "Path: ".$d->path."<br>\n";
while($entry=$d->read()) {
echo $entry."<br>\n";
}
$d->close();
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.closedir">
<refnamediv>
<refname>closedir</refname>
<refpurpose>Zavírá otevřený adresář</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>closedir</function></funcdef>
<paramdef>int <parameter>dir_handle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Zavírá proud z adresáře specifikovaný v <parameter>dir_handle</parameter>.
Proud musí pocházet z funkce <function>opendir</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.getcwd">
<refnamediv>
<refname>getcwd</refname>
<refpurpose>Získává aktuální pracovní adresář</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>getcwd</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
Vrací aktuální pracovní adresář.
</para>
</refsect1>
</refentry>
<refentry id="function.opendir">
<refnamediv>
<refname>opendir</refname>
<refpurpose>Otevře adresář</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>opendir</function></funcdef>
<paramdef>string <parameter>path</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrací deskriptor adresáře použitelný v následných voláních
<function>closedir</function>, <function>readdir</function>, a
<function>rewinddir</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.readdir">
<refnamediv>
<refname>readdir</refname>
<refpurpose>Přečte položku z deskriptoru adresáře</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>readdir</function></funcdef>
<paramdef>int <parameter>dir_handle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrací název dalšího souboru v adresáři. Názvy souborů nejsou nijak
tříděny.
<example>
<title>Vypiš všechny soubory v adresáři</title>
<programlisting role="php">
// Note that !== did not exist until 4.0.0-RC2
<?php
$handle=opendir('.');
echo "Directory handle: $handle\n";
echo "Files:\n";
while (($file = readdir($handle))!==false) {
echo "$file\n";
}
closedir($handle);
?>
</programlisting>
</example>
</para>
<para>
Všimněte si, že <function>readdir</function> vráží také . a
.. položky. Pokud je nechcete, můžete je snadno vynechat:
<example>
<title>
Vypiš všechny soubory v adresáři a vynech . a ..
</title>
<programlisting role="php">
<?php
$handle=opendir('.');
while (false!==($file = readdir($handle))) {
if ($file != "." && $file != "..") {
echo "$file\n";
}
}
closedir($handle);
?>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.rewinddir">
<refnamediv>
<refname>rewinddir</refname>
<refpurpose>rewind directory handle</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>rewinddir</function></funcdef>
<paramdef>int <parameter>dir_handle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Resets the directory stream indicated by
<parameter>dir_handle</parameter> to the beginning of the
directory.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/dl.xml
+++ phpdoc/cs/functions/dl.xml
<reference id="ref.dl">
<title>Funkce pro dynamické načítání</title>
<titleabbrev>Dyn. načítání</titleabbrev>
<refentry id="function.dl">
<refnamediv>
<refname>dl</refname>
<refpurpose>načte extenzi PHP za běhu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dl</function></funcdef>
<paramdef>string <parameter>library</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Načte extenzi PHP definovanou v <parameter>library</parameter>. Viz také
konfigurační direktivu <link linkend="ini.extension-dir">extension_dir</link>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/filepro.xml
+++ phpdoc/cs/functions/filepro.xml
<reference id="ref.filepro">
<title>filePro funkce</title>
<titleabbrev>filePro</titleabbrev>
<partintro>
<simpara>
Tyto funkce umožňují read-only (pouze pro čtení) přístup k datům uloženým
ve filePro databázích.
</simpara>
<simpara>
filePro je registrovaná obchodní značka Fiserv, Inc. Více informací o filePro
najdete na <ulink url="&url.filepro;">&url.filepro;</ulink>.
</simpara>
</partintro>
<refentry id="function.filepro">
<refnamediv>
<refname>filepro</refname>
<refpurpose>Přečíst a ověřit mapový soubor</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>filepro</function></funcdef>
<paramdef>string <parameter>directory</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Přečte a ověří mapový soubor a uloží počet sloupců a info.</para>
<para>
Nedochází k zamykání, takže byste se měli vyhnout úpravám vaší filePro
databáze, pokud může být otevřena v PHP.
</para>
</refsect1>
</refentry>
<refentry id="function.filepro-fieldname">
<refnamediv>
<refname>filepro_fieldname</refname>
<refpurpose>Zjistit název sloupce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>filepro_fieldname</function></funcdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí název sloupce odpovídajícího <parameter>field_number</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.filepro-fieldtype">
<refnamediv>
<refname>filepro_fieldtype</refname>
<refpurpose>Zjistit typ sloupce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>filepro_fieldtype</function></funcdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí editační typ sloupce odpovídajícího <parameter>field_number</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.filepro-fieldwidth">
<refnamediv>
<refname>filepro_fieldwidth</refname>
<refpurpose>Zjistit šířku sloupce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>filepro_fieldwidth</function></funcdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí šířku sloupce odpovídajícího <parameter>field_number</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.filepro-retrieve">
<refnamediv>
<refname>filepro_retrieve</refname>
<refpurpose>Získat data z filePro databáze</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>filepro_retrieve</function></funcdef>
<paramdef>int <parameter>row_number</parameter></paramdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Vrátí data z určeného místa v databázi.</para>
</refsect1>
</refentry>
<refentry id="function.filepro-fieldcount">
<refnamediv>
<refname>filepro_fieldcount</refname>
<refpurpose>Zjistit, kolik sloupců je ve filePro databázi</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>filepro_fieldcount</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>Vrátí počet polí (sloupců) v otevřené filePro databázi.</para>
<para>
Viz také <function>filepro</function>.</para>
</refsect1>
</refentry>
<refentry id="function.filepro-rowcount">
<refnamediv>
<refname>filepro_rowcount</refname>
<refpurpose>Zjistit, kolik řádků je ve filePro databázi</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>filepro_rowcount</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>Vrátí počet řádků v otevřené filePro databázi.</para>
<para>
Viz také <function>filepro</function>.</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/gettext.xml
+++ phpdoc/cs/functions/gettext.xml
<reference id="ref.gettext">
<title>GNU Gettext</title>
<titleabbrev>gettext</titleabbrev>
<partintro>
<simpara>
Gettext funkce implementujíc NLS (Native Language Support)
API, která se dá použít k internacionalizaci vašich PHP
aplikací. Důkladné vysvětlení těchto funkcí viz dokumentaci
GNU Gettext.
</simpara>
</partintro>
<refentry id="function.bindtextdomain">
<refnamediv>
<refname>bindtextdomain</refname>
<refpurpose>Nastavit cestu pro doménu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bindtextdomain</function></funcdef>
<paramdef>string <parameter>domain</parameter></paramdef>
<paramdef>string <parameter>directory</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkce <function>bindtextdomain</function> nastaví cestu pro doménu.
</para>
</refsect1>
</refentry>
<refentry id="function.dcgettext">
<refnamediv>
<refname>dcgettext</refname>
<refpurpose>Změnit doménu pro jediné vyhledání</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dcgettext</function></funcdef>
<paramdef>string <parameter>domain</parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
<paramdef>int <parameter>category</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vám umožní zmenit současnou doménu pro jediné vyhledání
zprávy. Umožňuje také specifikovat kategorii.
</para>
</refsect1>
</refentry>
<refentry id="function.dgettext">
<refnamediv>
<refname>dgettext</refname>
<refpurpose>Změnit současnou doménu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dgettext</function></funcdef>
<paramdef>string <parameter>domain</parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkce <function>dgettext</function> umožňuje změnit současnou doménu
pro jediné vyhledání zprávy.
</para>
</refsect1>
</refentry>
<refentry id="function.gettext">
<refnamediv>
<refname>gettext</refname>
<refpurpose>Vyhledat zprávu v současné doméně</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>gettext</function></funcdef>
<paramdef>string <parameter>message</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí přeložený řetězec, pokud jej najde v překladové
tabulce, nebo předaný řetězec, pokud jej nenajde. Jako alias k této
funkci můžete použít podtržítko.
</para>
<example>
<title><function>Gettext</function>-check</title>
<programlisting>
<?php
// Set language to German
putenv ("LANG=de");
// Specify location of translation tables
bindtextdomain ("myPHPApp", "./locale");
// Choose domain
textdomain ("myPHPApp");
// Print a test message
print (gettext ("Vítejte v mé PHP Aplikaci"));
?>
</programlisting>
</example>
</refsect1>
</refentry>
<refentry id="function.textdomain">
<refnamediv>
<refname>textdomain</refname>
<refpurpose>Nastavit výchozí doménu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>textdomain</function></funcdef>
<paramdef>string <parameter>text_domain</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce nastaví doménu pro vyhledávání při volání funkce
<function>gettext</function>, obvykle pojmenovanou podle aplikace.
Vrátí předchozí výchozí doménu. Při volání bez argumentů vrátí současné
nastavení, aniž by jej měnila.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/http.xml
+++ phpdoc/cs/functions/http.xml
<reference id="ref.http">
<title>HTTP funkce</title>
<titleabbrev>HTTP</titleabbrev>
<partintro>
<simpara>
Tyto funkce vám umožňují manipulovat výstupem posílaným zpět browseru
přímo na úrovni HTTP protokolu.
</simpara>
</partintro>
<refentry id="function.header">
<refnamediv>
<refname>header</refname>
<refpurpose>Poslat HTTP hlavičku</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>header</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Funkce <function>Header</function> se používá na začátku HTML souboru
k odeslání HTTP hlaviček. Více informací o HTTP hlavičkách viz <ulink
url="&spec.http1.1;">Specifikace HTTP 1.1</ulink>.
<emphasis>Poznámka:</emphasis> Pamatujte, že funkce
<function>Header</function> musí být volána dříve než se odešle jakýkoliv
normální výstup, ať už normálními HTML tagy, nebo z PHP. Velmi obvyklou
chybou je načítat kód pomocí <function>include</function> nebo
auto_prepend a mít v tomto kódu prázdné řádky, které způsobí odeslání
výstupu před voláním funkce <function>header</function>.
</para>
<para>
Existují dva zvláštní případy volání funkce <function>header</function>.
Prvním je hlavička "Location". Ta nejenže odešle hlavičku
browseru, ale navíc i vrátí Apachi stavový kód REDIRECT. Z pohledu autora
skriptu by to nemělo být důležité, ale je to důležité pro lidi, kteří
rozumí vnitřnostem Apache.
<informalexample>
<programlisting role="php">
header ("Location: http://www.php.net"); /* Přesměrujeme browser
na web site PHP */
exit; /* Pojistíme si, že se další kód nevykoná po
přesměrování. */
</programlisting>
</informalexample>
</para>
<para>
Druhým zvláštním případem jsou všechny hlavičky začínající řetězcem
"HTTP/" (velikost písmen nehraje roli). Například, pokud
direktiva ErrorDocument 404 vašeho Apache ukazuje na PHP skript, nebylo
by od věci, kdyby skutečně generoval 404. První věcí, kterou byste v tomto
skriptu měli udělat tudíz bude:
<informalexample>
<programlisting role="php">
header ("HTTP/1.0 404 Not Found");
</programlisting>
</informalexample>
</para>
<para>
PHP skripty často generují dynamické HTML, které nesmí být cachováno
uživatelským browserem, ani žýdnými proxynami mezi serverem a uživatelským
browserem. Mnoho proxyn a klientů se dá donutit k vypnutí cachování s pomocí
<informalexample>
<programlisting role="php">
header ("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // datum v minulosti
header ("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
// vždy upraven
header ("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
header ("Pragma: no-cache"); // HTTP/1.0
</programlisting>
</informalexample>
</para>
<para>
Viz také <function>headers_sent</function>
</para>
</refsect1>
</refentry>
<refentry id="function.headers-sent">
<refnamediv>
<refname>headers_sent</refname>
<refpurpose>Vrátit true, pokud byly odeslány hlavičky</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>headers_sent</function></funcdef>
<paramdef><parameter>void</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí <literal>true</literal>, pokud už byly HTTP hlavičky
odeslány, jinak <literal>false</literal>.
</para>
<para>
Viz také <function>header</function>
</para>
</refsect1>
</refentry>
<refentry id="function.setcookie">
<refnamediv>
<refname>setcookie</refname>
<refpurpose>Poslat cookie</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>setcookie</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>string
<parameter><optional>value</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>expire</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>path</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>domain</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>secure</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Setcookie</function> definuje cookie, který se pošle
spolu s hlavičkami. Cookies se musí odeslat jako
<emphasis>první</emphasis> ze všech HTTP hlaviček (to je omezení
cookies, ne PHP). Volání této funkce musíte tudíž umístit před
<literal><html></literal> či <literal><head></literal> tagy.
</para>
<para>
Všechny argumenty kromě argumentu <parameter>name</parameter> jsou
nepovinné. Pokud je přítomný pouze argument
<parameter>name</parameter>, u klienta se smaže cookie tohoto jména.
Kterýkoliv argument můžete také nahradit prázdným řetězcem
(<emphasis>""</emphasis>), čímž tento argument přeskočíte.
Argumenty <parameter>expire</parameter> a <parameter>secure</parameter>
jsou celočíselné a nedají se přeskočit prázdným řetězcem. Místo toho
použijte nulu (<emphasis>0</emphasis>). Argument
<parameter>expire</parameter> je běžné Unixové celočíselné vyjádření
času, jak je vrací funkce <function>time</function> či
<function>mktime</function>. Argument <parameter>secure</parameter>
indikuje, že by se tento cookie měl přenášet pouze po zabezpečeném
HTTPS spojení.
</para>
<para>
Běžné zádrhele:
<itemizedlist>
<listitem>
<simpara>
Cookies jsou přístupné až při dalším načtení stránky, na které přístupné
být mají.
</simpara>
</listitem>
<listitem>
<simpara>
Cookies se musí mazat se stejnými parametry, se kterými byly odeslány.
</simpara>
</listitem>
</itemizedlist>
</para>
<simpara>
V PHP 3 se vícenásobná volání <function>setcookie</function> v jednom
skriptu provedou v opačném pořadí. Pokud se pokoušíte smazat jeden
cookie pře odesláním jiného, měli byste umístit vložení před smazání.
V PHP 4 se vícenásobná volání <function>setcookie</function> provedou
v tom pořadí, jak jsou volána.
</simpara>
<para>
Několik příkladů, jak posílat cookies:
<example>
<title>Ukázky odeslání cookies pomocí <function>setcookie</function></title>
<programlisting role="php">
setcookie ("TestCookie", "Zkušební hodnota");
setcookie ("TestCookie", $value,time()+3600); /* vyprší za hodinu */
setcookie ("TestCookie", $value,time()+3600, "/~rasmus/", ".utoronto.ca", 1);
</programlisting>
</example>
</para>
<para>
Následují příklady mazání cookies z předchozí ukázky:
<example>
<title>Ukázky mazání cookies pomocí <function>setcookie</function></title>
<programlisting role="php">
setcookie ("TestCookie");
// nastaví dobu vypršení na čas před hodinou
setcookie ("TestCookie", "", time() - 3600);
setcookie ("TestCookie", "", time() - 3600, "/~rasmus/", ".utoronto.ca", 1);
</programlisting>
</example>
Při mazání cookie byste se měli ujistit, že je doba vypršení v minulosti,
čímž se v browseru zapne mechanismus odstranění cookie.
</para>
<para>
Všimněte si, že hodnotová část cookie se při odeslání cookie automaticky
url-zakóduje, a při přijetí se automaticky dekóduje a přiřadí proměnné
stejného jména, jako je jméno cookie. Pokud chcete vidět obsah našeho
zkušebního cookie, použijte některý z následujících příkladů:
<informalexample>
<programlisting role="php">
echo $TestCookie;
echo $HTTP_COOKIE_VARS["TestCookie"];
</programlisting>
</informalexample>
</para>
<para>
Cookies obsahující pole můžete také odeslat tak, že za název cookie napíšete
hranaté závorky. Účinkem tohoto je odeslání tolika cookies, kolik má vaše
pole prvků, ale když váš skript tyto cookies přijme, hodnoty se umístí
v poli stejného jména, jako jsou vaše cookies:
<informalexample>
<programlisting role="php">
setcookie ("cookie[three]", "cookiethree");
setcookie ("cookie[two]", "cookietwo");
setcookie ("cookie[one]", "cookieone");
if (isset ($cookie)) {
while (list ($name, $value) = each ($cookie)) {
echo "$name == $value<br>\n";
}
}
</programlisting>
</informalexample>
</para>
<para>
Více informací o cookies viz specifikace cookies na <ulink
url="&spec.cookies;">&spec.cookies;</ulink>.
</para>
<simpara>
Microsoft Internet Explorer 4 se Service Packem 1 zpracovává chybně
cookies, které mají nastavený argument <parameter>path</parameter>.
</simpara>
<simpara>
Netscape Communicator 4.05 a Microsoft Internet Explorer 3.x zřejmě
nezpracují cookies správně, pokud nejsou nastaveny argumenty
<parameter>path</parameter> a <parameter>time</parameter>.
</simpara>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/info.xml
+++ phpdoc/cs/functions/info.xml
<reference id="ref.info">
<title>PHP volby & informace</title>
<titleabbrev>PHP volby/info</titleabbrev>
<refentry id="function.assert">
<refnamediv>
<refname>assert</refname>
<refpurpose>Ověřit, jestli je výrok neplatný</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>assert</function></funcdef>
<paramdef>string|bool <parameter>assertion</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>assert</function> ověří předanou
<parameter>assertion</parameter> a provede příslušnou akci, pokud je
výsledek <literal>false</literal>.
</para>
<para>
Pokud je předaná <parameter>assertion</parameter> řetězec, vyhodnotí se
funkcí <function>assert</function> jako PHP kód.
Výhody řetězcové <parameter>assertion</parameter> jsou menší režie, když
je kontrola výroků vypnutá, a zprávy obsahující
<parameter>assertion</parameter> výraz, když výrok selže.
</para>
<para>
Kontrola výroků by se měla používat jen pro odlaďování skriptů. Můžete je
použít na kontrolu podmínek, které by měly být vždycky true, a které jinak
indikují nějaké chyby v programování, nebo na kontrolu existence určitých
vlastností, jako jsou funkce obsažené v extenzích, nebo určité systémové
limity a vlastnosti.
</para>
<para>
Výroky by se neměly používat pro běžné operace jako kontrola vstupních
parametrů. Jako základní pravidlo platí, že váž kód by měl fungovat
správně, pokud není kontrola výroků aktivována.
</para>
<para>
Chování funkce <function>assert</function> lze konfigurovat skrze
<function>assert_options</function> nebo .ini direktivy popsané na
manuálové stránce této funkce.
</para>
</refsect1>
</refentry>
<refentry id="function.assert-options">
<refnamediv>
<refname>assert_options</refname>
<refpurpose>Nastavit/získat různé příznaky výroků</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>assert_options</function></funcdef>
<paramdef>int <parameter>what</parameter></paramdef>
<paramdef>mixed
<parameter><optional>value</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
S použitím funkce <function>assert_options</function> můžete nastavit
různé řídící volby funkce <function>assert</function>, nebo jen získat
jejich současné nastavení.
</para>
<table>
<title>Volby výroků</title>
<tgroup cols="4">
<thead>
<row>
<entry>volba</entry>
<entry>ini parametr</entry>
<entry>výchozí hodnota</entry>
<entry>popis</entry>
</row>
</thead>
<tbody>
<row>
<entry>ASSERT_ACTIVE</entry>
<entry>assert.active</entry>
<entry>1</entry>
<entry>zapne <function>assert</function>
vyhodnocování</entry>
</row>
<row>
<entry>ASSERT_WARNING</entry>
<entry>assert.warning</entry>
<entry>1</entry>
<entry>vytvoří PHP varování pro každý selhavší
výrok</entry>
</row>
<row>
<entry>ASSERT_BAIL</entry>
<entry>assert.bail</entry>
<entry>0</entry>
<entry>ukončí provádění skiptu, pokud výrok
selže</entry>
</row>
<row>
<entry>ASSERT_QUIET_EVAL</entry>
<entry>assert.quiet_eval</entry>
<entry>0</entry>
<entry>
vypne error_reporting během vyhodnocování výrazů
výroků
</entry>
</row>
<row>
<entry>ASSERT_CALLBACK</entry>
<entry>assert_callback</entry>
<entry>(null)</entry>
<entry>uživatelská funkce, která se zavolá pro každý
selhavší výrok</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
<function>assert_options</function> vrací původní nastavení volby, nebo
<literal>false</literal> při chybě.
</para>
</refsect1>
</refentry>
<refentry id="function.extension-loaded">
<refnamediv>
<refname>extension_loaded</refname>
<refpurpose>zjistit, jestli je extenze načtená</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>extension_loaded</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrací true, pokud je extenze identifikovaná argumentem
<parameter>name</parameter> načtena. Názvy různých extenzí můžete vidět,
pokud použijete <function>phpinfo</function>.
</simpara>
<para>
Viz také <function>phpinfo</function>.
<note>
<para>
Tato funkce byla přidána v PHP 3.0.10.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.dl">
<refnamediv>
<refname>dl</refname>
<refpurpose>Načíst extenzi PHP za běhu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dl</function></funcdef>
<paramdef>string <parameter>library</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Načte extenzi PHP definovanou v <parameter>library</parameter>. Viz také
konfigurační direktivu <link linkend="ini.extension-dir">extension_dir</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.getenv">
<refnamediv>
<refname>getenv</refname>
<refpurpose>Získat hodnotu systémové proměnné</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>getenv</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí hodnotu systémové proměnné <parameter>varname</parameter>,
nebo false při chybě.
<informalexample>
<programlisting>
$ip = getenv ("REMOTE_ADDR"); // získá IP adresu uživatele
</programlisting>
</informalexample>
</para>
<para>
Seznam všech systémových proměnných si můžete prohlédnout použitím
<function>phpinfo</function>. Význam mnoha z nich najdete v
<ulink url="&url.cgispecs;">CGI specifikaci</ulink>, zvláště na <ulink
url="&url.cgispec;">stránce o systémových proměnných</ulink>.
<note>
<para>
Tato funkce nefunguje v ISAPI módu.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.get-cfg-var">
<refnamediv>
<refname>get_cfg_var</refname>
<refpurpose>Získat hodnotu volby z konfigurace PHP</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>get_cfg_var</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí současnou hodnotu konfigurační proměnné PHP určené argumentem
<parameter>varname</parameter>, nebo false pokud dojde k chybě.
</simpara>
<simpara>
Nevrací konfigurační hodnoty nastavené při kompilaci PHP a nečte
konfigurační soubor Apache (použití php3_configuration_option direktiv).
</simpara>
<simpara>
Pokud chcete zjistit, jestli daný systém používá
<link linkend="configuration.file">konfigurační soubor</link>, zkuste
získat hodnotu konfigurační volby cfg_file_path. Pokud je tato dostupná,
používá se konfigurační soubor.
</simpara>
</refsect1>
</refentry>
<refentry id="function.get-current-user">
<refnamediv>
<refname>get_current_user</refname>
<refpurpose>Získat jméno vlastníka současného PHP skriptu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>get_current_user</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí jméno vlastníka současného PHP skriptu.
</simpara>
<simpara>
Viz také <function>getmyuid</function>,
<function>getmypid</function>, <function>getmyinode</function>,
a <function>getlastmod</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.get-magic-quotes-gpc">
<refnamediv>
<refname>get_magic_quotes_gpc</refname>
<refpurpose>Získat současné aktivní nastavení magic_quotes_gpc</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>long <function>get_magic_quotes_gpc</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí současné aktivní nastavení
<link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>.
(0 pro vypnuto, 1 pro zapnuto).
</simpara>
<simpara>
Viz také <function>get_magic_quotes_runtime</function>,
<function>set_magic_quotes_runtime</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.get-magic-quotes-runtime">
<refnamediv>
<refname>get_magic_quotes_runtime</refname>
<refpurpose>Vrátit současné aktivní nastavení magic_quotes_runtime</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>long
<function>get_magic_quotes_runtime</function>
</funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí současné aktivní nastavení
<link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>.
(0 pro vypnuto, 1 pro zapnuto).
</simpara>
<simpara>
Viz také <function>get_magic_quotes_gpc</function>,
<function>set_magic_quotes_runtime</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.getlastmod">
<refnamediv>
<refname>getlastmod</refname>
<refpurpose>Získat čas poslení modifikace skriptu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getlastmod</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí čas poslení modifikace současné stránky. Návratová hodnota je Unixový
timestamp, vhodný jako vstup pro <function>date</function>. Při chybě vrací
false.
<example>
<title>getlastmod() příklad</title>
<programlisting role="php">
// outputs e.g. 'Last modified: March 04 1998 20:43:59.'
echo "Last modified: ".date ("F d Y H:i:s.", getlastmod());
</programlisting>
</example>
</para>
<para>
See alse <function>date</function>,
<function>getmyuid</function>,
<function>get_current_user</function>,
<function>getmyinode</function>, and
<function>getmypid</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.getmyinode">
<refnamediv>
<refname>getmyinode</refname>
<refpurpose>Získat inode současného skriptu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getmyinode</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí inode současného skriptu, nebo false při chybě.
</para>
<para>
Viz také <function>getmyuid</function>,
<function>get_current_user</function>,
<function>getmypid</function>, and
<function>getlastmod</function>.
</para>
<note>
<simpara>
Tato funkce není podporována na Windows systémech.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.getmypid">
<refnamediv>
<refname>getmypid</refname>
<refpurpose>Získat process ID PHP</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getmypid</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí process ID současného PHP procesu, nebo false při chybě.
</para>
<warning>
<para>
Process ID nejsou unikátní, a jsou tudíž slabým zdrojem entropie.
Nedoporučujeme používat PIDy v prostředích závislých na bezpečnosti.
</para>
</warning>
<para>
Viz také <function>getmyuid</function>,
<function>get_current_user</function>,
<function>getmyinode</function>, a
<function>getlastmod</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.getmyuid">
<refnamediv>
<refname>getmyuid</refname>
<refpurpose>Získat UID majitele PHP skriptu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getmyuid</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí user ID současného skriptu, nebo false při chybě.
</simpara>
<simpara>
Viz také <function>getmypid</function>,
<function>get_current_user</function>,
<function>getmyinode</function>, a
<function>getlastmod</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.getrusage">
<refnamediv>
<refname>getrusage</refname>
<refpurpose>Získat informace o současném využití zdrojů</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>getrusage</function></funcdef>
<paramdef>int
<parameter><optional>who</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Toto je rozhraní ke to getrusage(2). Vrátí asociativní pole obsahující
všechna data vrácená systémovým voláním. Pokud je who 1, getrusage se
zavolá s RUSAGE_CHILDREN.
</para>
<para>
Všechny položky jsou přístupné skrze svá dokumentovaná jména.
<example>
<title>Getrusage příklad</title>
<programlisting role="php">
$dat = getrusage();
echo $dat["ru_nswap"]; # počet swapů
echo $dat["ru_majflt"]; # počet page faultů
echo $dat["ru_utime.tv_sec"]; # využitý uživatelský čas (sekundy)
echo $dat["ru_utime.tv_usec"]; # využitý uživatelský čas (mikrosekundy)
</programlisting>
</example>
Další detaily viz man stránka getrusage(2) na vašem systému.
</para>
</refsect1>
</refentry>
<refentry id="function.ini-alter">
<refnamediv>
<refname>ini_alter</refname>
<refpurpose>Změnit hodnotu konfigurační volby</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ini_alter</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>string <parameter>newvalue</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Změní hodnotu konfigurační volby, vrátí <literal>false</literal> při
selhání, a předchozí hodnotu konfigurační volby při úspěchu.
</para>
<note>
<para>
Toto je alias k <function>ini_set</function>
</para>
</note>
<para>
Viz také <function>ini_get</function>,
<function>ini_restore</function>,
<function>ini_set</function>
</para>
</refsect1>
</refentry>
<refentry id="function.ini-get">
<refnamediv>
<refname>ini_get</refname>
<refpurpose>Získat hodnotu konfigurační volby</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ini_get</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí hodnotu konfigurační volby při úspěchu, <literal>false</literal> při
selhání.
</para>
<para>
Viz také <function>ini_alter</function>,
<function>ini_restore</function>,
<function>ini_set</function>
</para>
</refsect1>
</refentry>
<refentry id="function.ini-restore">
<refnamediv>
<refname>ini_restore</refname>
<refpurpose>Obnovit původní hodnotu konfigurační volby</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ini_restore</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Obnoví původní hodnotu konfigurační volby.
</para>
<para>
Viz také <function>ini_alter</function>,
<function>ini_get</function>,
<function>ini_set</function>
</para>
</refsect1>
</refentry>
<refentry id="function.ini-set">
<refnamediv>
<refname>ini_set</refname>
<refpurpose>Změnit hodnotu konfigurační volby</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ini_set</function></funcdef>
<paramdef>string <parameter>varname</parameter></paramdef>
<paramdef>string <parameter>newvalue</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Změní hodnotu konfigurační volby, vrátí <literal>false</literal> při
selhání, a předchozí hodnotu konfigurační volby při úspěchu.
</para>
<para>
Viz také <function>ini_alter</function>,
<function>ini_get</function>,
<function>ini_restore</function>
</para>
</refsect1>
</refentry>
<refentry id="function.phpcredits">
<refnamediv>
<refname>phpcredits</refname>
<refpurpose>Vytisknout credits pro PHP</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>phpcredits</function></funcdef>
<paramdef>int <parameter>flag</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vytiskne credits vč. seznamu vývojářů PHP, modulů, atd.
Generuje příslušný HTML kód, kterým se tyto informace vkládají do stránky.
Je třeba předat argument indikující co se vytiskne (předdefinovaná
konstanta flag, viz níže). Například k vytištění všeobecných credits můžete
někde ve svém kódu použít:
<informalexample>
<programlisting role="php">
..
phpcredits(CREDITS_GENERAL);
..
</programlisting>
</informalexample>
A pokud chcete vytisknout užší kruh vývojářů a dokumentační skupinu
na samostatné stránce, použijte:
<informalexample>
<programlisting role="php">
<?php
phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);
?>
</programlisting>
</informalexample>
A pokud chcete vložit všechny credits do vlastní stránky, pomůže vám
následující kód:
<informalexample>
<programlisting role="php">
<html>
<head>
<title>Má stránka s credits</title>
</head>
<body>
<?php
// váš vlastní kód
phpcredits(CREDITS_ALL + CREDITS_FULLPAGE);
// další kód
?>
</body>
</html>
</programlisting>
</informalexample>
</para>
<para>
</para>
<para>
<table>
<title>Předdefinované <function>phpcredits</function> příznaky</title>
<tgroup cols="2">
<thead>
<row>
<entry>název</entry>
<entry>popis</entry>
</row>
</thead>
<tbody>
<row>
<entry>CREDITS_ALL</entry>
<entry>
Všechny credits, ekvivalentní k:
CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP +
CREDITS_MODULES + CREDITS_FULLPAGE. Vygeneruje
kompletní
samostatnou HTML stránku s příslušnými tagy.
</entry>
</row>
<row>
<entry>CREDITS_DOCS</entry>
<entry>Credits dokumentačního týmu</entry>
</row>
<row>
<entry>CREDITS_FULLPAGE</entry>
<entry>
Obvykle se používá v kombinaci s jinými příznaky.
Indikuje, že
se má vytisknout kompletní samostatná HTML stránka,
včetně
informací indikovaných jinými příznaky.
</entry>
</row>
<row>
<entry>CREDITS_GENERAL</entry>
<entry>
Všeobecné credits: Design a koncept jazyka, autoři
PHP 4.0 a
SAPI modul.
</entry>
</row>
<row>
<entry>CREDITS_GROUP</entry>
<entry>Seznam užšího kruhu vývojářů</entry>
</row>
<row>
<entry>CREDITS_MODULES</entry>
<entry>Seznam rozšiřujících modulů (extenzí) PHP a
jejich
autorů</entry>
</row>
<row>
<entry>CREDITS_SAPI</entry>
<entry>Seznam server API modulů PHP a jejich
autorů</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Viz také <function>phpinfo</function>,
<function>phpversion</function>,
<function>php_logo_guid</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.phpinfo">
<refnamediv>
<refname>phpinfo</refname>
<refpurpose>Vytisknout spoustu informací o PHP</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>phpinfo</function></funcdef>
<paramdef>int <parameter><optional>what</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vytiskne velké množství informací o současném stavu PHP. To zahrnuje
informace o kompilačních volbách a extenzích, verzi PHP, informaci o serveru
a systémů (pokud je PHP zkompilováno jako modul), PHP prostředí, verzi OS,
cesty, hlavní a lokální hodnoty konfiguračních voleb, HTTP hlavičky, a PHP
licenci.
</para>
<para>
Výstup se dá upravit předáním jednou nebo více z následujících hodnot
uložených ve volitelném argumentu <parameter>what</parameter>.
<itemizedlist>
<listitem><simpara>INFO_GENERAL</simpara></listitem>
<listitem><simpara>INFO_CREDITS</simpara></listitem>
<listitem><simpara>INFO_CONFIGURATION</simpara></listitem>
<listitem><simpara>INFO_MODULES</simpara></listitem>
<listitem><simpara>INFO_ENVIRONMENT</simpara></listitem>
<listitem><simpara>INFO_VARIABLES</simpara></listitem>
<listitem><simpara>INFO_LICENSE</simpara></listitem>
<listitem><simpara>INFO_ALL</simpara></listitem>
</itemizedlist>
</para>
<para>
Viz také <function>phpversion</function>,
<function>phpcredits</function>,
<function>php_logo_guid</function>
</para>
</refsect1>
</refentry>
<refentry id="function.phpversion">
<refnamediv>
<refname>phpversion</refname>
<refpurpose>Získat současnou verzi PHP</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>phpversion</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec obsahující verzi právě běžícího PHP parseru.
<example>
<title>phpversion() example</title>
<programlisting role="php">
// prints e.g. 'Současná verze PHP: 3.0rel-dev'
echo "Současná verze PHP: ".phpversion();
</programlisting>
</example>
</para>
<para>
Viz také <function>phpinfo</function>,
<function>phpcredits</function>,
<function>php_logo_guid</function>
</para>
</refsect1>
</refentry>
<refentry id="function.php-logo-guid">
<refnamediv>
<refname>php_logo_guid</refname>
<refpurpose>Get the logo guid</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>php_logo_guid</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<note>
<para>
Tato funkcionalita byla přidána v PHP 4 Beta 4.
</para>
</note>
</para>
<para>
Viz také <function>phpinfo</function>.
<function>phpversion</function>,
<function>phpcredits</function>
</para>
</refsect1>
</refentry>
<refentry id="function.php-sapi-name">
<refnamediv>
<refname>php_sapi_name</refname>
<refpurpose>
Vrátit typ rozhraní mezi web serverem a PHP
Returns the type of interface between web server and PHP
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>php_sapi_name</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
<function>php_sapi_name</function> vrátí řetězec popisující malými písmeny
typ rozhraní mezi web serverem a PHP (Server API, SAPI). U CGI PHP je tento
řetězec "cgi", u mod_php pro Apache je tento řetězec "apache" a tak dále.
</simpara>
<para>
<example>
<title><function>Php_sapi_name</function> Example</title>
<programlisting role="php">
$sapi_type = php_sapi_name();
if ($sapi_type == "cgi")
print "Používáte CGI PHP\n";
else
print "Nepoužíváte CGI PHP\n";
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.php-uname">
<refnamediv>
<refname>php_uname</refname>
<refpurpose>
Vrátit informaci o operačním systému, na kterém bylo PHP zkompilováno
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>php_uname</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
<function>php_uname</function> vrátí řetězec s popisem operačního systému,
na kterém bylo PHP zkompilováno.
</simpara>
<para>
<example>
<title><function>php_uname</function> Example</title>
<programlisting role="php">
if (substr(php_uname(), 0, 7) == "Windows") {
die("Pardon, tento skript na Windows nefunguje.\n");
}
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.putenv">
<refnamediv>
<refname>putenv</refname>
<refpurpose>Nastavit hodnotu systémové proměnné</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>putenv</function></funcdef>
<paramdef>string <parameter>setting</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Přidá <parameter>setting</parameter> do prostředí serveru.
</para>
<para>
<example>
<title>Nastavení systémové proměnné</title>
<programlisting role="php">
putenv ("UNIQID=$uniqid");
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.set-magic-quotes-runtime">
<refnamediv>
<refname>set_magic_quotes_runtime</refname>
<refpurpose>
Nastavit současnou aktivní hodnotu magic_quotes_runtime
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>long
<function>set_magic_quotes_runtime</function>
</funcdef>
<paramdef>int <parameter>new_setting</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Nastaví současnou aktivní konfigurační volby <link
linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>.
(0 vypnuto, 1 zapnuto)
</simpara>
<simpara>
Viz také <function>get_magic_quotes_gpc</function>,
<function>get_magic_quotes_runtime</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.set-time-limit">
<refnamediv>
<refname>set_time_limit</refname>
<refpurpose>Omezit maximální dobu průběhu skriptu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>set_time_limit</function></funcdef>
<paramdef>int <parameter>seconds</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Určí počet sekund po které může skript běžet. Pokud je dosaženo tohoto
času, skript vrátí fatální chybu. Standardní limit je 30 sekund, nebo,
pokud existuje, hodnota direktivy max_execution_time definovaná v
<link linkend="configuration.file">konfiguračním souboru</link>. Pokud je
<parameter>seconds<-parameter> nula, neexistuje žádný časový limit.
</simpara>
<simpara>
<function>set_time_limit</function> při svém zavolání restartuje čítač času
od nuly. Jinými slovy, pokud je limit standardních šé sekund a po 25
sekundách provádění skriptu dojde k volání set_time_limit(20), tento skript
poběží celkem 45 sekund předtím, než skončí na časovém limitu.
</simpara>
<simpara>
Všimněte si, že <function>set_time_limit</function> nemá žádný účinek, když
PHP běží v bezpečném módu. Obejít to lz jedine vypnutím bezpečného módu nebo
změnou časového limitu v <link
linkend="configuration.file">konfiguračním souboru</link>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.zend-logo-guid">
<refnamediv>
<refname>zend_logo_guid</refname>
<refpurpose>Získat zend guid</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>zend_logo_guid</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<note>
<para>
Tato funkcionalita byla přidána v PHP 4 Beta 4.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.get-loaded-extensions">
<refnamediv>
<refname>get_loaded_extensions</refname>
<refpurpose>
Vrátit pole se jmény všech zkompilovaných a načtených modulů (extenzí)
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_loaded_extensions</function></funcdef>
<paramdef>void </paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrací jména všech modulů (extenzí) zkompilovaných a načtených
do PHP interpretru.
</para>
<para>
Například následující řádek
<informalexample>
<programlisting>
print_r (get_loaded_extensions());
</programlisting>
</informalexample>
vypíše seznam podobný tomuto:
<informalexample>
<programlisting>
Array
(
[0] => xml
[1] => wddx
[2] => standard
[3] => session
[4] => posix
[5] => pgsql
[6] => pcre
[7] => gd
[8] => ftp
[9] => db
[10] => Calendar
[11] => bcmath
)
</programlisting>
</informalexample>
</para>
<para>
Viz také: <function>get_extension_funcs</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.get-extension-funcs">
<refnamediv>
<refname>get_extension_funcs</refname>
<refpurpose>
Vrátit pole jmen funkcí určitého modulu
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_extension_funcs</function></funcdef>
<paramdef>string <parameter>module_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrací jména všech funkcí definovaných v modulu určeném
argumentem <parameter>module_name</parameter>.
</para>
<para>
Například následující řádky
<informalexample>
<programlisting>
print_r (get_extension_funcs ("xml"));
print_r (get_extension_funcs ("gd"));
</programlisting>
</informalexample>
vytisknou seznam všech funkcí v modulech
<varname>xml</varname> a <varname>gd</varname>.
</para>
<para>
Viz také: <function>get_loaded_extensions</function>
</para>
</refsect1>
</refentry>
<refentry id="function.get-required-files">
<refnamediv>
<refname>get_required_files</refname>
<refpurpose>
Vrátit pole jmen všech souborů, které byly v určitém skriptu načteny pomocí
require_once()
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_required_files</function></funcdef>
<paramdef>void </paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí asociativní pole jmen všech souborů, které byly načteny do
probíhajícího skriptu pomocí <function>require_once</function>. Indexy
tohoto pole jsou názvy souborů použitých v <function>require_once</function>
bez přípony ".php".
</para>
<para>
Následující příklad
<example>
<title>Tisk require()ovaných a include()ovaných souborů</title>
<programlisting>
<?php
require_once ("local.php");
require_once ("../inc/global.php");
for ($i=1; $i<5; $i++)
include "util".$i."php";
echo "Required_once files\n";
print_r (get_required_files());
echo "Included_once files\n";
print_r (get_included_files());
?>
</programlisting>
</example>
vygeneruje následující výstup:
<informalexample>
<programlisting>
Required_once files
Array
(
[local] => local.php
[../inc/global] => /full/path/to/inc/global.php
)
Included_once files
Array
(
[util1] => util1.php
[util2] => util2.php
[util3] => util3.php
[util4] => util4.php
)
</programlisting>
</informalexample>
</para>
<para>
<note>
<para>
Od verze PHP 4.0.1pl2 tato funkce předpokládá, že soubory v
<varname>required_once</varname> končí příponou
".php", jiné přípony nefungují.
</para>
</note>
</para>
<para>
Viz také: <function>require_once</function>,
<function>include_once</function>,
<function>get_included_files</function>
</para>
</refsect1>
</refentry>
<refentry id="function.get-included-files">
<refnamediv>
<refname>get_included_files</refname>
<refpurpose>
Vrátit pole jmen všech souborů, které byly ve skriptu načteny pomocí
include_once()
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_included_files</function></funcdef>
<paramdef>void </paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí asociativní pole jmen všech souborů, které byly načteny do
skriptu pomocí <function>include_once</function>. Indexy tohoto pole jsou
názvy souborů použitých v <function>include_once</function>
bez přípony ".php".
</para>
<para>
<note>
<para>
Od verze PHP 4.0.1pl2 tato funkce předpokládá, že soubory v
<varname>include_once</varname> končí příponou
".php", jiné přípony nefungují.
</para>
</note>
</para>
<para>
Viz také: <function>require_once</function>,
<function>include_once</function>,
<function>get_required_files</function>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/mail.xml
+++ phpdoc/cs/functions/mail.xml
<reference id="ref.mail">
<title>Mail functions</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
<simpara>
The <function>mail</function> function allows you to send mail.</simpara>
</partintro>
<refentry id="function.mail">
<refnamediv>
<refname>mail</refname>
<refpurpose>send mail</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>mail</function></funcdef>
<paramdef>string <parameter>to</parameter></paramdef>
<paramdef>string <parameter>subject</parameter></paramdef>
<paramdef>string <parameter>message</parameter></paramdef>
<paramdef>string
<parameter><optional>additional_headers</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Mail</function> automaticky odmailuje vzkaz specifikovaný v
<parameter>message</parameter> příjemci specifikovanému v
<parameter>to</parameter>. Přidáním čárky mezi adresami v
<parameter>to</parameter> můžete specifikovat více příjemců.
</simpara>
<para>
<example>
<title>Odeslání mailu.</title>
<programlisting>
mail("[EMAIL PROTECTED]", "Můj předmět", "Řádek 1\nŘádek 2\nŘádek 3");
</programlisting>
</example></para>
<simpara>
Pokud je předán čtvrtý argument, jeho hodnota se vloží na konec hlaviček.
Toto se obvykle používá k přidání extra hlaviček.
If a fourth string argument is passed, this string is inserted at
the end of the header. This is typically used to add extra
headers. Vícenásobné hlavičky se oddělují zařádkováním.</simpara>
<para>
<example>
<title>Odeslání mailu s extra hlavičkami.</title>
<programlisting>
mail("[EMAIL PROTECTED]", "předmět", $message,
"From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/"
. phpversion());
</programlisting>
</example>
K vytvoření komplexních emailů můžete také použít poměrně jednoduché techniky
pro tvorbu řetězců.
<example>
<title>Sending complex email.</title>
<programlisting>
/* recipients */
$recipient .= "Mary <[EMAIL PROTECTED]>" . ", " ; //všimněte si čárky
$recipient .= "Kelly <[EMAIL PROTECTED]> . ", ";
$recipient .= "[EMAIL PROTECTED]";
/* subject */
$subject = "Birthday Reminders for August";
/* message */
$message .= "Následující email obsahuje formátovanou ASCII tabulku\n";
$message .= "Day \t\tMonth \t\tYear\n";
$message .= "3rd \t\tAug \t\t1970\n";
$message .= "17rd\t\tAug \t\t1973\n";
/* můžete přidat signaturu */
$message .= "--\r\n"; //oddělovač signatury
$message .= "Birthday reminder copylefted by public domain";
/* dodatečné hlavičky pro chyby, From, cc, bcc, atd */
$headers .= "From: Birthday Reminder <[EMAIL PROTECTED]>\n";
$headers .= "X-Sender: <[EMAIL PROTECTED]>\n";
$headers .= "X-Mailer: PHP\n"; // mailový klient
$headers .= "X-Priority: 1\n"; // Urgentní vzkaz!
$headers .= "Return-Path: <[EMAIL PROTECTED]>\n"; // Návratová cesta pro chyby
/* Pokud chcete poslat HTML email, odkomentujte následující řádek */
// $headers .= "Content-Type: text/html; charset=iso-8859-1\n"; // Mime typ
$headers .= "cc:[EMAIL PROTECTED]\n"; // CC
$headers .= "bcc:[EMAIL PROTECTED], [EMAIL PROTECTED]\n"; // BCC
/* a teď to odešleme */
mail($recipient, $subject, $message, $headers);
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.ezmlm-hash">
<refnamediv>
<refname>ezmlm_hash</refname>
<refpurpose>Počítá hash hodnotu potřebnou pro EZMLM</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ezmlm_hash</function></funcdef>
<paramdef>string <parameter>addr</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>ezmlm_hash</function> Počítá hash hodnotu, která je potřeba
pro uchovávání EZMLM mailing listů v MySQL databázi.
</simpara>
<para>
<example>
<title>Výpočet hashe a přihlášení uživatele</title>
<programlisting>
$user = "[EMAIL PROTECTED]";
$hash = ezmlm_hash ($user);
$query = sprintf ("INSERT INTO sample VALUES (%s, '%s')", $hash, $user);
$db->query($query); // použito databázové rozhraní PHPLIB
</programlisting>
</example>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/misc.xml
+++ phpdoc/cs/functions/misc.xml
<reference id="ref.misc">
<title>Smíšené funkce</title>
<titleabbrev>Smíšené</titleabbrev>
<partintro>
<para>
Tyto funkce byly umístěny zde, protože nespadají do žádné jiné kategorie.
</para>
</partintro>
<refentry id="function.connection-aborted">
<refnamediv>
<refname>connection_aborted</refname>
<refpurpose>Vrací true, pokud se klient odpojil</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>connection_aborted</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrátí true, pokud se klient odpojil. Úplné vysvětlení viz popis v <link
linkend="features.connection-handling">Obsluha spojení</link>
v kapitole <link linkend="features">Vlastnosti</link>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.connection-status">
<refnamediv>
<refname>connection_status</refname>
<refpurpose>Vrací bitové pole stavu spojení</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>connection_status</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vrací bitové pole stavu spojení. Úplné vysvětlení viz popis v <link
linkend="features.connection-handling">Obsluha spojení</link>
v kapitole <link linkend="features">Vlastnosti</link>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.connection-timeout">
<refnamediv>
<refname>connection_timeout</refname>
<refpurpose>Return true if script timed out</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>connection_timeout</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Returns true if script timed out. Úplné vysvětlení viz popis v <link
linkend="features.connection-handling">Obsluha spojení</link>
v kapitole <link linkend="features">Vlastnosti</link>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.define">
<refnamediv>
<refname>define</refname>
<refpurpose>Definuje pojmenovanou konstantu.</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>define</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
<paramdef>mixed <parameter>value</parameter></paramdef>
<paramdef>int
<parameter><optional>case_insensitive</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Definuje pojmenovanou konstantu, která je podobná proměnné s výjimkou toho,
že:
<itemizedlist>
<listitem>
<simpara>
Konstanty nemají znak dolaru ('$') před jménem;
</simpara>
</listitem>
<listitem>
<simpara>
Konstanty jsou dostupné odkudkoliv bez ohledu na pravidla rozsahu
platnosti proměnných;
</simpara>
</listitem>
<listitem>
<simpara>
Konstanty se nedají předefinovávat a rušit; a
</simpara>
</listitem>
<listitem>
<simpara>
Konstanty se mohou nabývat pouze skalárních hodnot.
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Název konstanty je dán argumentem <parameter>name</parameter>;
hodnota je dána argumentem <parameter>value</parameter>.
</para>
<para>
Dále je dostupný volitelní třetí argument
<parameter>case_insensitive</parameter>. Pokud má hodnotu
<emphasis>1</emphasis>, konstanta bude definována
case-insensitive.
Výchozí chování je
case-sensitive; tj. CONSTANT and Constant reprezentují různé hodnoty.
</para>
<para>
<example>
<title>Definování konstant</title>
<programlisting role="php">
<?php
define ("CONSTANT", "Hello world.");
echo CONSTANT; // výstup je "Hello world."
?>
</programlisting>
</example>
</para>
<para>
<function>Define</function> vrací TRUE při úspěchu a FALSE pokud dojde
k chybě.
</para>
<para>
Viz také <function>defined</function> a sekci <link
linkend="language.constants">Konstanty</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.defined">
<refnamediv>
<refname>defined</refname>
<refpurpose>
Zkontroluje, jestli existuje daná pojmenovaná konstanta
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>defined</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrací true, pokud byla definována pojmenovaná konstanta daná argumentem
<parameter>name</parameter>, jinak false.
<example>
<title>Kontrola konstant</title>
<programlisting role="php">
<?php
if (defined("CONSTANT")){ // název konstanty by měl být v uvozovkách
echo CONSTANT; //
}
?>
</programlisting>
</example>
</para>
<para>
Viz také <function>define</function> a sekci <link
linkend="language.constants">Konstanty</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.die">
<refnamediv>
<refname>die</refname>
<refpurpose>
Vytiskne vzkaz a ukončí současný skript
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>die</function></funcdef>
<paramdef>string <parameter>message</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Tento jazykový konstrukt vytiskne vzkaz a ukončí parsování skriptu.
Nemá návratovou hodnotu.
</simpara>
<para>
<example>
<title>die example</title>
<programlisting role="php">
<?php
$filename = '/path/to/data-file';
$file = fopen ($filename, 'r')
or die("nepodařilo se otevřít soubor ($filename)");
?>
</programlisting>
</example>
</para>
<simpara>
Viz také <function>exit</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.eval">
<refnamediv>
<refname>eval</refname>
<refpurpose>Vyhodnotí řetězec jako PHP kód</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>eval</function></funcdef>
<paramdef>string <parameter>code_str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>eval</function> vyhodnotí řetězec předaný v
<parameter>code_str</parameter> jako PHP kód. Kromě jiného se dá využít
na ukládání kódu v textovém sloupci databáze pro pozdější vykonání.
</simpara>
<simpara>
Při používání <function>eval</function> byste měli mít na paměti několik
faktorů. Pamatujte si, že předávaný řetězec musí být platný PHP kód,
včetně věcí jako ukončování výrazů středníkem, aby parser nezemřel na
řádku po <function>eval</function>, a řádné escapování v
<parameter>code_str</parameter>.
</simpara>
<simpara>
Také pamatujte, ze hodnoty přiřazené proměnným v <function>eval</function>
těmto proměnným zůstanou i v hlavním skriptu.
</simpara>
<simpara>
Výraz <literal>return</literal> okamžitě ukončí vyhodnocování předaného
řetězce. V PHP 4 můžete použít <literal>return</literal> k vrácení hodnoty,
která se stane výsledkem <function>eval</function> funkce, zatímco v PHP 3
byl <function>eval</function> typu <literal>void</literal> nic nevracel.
</simpara>
<para>
<example>
<title>
<function>Eval</function> příklad - jednoduché spojení textů
</title>
<programlisting role="php">
<?php
$string = 'cup';
$name = 'coffee';
$str = 'This is a $string with my $name in it.<br>';
echo $str;
eval ("\$str = \"$str\";");
echo $str;
?>
</programlisting>
</example>
</para>
<para>
Výše uvedený příklad ukáže:
<programlisting>
This is a $string with my $name in it.
This is a cup with my coffee in it.
</programlisting>
</para>
</refsect1>
</refentry>
<refentry id="function.exit">
<refnamediv>
<refname>exit</refname>
<refpurpose>Ukončí současný skript</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>exit</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<simpara>
Tento jazykový konstrkut ukončí parsování skriptu. Nevrací žádnou hodnotu.
</simpara>
<simpara>
Viz také <function>die</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.get-browser">
<refnamediv>
<refname>get_browser</refname>
<refpurpose>
Určuje schopnosti uživatelova browseru
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>object <function>get_browser</function></funcdef>
<paramdef>string
<parameter><optional>user_agent</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>get_browser</function> se pokusí určit schopnosti uživatelova
browseru. Toho je dosaženo vyhledáním informací o browseru v souboru
<filename>browscap.ini</filename>. Standardne se použije
$HTTP_USER_AGENT; nicméně, můžete to změnit (tj. vyhledat informace o
jiném browseru) předáním volitelného argumentu
<parameter>user_agent</parameter>.
</simpara>
<simpara>
Informace se vracejí jako objekt, který obsahuje různé datové elementy,
které reprezentují například hlavní a vedlejší číslo verze a ID řetězec;
true/false hodnoty vlastností jako podpora rámců, JavaScript a cookies,
atd.
</simpara>
<simpara>
Jakkoli <filename>browscap.ini</filename> obsahuje informace o mnoha
browserech, aktuálnost databáze závisí na uživatelských updatech. Formát
souboru je poměrně snadno pochopitelný.
</simpara>
<para>
Následující příklad ukazuje, jak by se daly vypsat všechny informace
získané o uživatelově browseru.
<example>
<title><function>Get_browser</function> příklad</title>
<programlisting role="php">
<?php
function list_array ($array) {
while (list ($key, $value) = each ($array)) {
$str .= "<b>$key:</b> $value<br>\n";
}
return $str;
}
echo "$HTTP_USER_AGENT<hr>\n";
$browser = get_browser();
echo list_array ((array) $browser);
?>
</programlisting>
</example>
</para>
<simpara>
Výstup z výše uvedeného skriptu by vypadal asi takto:
</simpara>
<programlisting>
Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr>
<b>browser_name_pattern:</b> Mozilla/4\.5.*<br>
<b>parent:</b> Netscape 4.0<br>
<b>platform:</b> Unknown<br>
<b>majorver:</b> 4<br>
<b>minorver:</b> 5<br>
<b>browser:</b> Netscape<br>
<b>version:</b> 4<br>
<b>frames:</b> 1<br>
<b>tables:</b> 1<br>
<b>cookies:</b> 1<br>
<b>backgroundsounds:</b> <br>
<b>vbscript:</b> <br>
<b>javascript:</b> 1<br>
<b>javaapplets:</b> 1<br>
<b>activexcontrols:</b> <br>
<b>beta:</b> <br>
<b>crawler:</b> <br>
<b>authenticodeupdate:</b> <br>
<b>msn:</b> <br>
</programlisting>
<simpara>
Aby to fungovalo, <link linkend="ini.sect.browscap">browscap</link>
direktiva ve vašem konfiguračním souboru musí ukazovat na platné umístění
<filename>browscap.ini</filename> souboru.
</simpara>
<simpara>
Pro další informace (včetně lokací na kterých můžete získat
<filename>browscap.ini</filename> soubor) viz PHP FAQ na <ulink
url="&url.php.faq;">&url.php.faq;</ulink>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.highlight-file">
<refnamediv>
<refname>highlight_file</refname>
<refpurpose>Zvýrazní syntaxi souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>highlight_file</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce <function>highlight_file</function> vytiskne barevně zvýrazněnou
syntaxi kódu obsaženého ve <parameter>filename</parameter> s použitím
barev definovaných ve zvýrazňovači syntaxe zabudovaném v PHP.
Vrací true při úspěchu, jinak false (PHP 4).
</simpara>
<para>
<example>
<title>Tvorba URL zvyrazňující syntaxi</title>
<simpara>
K vytvoření URL, která zvýrazní syntaxi jakéhokoliv skriptu, který jí
předáte využijeme "ForceType" direktivu Apache k vytvoření
hezkého vzorce URL, and pomocí funkce <function>highlight_file</function>
vypíšeme hezky vypadající výpis kódu.
</simpara>
<simpara>
Do svého httpd.conf přidejte následující:
</simpara>
<para>
<informalexample><programlisting>
<Location /source>
ForceType application/x-httpd-php
</Location>
</programlisting></informalexample>
</para>
<simpara>
A potom vytvořte soubor pojmenovaný "source", a umístěte ho
do svého web root adresáře.
</simpara>
<para>
<programlisting role="php">
<HTML>
<HEAD>
<TITLE>Zobrazení zdroje</TITLE>
</HEAD>
<BODY BGCOLOR="white">
<?php
$script = getenv ("PATH_TRANSLATED");
if(!$script) {
echo "<BR><B>CHYBA: Je potřeba název
skriptu!</B><BR>";
} else {
if (ereg("(\.php|\.inc)$",$script)) {
echo "<H1>Zdroj souboru: $PATH_INFO</H1>\n<HR>\n";
highlight_file($script);
} else {
echo "<H1>CHYBA: Povoleny jsou pouze soubory s příponou .php nebo
.inc!</H1>";
}
}
echo "<HR>Zpracováno: ".date("Y/M/d H:i:s",time());
?>
</BODY>
</HTML>
</programlisting>
</para>
<simpara>
Potom můžete použít URL jako je ta níže k zobrazení obarvené verze skriptu
umístěné v "/path/to/script.php" na vašem webu.
</simpara>
<para>
<informalexample>
<programlisting>
http://your.server.com/source/path/to/script.php
</programlisting>
</informalexample>
</para>
</example>
</para>
<simpara>
Viz také <function>highlight_string</function>,
<function>show_source</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.highlight-string">
<refnamediv>
<refname>highlight_string</refname>
<refpurpose>Zvýraznění syntaxe řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>highlight_string</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce <function>highlight_string</function> vytiskne barevně zvýrazněnou
verzi <parameter>str</parameter> s použitím barev definovaných ve
zvýrazňovači syntaxe zabudovaném v PHP.
Vrací true při úspěchu, jinak false (PHP 4).
</simpara>
<simpara>
Viz také <function>highlight_file</function>,
<function>show_source</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.ignore-user-abort">
<refnamediv>
<refname>ignore_user_abort</refname>
<refpurpose>
Nastavuje, jestli má ukončení spojení klientem přerušit vykonávání skriptu
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ignore_user_abort</function></funcdef>
<paramdef>int
<parameter><optional>setting</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Tato funkce nastavuje, jestli má odpojení klienta způsobit ukončení skriptu.
Vrací předchozí nastavení, a při zavolání bez argumentu současné
nastavení nemění, pouze ho vrací. Úplné vysvětlení viz popis v sekci <link
linkend="features.connection-handling">Obsluha spojení</link>
v kapitole <link linkend="features">Vlastnosti</link>
</simpara>
</refsect1>
</refentry>
<refentry id="function.iptcparse">
<refnamediv>
<refname>iptcparse</refname>
<refpurpose>
Parsuje binární IPTC <ulink url="&url.iptc;">&url.iptc;</ulink>
blok do jednotlivých tagů.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>iptcparse</function></funcdef>
<paramdef>string <parameter>iptcblock</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Tato funkce parsuje binární IPTC blok do jeho jednotlivých tagů. Vrací
pole, které používá tagmarker jako index, a jeho hodnotu jako hodnotu.
Vrací false při chybě, nebo pokud nenajde žádná IPTC data. Příklad viz
<function>GetImageSize</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.leak">
<refnamediv>
<refname>leak</refname>
<refpurpose>Nenávratně alokuje pamět</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>leak</function></funcdef>
<paramdef>int <parameter>bytes</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Leak</function> nenávratně alokuje specifikované množství paměti.
</simpara>
<simpara>
Tato funkce je užitečná při ladění správce paměti, který automaticky
čistí "vyteklou" (leaked) pamět při dokončení každého požadavku.
</simpara>
</refsect1>
</refentry>
<refentry id="function.pack">
<refnamediv>
<refname>pack</refname>
<refpurpose>Sbalí data do binárního řetězce.</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pack</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>mixed
<parameter><optional>args</optional></parameter> ...
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Sbalí předané argumenty do binárního řetězce podle argumentu
<parameter>format</parameter>. Vrací binární řetězec obsahující předaná data.
</para>
<para>
Nápad na tuto funkci byl převzat z Perlu, a všechny formátovací kódy
fungují stejně jako tam, nicméně, některé formátovací kódy chybí, jako
například Perlovský formátovací kód "u".
Formátovací řetězec sestává z formátovacích kódu následovaných volitelným
opakovacím argumentem. Opakovací argument může být buď celočíselná hodnota,
nebo * pro opakování do konce vstupních dat. U a, A, h, H počet opakování
určuje, kolik znaků se vezme z jednoho datového argumentu, u @ je to
absolutní pozice, kde se mají umístit další data, u všeho ostatního počet
opakování určuje, kolik datových argumentů se spotřebuje a sbalí do
výsledného binárního řetězce. V současnosti jsou implementovány
<itemizedlist>
<listitem>
<simpara>
a řetězec doplněný NUL hodnotami
</simpara>
</listitem>
<listitem>
<simpara>
A řetězec doplněný SPACE hodnotami
</simpara>
</listitem>
<listitem>
<simpara>
h Hex řetězec, spodní slabika první
</simpara>
</listitem>
<listitem>
<simpara>
H Hex řetězec, horní slabika první
</simpara>
</listitem>
<listitem>
<simpara>
c signed char
</simpara>
</listitem>
<listitem>
<simpara>
C unsigned char
</simpara>
</listitem>
<listitem>
<simpara>
s signed short (vždy 16 bitů, machine byte order)
</simpara>
</listitem>
<listitem>
<simpara>
S unsigned short (vždy 16 bitů, machine byte order)
</simpara>
</listitem>
<listitem>
<simpara>
n unsigned short (vždy 16 bitů, big endian byte order)
</simpara>
</listitem>
<listitem>
<simpara>
v unsigned short (vždy 16 bitů, little endian byte order)
</simpara>
</listitem>
<listitem>
<simpara>
i signed integer (velikost a pořadí bytů závislá na systému)
</simpara>
</listitem>
<listitem>
<simpara>
I unsigned integer (velikost a pořadí bytů závislá na systému)
</simpara>
</listitem>
<listitem>
<simpara>
l signed long (vždy 32 bitů, machine byte order)
</simpara>
</listitem>
<listitem>
<simpara>
L unsigned long (vždy 32 bitů, machine byte order)
</simpara>
</listitem>
<listitem>
<simpara>
N unsigned long (vždy 32 bitů, big endian byte order)
</simpara>
</listitem>
<listitem>
<simpara>
V unsigned long (vždy 32 bitů, little endian byte order)
</simpara>
</listitem>
<listitem>
<simpara>
f float (velikost a reprezentace závislá na systému)
</simpara>
</listitem>
<listitem>
<simpara>
d double (velikost a reprezentace závislá na systému)
</simpara>
</listitem>
<listitem>
<simpara>
x NUL byte
</simpara>
</listitem>
<listitem>
<simpara>
X Back up one byte
</simpara>
</listitem>
<listitem>
<simpara>
@ NUL-fill to absolute position
</simpara>
</listitem>
</itemizedlist>
<example>
<title><function>Pack</function> formátovací řetězec</title>
<programlisting role="php">
$binarydata = pack ("nvc*", 0x1234, 0x5678, 65, 66);
</programlisting>
<para>
Výsledný binární řetězec bude 6 bytů dlouhý, a bude obsahovat bytovou
sekvenci 0x12, 0x34, 0x78, 0x56, 0x41, 0x42.
</para>
</example>
</para>
<para>
Všimněte si, že rozdíl mezi hodnotami se znaménkem a bez znaménka ovlivňuje
pouze funkci <function>unpack</function>, zatímco funkce
<function>pack</function> dává stejný výsledek pro formátovací kódy se
znaménkem i bez znaménka.
</para>
<para>
Dále si všimněte, že PHP interně ukládá celočíselné hodnoty jako hodnoty
se znaménkem o velikosti závislé na systému. Pokud zadáte hodnotu bez
znaménka, která bude příliš velká, než aby se dala takto uložit, převede
se na double, což často vytváří nežádoucí výsledky.
</para>
</refsect1>
</refentry>
<refentry id="function.show-source">
<refnamediv>
<refname>show_source</refname>
<refpurpose>Zvýrazní syntaxi souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>show_source</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce <function>show_source</function> vytiskne barevně zvýrazněnou
syntaxi kódu obsaženého ve <parameter>filename</parameter> s použitím
barev definovaných ve zvýrazňovači syntaxe zabudovaném v PHP.
Vrací true při úspěchu, jinak false (PHP 4).
</simpara>
<note>
<simpara>
Tato funkce je alias funkce <function>highlight_file</function>
</simpara>
</note>
<simpara>
Viz také <function>highlight_string</function>,
<function>highlight_file</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.sleep">
<refnamediv>
<refname>sleep</refname>
<refpurpose>Odloží provedení</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>sleep</function></funcdef>
<paramdef>int <parameter>seconds</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce sleep odkládá provedení programu o počet sekund předaný v argumentu
<parameter>seconds</parameter>.
</simpara>
<simpara>
Viz také <function>usleep</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.uniqid">
<refnamediv>
<refname>uniqid</refname>
<refpurpose>Generatuje unikátní id</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>uniqid</function></funcdef>
<paramdef>string <parameter>prefix</parameter></paramdef>
<paramdef>boolean
<parameter><optional>lcg</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
<function>Uniqid</function> vrací unikátní identifikátor založený na
současném čase v mikrosekundách, opatřený prefixem. Prefix může být
užitečný například pokud generujete identifikátory na několika serverech
současně, které by mohly vygenerovat identifikátor ve stejnou mikrosekundu.
<parameter>Prefix</parameter> může být až 114 znaků dlouhý.
</simpara>
<simpara>
Pokud je volitelný argument <parameter>lcg</parameter> true,
<function>uniqid</function> přidá dodatečnou "kombinovanou LCG" entropii
na konec své návratové hodnoty, což by mělo učinit výsledky ještě
unikátnějšími.
</simpara>
<simpara>
Pokud je <parameter>prefix</parameter> prázdný, vrácený řetěec bude 13
znaků dlouhý. Pokud je <parameter>lcg</parameter> true, bude dlouhý 23
znaků.
</simpara>
<note>
<simpara>
<parameter>lcg</parameter> argument je přístupný pouze v PHP 4 and
PHP 3.0.13 a vyšších.
</simpara>
</note>
<para>
Pokud potřebujete unikátní identifikátor nebo symbol, a zamýšlíte předat
tento symbol uživateli po síti (např. session cookies), doporučujeme
použít něco jako
<informalexample>
<programlisting role="php">
$token = md5 (uniqid ("")); // no random portion
$better_token = md5 (uniqid (rand())); // better, difficult to guess
</programlisting>
</informalexample>
</para>
<simpara>
Toto vytvoří 32znakový identifikátor (128bitové hexa číslo), které se
extrémně težko předpovídá.
</simpara>
</refsect1>
</refentry>
<refentry id="function.unpack">
<refnamediv>
<refname>unpack</refname>
<refpurpose>Rozbalí data z binárního řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>unpack</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>string <parameter>data</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Unpack</function> rozbalí data z binárního řetězce do pole podle
<parameter>format</parameter>. Vrací pole obsahující rozbalené prvky
binárního řetězce.
</para>
<para>
<function>Unpack</function> funguje trochu jinak než v Perlu, jelikož
rozbalená data jsou uložena v asociativním poli. Toho dosáhnete tak, že
vyjmenujete různé formátovací kódy a oddělíte je lomítkem /.
<example>
<title><function>Unpack</function> format string</title>
<programlisting role="php">
$array = unpack ("c2chars/nint", $binarydata);
</programlisting>
<para>
Výsledné pole obsahuej položky "chars1", "chars2" and "int".
</para>
</example>
</para>
<para>
Vysvětlení formátovacích kódů viz také: <function>pack</function>
</para>
<para>
Všimněte si, že PHP interně ukládá celočíselné hodnoty se znaménkem. Pokud
rozbalíte velkou celočíselnou hodnotu bez znaménka a ta má stejnou velikost
jako hodnoty interně ukládané PHP, výsledkem bude negativní číslo, i když
bylo zadáno rozbalování bez znaménka.
</para>
</refsect1>
</refentry>
<refentry id="function.usleep">
<refnamediv>
<refname>usleep</refname>
<refpurpose>Odloží provedení v mikrosekundách</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>usleep</function></funcdef>
<paramdef>int <parameter>micro_seconds</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce <function>usleep</function> odloží provedení skriptu o daný počet
<parameter>micro_seconds</parameter>.
</simpara>
<simpara>
Viz také <function>sleep</function>.
</simpara>
<note>
<simpara>
Tato funkce nefunguje na Windows systémech.
</simpara>
</note>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/readline.xml
+++ phpdoc/cs/functions/readline.xml
<reference id="ref.readline">
<title>GNU Readline</title>
<titleabbrev>Readline</titleabbrev>
<partintro>
<simpara>
<function>readline</function> funkce implementují rozhraní ke GNU
Readline knihovně. Tyto funkce poskytují editovatelné příkazové řádky.
Příkladem může být způsob, jakým vám Bash umožňuje vkládat znaky nebo
listovat historií příkazů pomocí kláves pro pohyb kurzoru. Z interaktivní
povahy této knihovny vyplývá, že není příliš užitečná pro psaní webových
aplikací, ale může být užitečná při psaní skriptů, které se mají spouštět
z příkazové řádky.
</simpara>
<simpara>
Domovskou stránkou GNU Readline projektu je
<ulink url="&url.readline;">&url.readline;</ulink>. Udržuje jej Chet Ramey,
který je také autorem Bashe.
</simpara>
</partintro>
<refentry id="function.readline">
<refnamediv>
<refname>readline</refname>
<refpurpose>Přečíst řádek</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>readline</function></funcdef>
<paramdef>string
<parameter><optional>prompt</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí jeden řádek od uživatele. Můžete specifikovat řetězec,
který se má uživateli zobrazit jako výzva. Z vráceného řádku je odstraněna
sekvence konce řádku. Do historie tento řádek musíte přidat sami pomocí
<function>readline_add_history</function>.
</para>
<example>
<title><function>Readline</function></title>
<programlisting role="php">
//ziska 3 prikazy uzivatele
for ($i=0; $i < 3; $i++) {
$line = readline ("Command: ");
readline_add_history ($line);
}
//vypise historii
print_r (readline_list_history());
//vypise promenne
print_r (readline_info());
</programlisting>
</example>
</refsect1>
</refentry>
<refentry id="function.readline-add-history">
<refnamediv>
<refname>readline_add_history</refname>
<refpurpose>Přidat řádek do historie</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>readline_add_history</function></funcdef>
<paramdef>string <parameter>line</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Tato funkce přidá řádek do historie příkazové řádky.</para>
</refsect1>
</refentry>
<refentry id="function.readline-clear-history">
<refnamediv>
<refname>readline_clear_history</refname>
<refpurpose>Smazat historii</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>readline_clear_history</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Tato funkce smaže celou historii příkazové řádky.</para>
</refsect1>
</refentry>
<refentry id="function.readline-completion-function">
<refnamediv>
<refname>readline_completion_function</refname>
<refpurpose>Zaregistrovat dokončující funkci</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean
<function>readline_completion_function</function>
</funcdef>
<paramdef>string <parameter>line</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce zaregistruje dokončující funkci. Musíte zadat název existující
funkce, která přijímá částečný příkaz a vrací pole možných protějšků.
Toto je stejná funkcionalita jakou dostanete, pokud v Bashi zmáčknete klávesu
tab.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-info">
<refnamediv>
<refname>readline_info</refname>
<refpurpose>Zjistit/nastavit různé interní proměnné readline</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>readline_info</function></funcdef>
<paramdef>string
<parameter><optional>varname</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>newvalue</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Při volání bez argumentů tato funkce vrátí pole hodnot pro všechna nastavení,
která readline používá. Prvky jsou indexovány podle následujících hodnot:
done, end, erase_empty_line, library_version, line_buffer, mark,
pending_input, point, prompt, readline_name a terminal_name.
</para>
<para>
Při volání s jedním argumentem vrátí hodnotu tohoto nastavení. Při volání se
dvěma argumenty se nastavení zmení na danou hodnotu.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-list-history">
<refnamediv>
<refname>readline_list_history</refname>
<refpurpose>Vypsat historii</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>readline_list_history</function></funcdef>
<paramdef>void <parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí pole celé historie příkazové řádky. Prvky jsou indexovány
integery, počínaje nulou.
</para>
</refsect1>
</refentry>
<refentry id="function.readline-read-history">
<refnamediv>
<refname>readline_read_history</refname>
<refpurpose>Vrátit historii</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean
<function>readline_read_history</function>
</funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Tato funkce přečte historii příkazové řádky ze souboru.</para>
</refsect1>
</refentry>
<refentry id="function.readline-write-history">
<refnamediv>
<refname>readline_write_history</refname>
<refpurpose>Zapsat historii</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean
<function>readline_write_history</function>
</funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>Tato funkce zapíše historii příkazové řádky do souboru.</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/recode.xml
+++ phpdoc/cs/functions/recode.xml
<reference id="ref.recode">
<title>GNU Recode funkce</title>
<titleabbrev>Recode</titleabbrev>
<partintro>
<para>
Tento modul obsahuje rozhraní ke GNU Recode knihovně,
verze 3.5. Pokud cchete používat funkce definované v tomto modulu, musíte
zkompilovat váš PHP interpretr s --with-recode. K tomu potřebujete mít na
svém systému nainstalovanou GNU Recode 3.5 nebo vyšší.
</para>
<para>
GNU Recode knihovna konvertuje soubory mezi různými znakovými sadami a
kódováními. Když nelze dosáhnout přesné konverze, může se uchýlit
k approximacím. Tato knihovna rozeznává nebo produkuje téměř 150 různých
znakových sad, a je schopná konvertovat soubory mezi téměř libovolným párem.
Podporuje většinu znakových sad z RFC 1345.
</para>
</partintro>
<refentry id="function.recode-string">
<refnamediv>
<refname>recode_string</refname>
<refpurpose>Překóduje řetězec podle požadavku</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>recode_string</function></funcdef>
<paramdef>string <parameter>request</parameter></paramdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Překóduje řetězec <parameter>string</parameter> podle požadavku
<parameter>request</parameter>. Vrací překódovaný řetězec nebo
FALSE, pokud nebylo možné provést požadavek na překódování.
</para>
<para>
Jednoduchý požadavek na překódování může být "lat1..iso646-de".
Detailní instrukce k požadavkům viz GNU Recode dokumentaci u vaší instalace.
<example>
<title>Základní <function>recode_string</function> příklad:</title>
<programlisting role="php">
print recode_string ("us..flat", "Následující znak má diakritické
znaménko: &aacute;");
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.recode">
<refnamediv>
<refname>recode</refname>
<refpurpose>Překóduje řetězec podle požadavku</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>recode_string</function></funcdef>
<paramdef>string <parameter>request</parameter></paramdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<note>
<simpara>
Toto je alias k <function>recode_string</function>. Byl přidán v PHP 4.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.recode-file">
<refnamediv>
<refname>recode_file</refname>
<refpurpose>
Překóduje soubor na soubor podle požadavku
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>boolean <function>recode_file</function></funcdef>
<paramdef>string <parameter>request</parameter></paramdef>
<paramdef>resource <parameter>input</parameter></paramdef>
<paramdef>resource <parameter>output</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Překóduje soubor odkazovaný deskriptorem <parameter>input</parameter>
do souboru odkazovaném deskriptorem <parameter>output</parameter> podle
požadavku <parameter>request</parameter>. Pokud se nepodařilo požadavek
provést, vrací FALSE, jinak TRUE.
</para>
<para>
Tato funkce v současnosti nezpracovává deskriptory odkazující na vzdálené
soubory (URL). Oba deskriptory musí ukazovat na místní soubory.
</para>
<para>
<example>
<title>Základní příklad <function>recode_file</function></title>
<programlisting role="php">
$input = fopen ('input.txt', 'r');
$output = fopen ('output.txt', 'w');
recode_file ("us..flat", $input, $output);
</programlisting>
</example>
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/strings.xml
+++ phpdoc/cs/functions/strings.xml
<reference id="ref.strings">
<title>Funkce pro práci s řetězci</title>
<titleabbrev>Řetězce</titleabbrev>
<partintro>
<simpara>
Všechny tyto funkce různými způsoby pracují s řetězci. Některé
specializovanější funkce najdete v sekcích regulárních výrazů a manipulace s
URL.
</simpara>
<para>
Informace o chování řetězců, zvláště v souvislosti s použitím jednoduchých
uvozovek, dvojitých uvozovek a escape sekvencí viz položku
<link linkend="language.types.string">Řetězce</link> v sekci
<link linkend="language.types">Typy</link> tohoto manuálu.
</para>
</partintro>
<refentry id="function.addcslashes">
<refnamediv>
<refname>AddCSlashes</refname>
<refpurpose>Opatřit řetězec lomítky ve stylu jazyka C</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>addcslashes</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string <parameter>charlist</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec se zpětnými lomítky před znaky, které jsou vypsány v argumentu
<parameter>charlist</parameter>. XXX Excapes
<literal>\n</literal>, <literal>\r</literal> atd. podobně jako v C,
znaky s ASCII kódem nižším než 32 a vyšším než 126 se převedou na
osmičkovou reprezentaci. V <parameter>charlist</parameter> můžete udat
rozsah, např. "\0..\37", což by XXX escapovao všechny znaky s ASCII kódem
mezi 0 a 31.
<example>
<title>Ukázka <function>Addcslashes</function></title>
<programlisting role="php">
$escaped = addcslashes ($not_escaped, "\0..\37!@\177..\377");
</programlisting>
</example>
<note>
<simpara>
Přidáno v PHP4b3-dev.</simpara>
</note>
</para>
<para>
Viz také <function>stripcslashes</function>,
<function>stripslashes</function>,
<function>htmlspecialchars</function>,
<function>htmlspecialchars</function> a
<function>quotemeta</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.addslashes">
<refnamediv>
<refname>AddSlashes</refname>
<refpurpose>Opatřit řetězec lomítky</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>addslashes</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec se zpětnými lomítky před znaky, které potřebují XXX be quoted
v databázových dotazech apod. Tyto znaky jsou jednoduchá uvozovka
(<literal>'</literal>), dvojitá uvozovka (<literal>"</literal>), zpětné
lomítko (<literal>\</literal>) a NUL (null byte).
</para>
<para>
Viz také <function>stripslashes</function>,
<function>htmlspecialchars</function> a
<function>quotemeta</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.bin2hex">
<refnamediv>
<refname>bin2hex</refname>
<refpurpose>Převést binární data na hexadecimální reprezentaci</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>bin2hex</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí ASCII řetěec obsahující hexadecimální reprezentaci
<parameter>str</parameter>. Konverze probíhá po bytech, horní slabika
první.
</para>
</refsect1>
</refentry>
<refentry id="function.chop">
<refnamediv>
<refname>Chop</refname>
<refpurpose>Odstranit netisknutelné znaky z konce řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>chop</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí předaný řetězec bez netisknutelných znaků (vč. konců řádku) na konci.
<example>
<title>Ukázka <function>Chop</function></title>
<programlisting role="php">
$trimmed = chop ($line);
</programlisting>
</example>
</para>
<note>
<para>
<function>chop</function> se liší do Perlovské funkce
<parameter>chop()</parameter>, která z řetězce odstraňuje poslední znak.
</para>
</note>
<para>
Viz také <function>trim</function>,
<function>ltrim</function>,
<function>rtrim</function>, a
<function>chop</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.chr">
<refnamediv>
<refname>Chr</refname>
<refpurpose>Vrátit určitý znak</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>chr</function></funcdef>
<paramdef>int <parameter>ascii</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec jednoho znaku obsahující znak specifikovaný argumentem
<parameter>ascii</parameter>.
<example>
<title>Ukázka <function>Chr</function></title>
<programlisting role="php">
$str .= chr (27); /* přidá escape znak na konec $str */
/* Toto je většinou užitečnější */
$str = sprintf ("Řetězec konči escape znakem: %c", 27);
</programlisting>
</example>
Tato funkce se doplňuje s funkcí <function>ord</function>. Viz také
<function>sprintf</function> s formátovacím řetězcem
<literal>%c</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.chunk-split">
<refnamediv>
<refname>chunk_split</refname>
<refpurpose>Rozdělit řetězec na menší části</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>chunk_split</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int
<parameter><optional>chunklen</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>end</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Dá se použít k rozdělení řetězce na menší části, což může být užitečné např.
při uvádění výstupu z
<link linkend="function.base64-encode">base64_encode</link> do souladu se
sémantikou RFC 2045. Každých <parameter>chunklen</parameter> (defaultně 76)
znaků vloží řetězec <parameter>end</parameter> (defaultně "\r\n"). Vrátí
nový řetězec, původní zůstává beze změny.
<example>
<title>Ukázka <function>Chunk_split</function></title>
<programlisting role="php">
# naformátuje $data s použitím RFC 2045 sémantiky
$new_string = chunk_split (base64_encode($data));
</programlisting>
</example>
Tato funkce je výrazně rychlejší než <function>ereg_replace</function>.
<note>
<para>
Tato funkce byla přidána v 3.0.6.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.convert-cyr-string">
<refnamediv>
<refname>convert_cyr_string</refname>
<refpurpose>
Převést z jedné znakové sady Azbuky do jiné
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>convert_cyr_string</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string <parameter>from</parameter></paramdef>
<paramdef>string <parameter>to</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce převede daný řetězec z jedné znakové sady azbuky do jiné.
Argumenty <parameter>from</parameter> a <parameter>to</parameter> jsou
jednotlivé znaky, které představují zdrojovou a cílovou znakovou sadu
Azbuky. Podporované typy jsou:
<itemizedlist>
<listitem>
<simpara>
k - koi8-r
</simpara>
</listitem>
<listitem>
<simpara>
w - windows-1251
</simpara>
</listitem>
<listitem>
<simpara>
i - iso8859-5
</simpara>
</listitem>
<listitem>
<simpara>
a - x-cp866
</simpara>
</listitem>
<listitem>
<simpara>
d - x-cp866
</simpara>
</listitem>
<listitem>
<simpara>
m - x-mac-cyrillic
</simpara>
</listitem>
</itemizedlist>
</para>
</refsect1>
</refentry>
<refentry id="function.count-chars">
<refnamediv>
<refname>count_chars</refname>
<refpurpose>Vrátit informace o znacích použitých v řetězci</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>count_chars</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>
<parameter>
<optional>mode</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Spočítá počet výskytů všech byte hodnot (0..255) v
<parameter>string</parameter> a vrátí je různými způsoby.
Voltelný argument <parameter>Mode</parameter> má výchozí hodnotu 0.
V závislosti na <parameter>mode</parameter> vrátí
<function>count_chars</function> jednu z následujících možností:
<itemizedlist>
<listitem>
<simpara>
0 - pole s klíči tvořenými byte hodnotami a hodnotami tvořenými četností
každého bytu.
</simpara>
</listitem>
<listitem>
<simpara>
1 - stejné jako 0, ale vrátí pouze byte hodnoty s četností vyšší než
nula.
</simpara>
</listitem>
<listitem>
<simpara>
2 - stejné jako 0, ale vrátí pouze byte hodnoty s četností rovnou nule.
</simpara>
</listitem>
<listitem>
<simpara>
3 - vrátí řetězec obsahující všechny použité byte hodnoty.
</simpara>
</listitem>
<listitem>
<simpara>
4 - vrátí řetězec obsahující všechny nepoužité byte hodnoty.
</simpara>
</listitem>
</itemizedlist>
</para>
<note>
<para>
Tato funkce byla přidána v PHP 4.0.
</para>
</note>
</refsect1>
</refentry>
<refentry id="function.crc32">
<refnamediv>
<refname>crc32</refname>
<refpurpose>Spočítat crc32 XXX polynomial řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>crc32</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Generuje 32bitový XXX polynomial kontrolního součtu pro
<parameter>str</parameter>. Obvykle se používá ke kontrole integrity
přenášených dat.
</para>
<para>
Viz také: <function>md5</function>
</para>
</refsect1>
</refentry>
<refentry id="function.crypt">
<refnamediv>
<refname>crypt</refname>
<refpurpose>Zašifrovat řetězec algoritmem DES</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>crypt</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string
<parameter><optional>salt</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>crypt</function> zašifruje řetězec pomocí standardní Unixovské
šifrovací metody <abbrev>DES</abbrev>. Argumenty jsou řetězec k zašifrování
a volitelný dvouznakový XXX salt, na kterém se šifrování založí.
Více informací viz Unixovská man stránka vaší crypt funkce.
</para>
<simpara>
Pokud není poskytnut XXX salt argument, PHP jej náhodně vygeneruje.
</simpara>
<simpara>
Některé operační systémy podporují více typů šifrování. Někdy se standardní
DES šifrování nahrazuje šifrovacím algoritmem založeným na MD5. Typ
šifrování se zvolí podle XXX salt argumentu. Při instalaci PHP zjistí
schopnosti funkce crypt a ??? bude přijímat XXX salt pro jiné typy
šifrování. Při absenci XXX salt PHP defaultně automaticky vygeneruje
standardní dvouznakový DES XXX salt, nicméně pokud je výchozím typem
šifrování na daném systému MD5, vygeneruje náhodný XXX salt kompatibilní s
MD5. PHP vytváří konstantu CRYPT_SALT_LENGTH, která vám řekne, jestli se na
váš systém hodí běžný dvouznakový XXX salt nebo delší dvanáctiznakový MD5
XXX salt.
</simpara>
<simpara>
Pokud používáte poskytnutý XXX salt, měli byste si být vědomi toho, že se
generuje jednou. Pokud tuto funkci voláte rekurzivně, může to mít účinek na
XXX appearance, a, do určité míry, bezpečnost.
</simpara>
<simpara>
U standardního DES šifrování <function>crypt</function> přidá XXX salt jako
první dva znaky výstupu.
</simpara>
<simpara>
Na systémech, kde funkce <function>crypt()</function> podporuje více typů
šifrování se následující konstanty nastaví na 0 nebo 1 podle toho, jestli
je daný typ dostupný:
</simpara>
<itemizedlist>
<listitem>
<simpara>
CRYPT_STD_DES - Standardní DES šifrování s dvouznakovým XXX SALT
</simpara>
</listitem>
<listitem>
<simpara>
CRYPT_EXT_DES - Rozšířené DES šifrování s devítiznakovým XXX SALT
</simpara>
</listitem>
<listitem>
<simpara>
CRYPT_MD5 - MD5 šifrování s dvanáctiznakovým XXX SALT začínajícím $1$
</simpara>
</listitem>
<listitem>
<simpara>
CRYPT_BLOWFISH - Rozšířené DES šifrování s šestnáctiznakovým XXX SALT
začínajícím $2$
</simpara>
</listitem>
</itemizedlist>
<simpara>
Neexistuje žádná decrypt funkce, protože <function>crypt</function> používá
jednosměrný algoritmus.
</simpara>
<simpara>
Viz také: <function>md5</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.echo">
<refnamediv>
<refname>echo</refname>
<refpurpose>Vytisknout jeden nebo více řetězců</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef><function>echo</function></funcdef>
<paramdef>string <parameter>arg1</parameter></paramdef>
<paramdef>string
<parameter><optional>argn</optional>...</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Outputs all parameters.
</simpara>
<para>
<function>Echo</function> vlastně není funkce (je to jazykový konstrukt),
takže u něj nemusíte používat závorky.
<example>
<title>Ukázka <function>Echo</function></title>
<programlisting role="php">
echo "Hello World";
echo "Toto zabírá
několik řádků. Konce řádků se
vytisknou také";
echo "Toto zabírá\nněkolik řádků. Konce řádků se\nvytisknou také.";
</programlisting>
</example>
</para>
<note>
<para>
Pokud chcete echo předat více argumentů, argumenty dokonce uzávorkovat
nesmíte.
</para>
</note>
<simpara>
Viz také:
<function>print</function>,
<function>printf</function>, a
<function>flush</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.explode">
<refnamediv>
<refname>explode</refname>
<refpurpose>Rozdělit řetězec na jiném řetězci</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>explode</function></funcdef>
<paramdef>string <parameter>separator</parameter></paramdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int
<parameter><optional>limit</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí 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>.
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>
Argument <parameter>limit</parameter> byl přidán v PHP 4.0.1
</para>
</note>
<para>
<example>
<title>Ukázka <function>Explode</function></title>
<programlisting role="php">
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode (" ", $pizza);
</programlisting>
</example>
</para>
<note>
<para>
I když <function>implode</function> může z historických důvodů přijímat
argumenty v obou možných pořadích, <function>explode</function> nemůže.
Musíte se ujistit, že je argument <parameter>separator</parameter> před
argumentem <parameter>string</parameter>.
</para>
</note>
<para>
Viz také <function>split</function> a
<function>implode</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.get-html-translation-table">
<refnamediv>
<refname>get_html_translation_table</refname>
<refpurpose>
Vrátit překladovou tabulku používanou v
<function>htmlspecialchars</function> a
<function>htmlentities</function>
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string
<function>get_html_translation_table</function>
</funcdef>
<paramdef>int <parameter>table</parameter></paramdef>
<paramdef>int <parameter><optional>quote_style</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>get_html_translation_table</function> vrátí překladovou tabulku,
která se interně používá ve funkcích <function>htmlspecialchars</function>
a <function>htmlentities</function>. Dvě nové konstanty
(<parameter>HTML_ENTITIES</parameter>,
<parameter>HTML_SPECIALCHARS</parameter>) vám umožňují určit, kterou
tabulku chcete. A stejně jako u funkcí
<function>htmlspecialchars</function> a
<function>htmlentities</function> můžete případně určit
<parameter>quote_style</parameter> se kterým pracujete. Výchozí hodnota je
ENT_COMPAT mód. Viz popis těchto módů u
<function>htmlspecialchars</function>.
<example>
<title>Ukázka Translation Table</title>
<programlisting role="php">
$trans = get_html_translation_table (HTML_ENTITIES);
$str = "Hallo & <Frau> & Krämer";
$encoded = strtr ($str, $trans);
</programlisting>
</example>
Proměnná <literal>$encoded</literal> teď obsahuje: "Hallo
&<sgmltag>amp</sgmltag>;
&<sgmltag>lt</sgmltag>;Frau&<sgmltag>gt</sgmltag>;
&<sgmltag>amp</sgmltag>; Kr&<sgmltag>auml</sgmltag>;mer".
</para>
<para>
Skvělé je, že pomocí <function>array_flip</function> můžete změnit směr
překladu.
<informalexample>
<programlisting role="php">
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
</programlisting>
</informalexample>
Obsahem <literal>$original</literal> je: "Hallo &
<Frau> & Krämer".
<note>
<para>
Tato funkce byla přidána v PHP 4.0.
</para>
</note>
</para>
<para>
Viz také: <function>htmlspecialchars</function>,
<function>htmlentities</function>, <function>strtr</function>,
a <function>array_flip</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.get-meta-tags">
<refnamediv>
<refname>get_meta_tags</refname>
<refpurpose>
Získat hodnoty content atributů všech meta tagů v souboru a vrátit pole
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>get_meta_tags</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
<paramdef>int
<parameter><optional>use_include_path</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Otevře <parameter>filename</parameter>, přečte ho po řádcích, a vyhledá
<meta> tagy ve tvaru
<example>
<title>Ukázka na Meta Tagy</title>
<programlisting role="html">
<meta name="author" content="name">
<meta name="tags" content="php3 documentation">
</head> <!-- tady čtení skončí -->
</programlisting>
</example>
(věnujte pozornost koncům řádků - PHP používá ke čtení vstupu nativní
funkci, takže Macovský soubor na Unixu nebude fungovat).
</para>
<para>
Hodnota atributu name se ve vráceném poli stává klíčem, hodnota atributu
content hodnotou tohoto pole, takzč ho můžete snadno projít nebo získat
jednotlivé hodnoty pomocí snandardních funkcí pro práci s poli.
Zvláštní znaky v hodnotě atributu name jsou nahrazeny znakem '_', zbytek
se převede na malá písmena.
</para>
<para>
Pokud je <parameter>use_include_path</parameter> rovno 1, PHP se pokusí
otevřít soubor ve standardní include cestě.
</para>
</refsect1>
</refentry>
<refentry id="function.hebrev">
<refnamediv>
<refname>hebrev</refname>
<refpurpose>
Převést logický Hebrejský text na vizuální text
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>hebrev</function></funcdef>
<paramdef>string <parameter>hebrew_text</parameter></paramdef>
<paramdef>int
<parameter><optional>max_chars_per_line</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Volitelný argument <parameter>max_chars_per_line</parameter> indikuje
maximální počet znaků na řádek výstupu. Funkce se snaží nerozdělovat slova.
</para>
<para>
Viz také <function>hebrevc</function>
</para>
</refsect1>
</refentry>
<refentry id="function.hebrevc">
<refnamediv>
<refname>hebrevc</refname>
<refpurpose>
Převést logický Hebrejský text na vizuální text s konverzí konců řádků
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>hebrevc</function></funcdef>
<paramdef>string <parameter>hebrew_text</parameter></paramdef>
<paramdef>int
<parameter><optional>max_chars_per_line</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce se podobá <function>hebrev</function> s tím rozdílem, že převádí
konce řádků (\n) na "<br>\n". Volitelný argument
<parameter>max_chars_per_line</parameter> indikuje maximální počet znaků na
řádek výstupu. Funkce se snaží nerozdělovat slova.
</para>
<para>
Viz také <function>hebrev</function>
</para>
</refsect1>
</refentry>
<refentry id="function.htmlentities">
<refnamediv>
<refname>htmlentities</refname>
<refpurpose>Převést všechny použitelné znaky na HTML entity</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>htmlentities</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int <parameter><optional>quote_style</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce je ve všem shodná s <function>htmlspecialchars</function> kromě
toho, že na HTML entity se převedou všechny znaky, které mají odpovídající
entity. Stejně jako <function>htmlspecialchars</function> přijímá volitelný
druhý argument, který indikuje, co se má stát s jednoduchými a dvojitými
uvozovkami. <constant>ENT_COMPAT</constant> (výchozí) převede pouze dvojité
uvozovky, <constant>ENT_QUOTES</constant> převede dvojité i jednoduché
uvozovky, a <constant>ENT_NOQUOTES</constant> ponechá jednoduché i dvojité
uvozovky bez konverze.
</para>
<para>
V současnosti se používá znaková sada ISO-8859-1. Volitelný druhý argument
byl přidán v PHP 3.0.17 a PHP 4.0.3.
</para>
<para>
Viz také <function>htmlspecialchars</function> a
<function>nl2br</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.htmlspecialchars">
<refnamediv>
<refname>htmlspecialchars</refname>
<refpurpose>Převést zvláštní znaky na HTML entity</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>htmlspecialchars</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int <parameter><optional>quote_style</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Některé znaky mají v HTML zvláštní význam, a pokud si mají zachovat běžný
význam, měly by být reprezentovány HTML entitami. Tato funkce vrátí řetězec,
ve kterém došlo k některým z těchto konverzí; provádějí se ty překlady,
které jsou v každodenním programování pro web nejužitečnější. Pokud
požadujete překlad všech znakových entit HTML, použijte
<function>htmlentities</function>.
</para>
<simpara>
Tato funkce je užitečná, pokud se chcete chránit před případným výskytem
HTML v textu dodaném uživateli, například u aplikací typu kniha hostů nebo
diskusní skupina. Volitelný druhý argument, quote_style, určuje, co se má
stát s jednoduchými a dvojitými uvozovkami. Defaultní mód, ENT_COMPAT, je
zpětně kompatibilní mód, konvertuje pouze dvojité uvozovky a jednoduché
uvozovky ponechává nepřeložené. Pokud zadáte ENT_QUOTES, přeloží se
jednoduché i dvojité uvozovky, a pokud zadáte ENT_NOQUOTES, oba druhy
zůstanou bez překladu.
</simpara>
<para>
Dochází k těmto překladům:
<itemizedlist>
<listitem>
<simpara>
'&' (ampersand) se stává '&amp;'
</simpara>
</listitem>
<listitem>
<simpara>
'"' (dvojitá uvozovka) se stává '&quot;' when ENT_NOQUOTES is not set.
</simpara>
</listitem>
<listitem>
<simpara>
''' (jednoduchá uvozovka) se stává '&#039;' only when ENT_QUOTES is
set.
</simpara>
</listitem>
<listitem>
<simpara>
'<' (menší než) se stává '&lt;'
</simpara>
</listitem>
<listitem>
<simpara>
'>' (větší než) se stává '&gt;'
</simpara>
</listitem>
</itemizedlist>
<example>
<title>Ukázka <function>htmlspecialchars</function></title>
<programlisting role="php">
$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES);
</programlisting>
</example>
</para>
<para>
Poznámka: tato funkce provádí pouze výše uvedené překlady. Kompletní překlad
entit viz <function>htmlentities</function>.
Volitelný druhý argument byl přidán v PHP 3.0.17 a PHP 4.0.3.
</para>
<para>
Viz také <function>htmlentities</function> a
<function>nl2br</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.implode">
<refnamediv>
<refname>implode</refname>
<refpurpose>Spojit prvky pole pomocí řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>implode</function></funcdef>
<paramdef>string <parameter>glue</parameter></paramdef>
<paramdef>array <parameter>pieces</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec obsahující řetězcovou reprezentaci všech prvků pole v původním
pořadí s řetězcem <parameter>glue</parameter> mezi každými dvěma prvky.
<example>
<title>Ukázka <function>Implode</function></title>
<programlisting role="php">
$colon_separated = implode (":", $array);
</programlisting>
</example>
</para>
<note>
<para>
<function>implode</function> může z historických důvodů přijímat
argumenty v obou možných pořadích. Kvůli konzistenci s
<function>explode</function> je ale asi méně matoucí používat dokumentované
pořadí argumentů.
</para>
</note>
<simpara>
Viz také <function>explode</function>, <function>join</function>,
a <function>split</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.join">
<refnamediv>
<refname>join</refname>
<refpurpose>Spojit prvky pole pomocí řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>join</function></funcdef>
<paramdef>string <parameter>glue</parameter></paramdef>
<paramdef>array <parameter>pieces</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Funkce <function>join</function> je alias k <function>implode</function>,
a je ve všech ohledech stejná.
</simpara>
<simpara>
Viz také <function>explode</function>, <function>implode</function>,
a <function>split</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.levenshtein">
<refnamediv>
<refname>levenshtein</refname>
<refpurpose>
Spočítat XXX Levenshteinovu vzdálenost mezi dvěma řetězci
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>levenshtein</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>int <function>levenshtein</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
<paramdef>int <parameter>cost_ins</parameter></paramdef>
<paramdef>int <parameter>cost_rep</parameter></paramdef>
<paramdef>int <parameter>cost_del</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>int <function>levenshtein</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
<paramdef>function <parameter>cost</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí ??? Levenshtein-Distance mezi předanými řetězci nebo -1,
pokud délka jednoho z předaných řetězců přesáhne omezení 255 znaků (255 by
mělo být pro běžná porovnání víc než dost, a nikdo se zdravým rozumem nebude
v PHP dělat genetickou analýzu).
</para>
<para>
Levenshteinova vzdálenost se definuje jako minimální počet znaku, které
musíte nahradit, vložit nebo smazat, abyste změnili
<parameter>str1</parameter> na <parameter>str2</parameter>.
Složitost tohoto algoritmu je <literal>O(m*n)</literal>, kde
<literal>n</literal> a <literal>m</literal> jsou délky
<parameter>str1</parameter> a <parameter>str2</parameter> (celkem slušné
v porovnání se <function>similar_text</function>, který je O(max(n,m)**3),
ale i tak drahé).
</para>
<para>
Ve své nejjednodušší podobě tato funkce pouze vezme dva řetězce jako
argumenty a spočítá počet vložení, nahrazení a smazání nutných k
transformaci <parameter>str1</parameter> na <parameter>str2</parameter>.
</para>
<para>
Druhá varianta přijme tři další argumenty, které definují náklady na operace
vložení, nahrazeni a smazání. Tato varianta je všeobecnější a
přizpůsobivější než varianta první, ale ne tak výkonná.
</para>
<para>
Třetí varianta (zatím neimplementovaná) bude nejvšeobecnější a
nejpřizpůsobivější, ale také nejpomalejší alternativou. Bude volat
uživatelskou funkci, která určí náklady na všechny možné operace.
</para>
<para>
Tato uživatelská funkce se bude volat s následujícími argumenty:
<itemizedlist>
<listitem>
<simpara>
operatce, která se má provést: 'I', 'R' or 'D'
</simpara>
</listitem>
<listitem>
<simpara>
původní znak v řetězci 1
</simpara>
</listitem>
<listitem>
<simpara>
původní znak v řetězci 2
</simpara>
</listitem>
<listitem>
<simpara>
pozice v řetězci 1
</simpara>
</listitem>
<listitem>
<simpara>
pozice v řetězci 2
</simpara>
</listitem>
<listitem>
<simpara>
znaky zbývající v řetězci 1
</simpara>
</listitem>
<listitem>
<simpara>
znaky zbývající v řetězci 2
</simpara>
</listitem>
</itemizedlist>
Tato uživatelská funkce musí vrátit kladné celé číslo vyčíslující náklady
na tuto konkrétní operaci, ale může se rozhodnout použít pouze některé
z přijatých argumentů.
</para>
<para>
Tento přístup nabízí možnost zohlednit důležitost určitých symbolů (znaků)
a/nebo rozdíly mezi nimi, či dokonce kontext, ve kterém se vyskytují při
určování nákladů na vložení, změnu nebo smazání, ale za cenu ztráty všech
optimalizací využití CPU registru a XXX cache misses, které byly zapracovány
do předchozích dvou variant.
</para>
<para>
Viz také <function>soundex</function>,
<function>similar_text</function>
a <function>metaphone</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ltrim">
<refnamediv>
<refname>ltrim</refname>
<refpurpose>Odstranit netisknutelné znaky ze začátku řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ltrim</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce ořízne netisknutelné znaky ze začátku řetězce a vrátí oříznutý
řetězec. Netisknutelné znaky, které se v současnosti odstraňují, jsou:
"\n", "\r", "\t", "\v", "\0", a prostá mezera.
</para>
<para>
Viz také <function>chop</function>, <function>rtrim</function>, a
<function>trim</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.md5">
<refnamediv>
<refname>md5</refname>
<refpurpose>Spočítat MD5 XXX hash řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>md5</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Spočítá MD5 XXX hash argumentu <parameter>str</parameter> pomocí
<ulink url="&url.rfc;rfc1321.html">MD5 Message-Digest Algoritmu společnosti
RSA Data Security, Inc.</ulink>.
</para>
<para>
Viz také: <function>crc32</function>
</para>
</refsect1>
</refentry>
<refentry id="function.metaphone">
<refnamediv>
<refname>Metaphone</refname>
<refpurpose>Spočítat metaphone klíč řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>metaphone</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Spočítá metaphone klíč argumentu <parameter>str</parameter>.
</para>
<para>
<function>etaphone</function>, podobně jako <function>soundex</function>,
vytvoří stejný klíč pro podobně znějící slova. Je přesnější než
<function>soundex</function>, protože zná základní pravidla anglické
výslovnosti. Metaphone klíče mají proměnlivou délku.
</para>
<para>
Metaphone vyvinul Lawrence Philips
<[EMAIL PROTECTED]>. Je popsáno v ["Practical
Algorithms for Programmers", Binstock & Rex, Addison Wesley,
1995].
<note>
<para>
Tato funkce byla přidána v PHP 4.0.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.nl2br">
<refnamediv>
<refname>nl2br</refname>
<refpurpose>Převede konce řádků na HTML XXX konce řádků</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>nl2br</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí <parameter>string</parameter>, ve kterém je před každý konec řádku
vložen tag '<BR>'.
</para>
<para>
Viz také <function>htmlspecialchars</function>,
<function>htmlentities</function> a
<function>wordwrap</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ord">
<refnamediv>
<refname>Ord</refname>
<refpurpose>Vrátit ASCII hodnotu znaku</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ord</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí ASCII hodnotu prvního znaku v <parameter>string</parameter>. Tato
funkce doplňuje <function>chr</function>.
<example>
<title>Ukázka <function>Ord</function></title>
<programlisting role="php">
if (ord ($str) == 10) {
echo "Prvním znakem \$str je line feed.\n";
}
</programlisting>
</example>
</para>
<simpara>
Viz také <function>chr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.parse-str">
<refnamediv>
<refname>parse_str</refname>
<refpurpose>Rozložit řetězec do proměnných</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>parse_str</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>array <parameter><optional>arr</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Rozloží řetězec, jako kdyby to byl query string předaný v URL a definuje
příslušné proměnné v současném prostoru. Pokud je předán druhý argument
<parameter>arr</parameter>, proměnné se místo toho uloží do této proměnné
jako pole.
</para>
<para>
<example>
<title>Using <function>parse_str</function></title>
<programlisting role="php">
$str = "first=value&second[]=this+works&second[]=another";
parse_str($str);
echo $first; /* vytiskne "value" */
echo $second[0]; /* vytiskne "this works" */
echo $second[1]; /* vytiskne "another" */
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.print">
<refnamediv>
<refname>print</refname>
<refpurpose>Vytisknout řetězec</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef><function>print</function></funcdef>
<paramdef>string <parameter>arg</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vytiskne <parameter>arg</parameter>.
</simpara>
<simpara>
Viz také: <function>echo</function>, <function>printf</function>,
a <function>flush</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.printf">
<refnamediv>
<refname>printf</refname>
<refpurpose>Vytisknout formátovaný řetězec</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>printf</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>mixed
<parameter><optional>args</optional></parameter>...
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Vytvoří výtup podle argumentu <parameter>format</parameter>, který je popsán
v dokumentaci <function>sprintf</function>.
</simpara>
<simpara>
Viz také: <function>print</function>, <function>sprintf</function>,
<function>sscanf</function>, <function>fscanf</function>,
a <function>flush</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.quoted-printable-decode">
<refnamediv>
<refname>quoted_printable_decode</refname>
<refpurpose>
Převést quoted-printable řetězec na osmibitový řetězec
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string
<function>quoted_printable_decode</function>
</funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Tato funkce vrátí osmibitový binární řetězec odpovídající dekédovanému
quoted printable řetězci. Tato funkce je podobná
<function>imap_qprint</function>, s tou výjimkou, že tato funkce nevyžaduje
IMAP modul.
</simpara>
</refsect1>
</refentry>
<refentry id="function.quotemeta">
<refnamediv>
<refname>quotemeta</refname>
<refpurpose>Opatřit lomítky metaznaky</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>quotemeta</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí verzi <parameter>str</parameter> se zpětným lomítkem před všemi výskyty
následujících znaků: <screen>. \\ + * ? [ ^ ] ( $ )</screen>
</para>
<simpara>
Viz také <function>addslashes</function>,
<function>htmlentities</function>,
<function>htmlspecialchars</function>,
<function>nl2br</function>, a
<function>stripslashes</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.rtrim">
<refnamediv>
<refname>rtrim</refname>
<refpurpose>Odstranit netisknutelné znaky z konce řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcdef>string <function>rtrim</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcsynopsis>
<para>
Vrátí předaný řetězec bez netisknutelných znaků (vč. konců řádku) na konci.
Toto je alias k <function>chop</function>.
<example>
<title>Ukázka <function>rtrim</function></title>
<programlisting role="php">
$trimmed = rtrim ($line);
</programlisting>
</example>
</para>
<para>
Viz také <function>trim</function>, <function>ltrim</function>, a
<function>rtrim</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.sscanf">
<refnamediv>
<refname>sscanf</refname>
<refpurpose>Parses input from a string according to a format</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>sscanf</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>string
<parameter><optional>var1</optional></parameter>...
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
The function <function>sscanf</function> is the input analog of
<function>printf</function>. <function>Sscanf</function> reads from
the string <parameter>str</parameter> and interprets it according to
the specified <parameter>format</parameter>. If only two parameters were
passed to this function, the values parsed will be returned as an array.
<example>
<title>Ukázka <function>Sscanf</function> Example</title>
<programlisting role="php">
// getting the serial number
$serial = sscanf("SN/2350001","SN/%d");
// and the date of manufacturing
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate,"%s %d %d");
echo "Item $serial was manufactured on: $year-".substr($month,0,3)."-$day\n";
</programlisting>
</example>
If optional parameters are passed, the function will return the number of
assigned values. The optional parameters must be passed by reference.
<example>
<title>Ukázka <function>Sscanf</function> - using optional parameters</title>
<programlisting role="php">
// get author info and generate DocBook entry
$auth = "24\tLewis Carroll";
$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last);
echo "<author id='$id'>
<firstname>$first</firstname>
<surname>$last</surname>
</author>\n";
</programlisting>
</example>
</para>
<para>
Viz také: <function>fscanf</function>, <function>printf</function>,
and <function>sprintf</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.setlocale">
<refnamediv>
<refname>setlocale</refname>
<refpurpose>Set locale information</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>setlocale</function></funcdef>
<paramdef>string <parameter>category</parameter></paramdef>
<paramdef>string <parameter>locale</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<parameter>Category</parameter> is a string specifying the
category of the functions affected by the locale setting:
<itemizedlist>
<listitem>
<simpara>
LC_ALL for all of the below
</simpara>
</listitem>
<listitem>
<simpara>
LC_COLLATE for string comparison - not currently implemented in PHP
</simpara>
</listitem>
<listitem>
<simpara>
LC_CTYPE for character classification and conversion, for
example <function>strtoupper</function>
</simpara>
</listitem>
<listitem>
<simpara>
LC_MONETARY for localeconv() - not currently implemented in
PHP
</simpara>
</listitem>
<listitem>
<simpara>
LC_NUMERIC for decimal separator
</simpara>
</listitem>
<listitem>
<simpara>
LC_TIME for date and time formatting with
<function>strftime</function>
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
If <parameter>locale</parameter> is the empty string
<literal>""</literal>, the locale names will be set from the
values of environment variables with the same names as the above
categories, or from "LANG".
</para>
<para>
If locale is zero or <literal>"0"</literal>, the locale setting
is not affected, only the current setting is returned.
</para>
<para>
Setlocale returns the new current locale, or false if the locale
functionality is not implemented in the plattform, the specified
locale does not exist or the category name is invalid.
An invalid category name also causes a warning message.
</para>
</refsect1>
</refentry>
<refentry id="function.similar-text">
<refnamediv>
<refname>similar_text</refname>
<refpurpose>
Calculate the similarity between two strings
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>similar_text</function></funcdef>
<paramdef>string <parameter>first</parameter></paramdef>
<paramdef>string <parameter>second</parameter></paramdef>
<paramdef>double
<parameter><optional>percent</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
This calculates the similarity between two strings as described
in Oliver [1993]. Note that this implementation does not use a
stack as in Oliver's pseudo code, but recursive calls which may
or may not speed up the whole process. Note also that the
complexity of this algorithm is O(N**3) where N is the length of
the longest string.
</para>
<para>
By passing a reference as third argument,
<function>similar_text</function> will calculate the similarity
in percent for you. It returns the number of matching chars in
both strings.
</para>
</refsect1>
</refentry>
<refentry id="function.soundex">
<refnamediv>
<refname>soundex</refname>
<refpurpose>Calculate the soundex key of a string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>soundex</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Calculates the soundex key of <parameter>str</parameter>.
</para>
<para>
Soundex keys have the property that words pronounced similarly
produce the same soundex key, and can thus be used to simplify
searches in databases where you know the pronunciation but not
the spelling. This soundex function returns a string 4 characters
long, starting with a letter.
</para>
<para>
This particular soundex function is one described by Donald Knuth
in "The Art Of Computer Programming, vol. 3: Sorting And
Searching", Addison-Wesley (1973), pp. 391-392.
</para>
<para>
<example>
<title>Soundex Examples</title>
<programlisting role="php">
soundex ("Euler") == soundex ("Ellery") == 'E460';
soundex ("Gauss") == soundex ("Ghosh") == 'G200';
soundex ("Hilbert") == soundex ("Heilbronn") == 'H416';
soundex ("Knuth") == soundex ("Kant") == 'K530';
soundex ("Lloyd") == soundex ("Ladd") == 'L300';
soundex ("Lukasiewicz") == soundex ("Lissajous") == 'L222';
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.sprintf">
<refnamediv>
<refname>sprintf</refname>
<refpurpose>Return a formatted string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>sprintf</function></funcdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>mixed
<parameter><optional>args</optional></parameter>...
</paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Returns a string produced according to the formatting string
<parameter>format</parameter>.
</simpara>
<simpara>
The format string is composed of zero or more directives:
ordinary characters (excluding <literal>%</literal>) that are
copied directly to the result, and <emphasis>conversion
specifications</emphasis>, each of which results in fetching its
own parameter. This applies to both <function>sprintf</function>
and <function>printf</function>.
</simpara>
<para>
Each conversion specification consists of a percent sign
(<literal>%</literal>), followed by one or more of these
elements, in order:
<orderedlist>
<listitem>
<simpara>
An optional <emphasis>padding specifier</emphasis> that says
what character will be used for padding the results to the
right string size. This may be a space character or a
<literal>0</literal> (zero character). The default is to pad
with spaces. An alternate padding character can be specified
by prefixing it with a single quote (<literal>'</literal>).
See the examples below.
</simpara>
</listitem>
<listitem>
<simpara>
An optional <emphasis>alignment specifier</emphasis> that says
if the result should be left-justified or right-justified.
The default is right-justified; a <literal>-</literal>
character here will make it left-justified.
</simpara>
</listitem>
<listitem>
<simpara>
An optional number, a <emphasis>width specifier</emphasis>
that says how many characters (minimum) this conversion should
result in.
</simpara>
</listitem>
<listitem>
<simpara>
An optional <emphasis>precision specifier</emphasis> that says
how many decimal digits should be displayed for floating-point
numbers. This option has no effect for other types than
double. (Another function useful for formatting numbers is
<function>number_format</function>.)
</simpara>
</listitem>
<listitem>
<para>
A <emphasis>type specifier</emphasis> that says what type the
argument data should be treated as. Possible types:
<simplelist>
<member>
<literal>%</literal> - a literal percent character. No
argument is required.
</member>
<member>
<literal>b</literal> - the argument is treated as an
integer, and presented as a binary number.
</member>
<member>
<literal>c</literal> - the argument is treated as an
integer, and presented as the character with that ASCII
value.
</member>
<member>
<literal>d</literal> - the argument is treated as an
integer, and presented as a decimal number.
</member>
<member>
<literal>f</literal> - the argument is treated as a double,
and presented as a floating-point number.
</member>
<member>
<literal>o</literal> - the argument is treated as an
integer, and presented as an octal number.
</member>
<member>
<literal>s</literal> - the argument is treated as and
presented as a string.
</member>
<member>
<literal>x</literal> - the argument is treated as an integer
and presented as a hexadecimal number (with lowercase
letters).
</member>
<member>
<literal>X</literal> - the argument is treated as an integer
and presented as a hexadecimal number (with uppercase
letters).
</member>
</simplelist>
</para>
</listitem>
</orderedlist>
</para>
<simpara>
Viz také: <function>printf</function>, <function>sscanf</function>,
<function>fscanf</function>, and <function>number_format</function>.
</simpara>
</refsect1>
<refsect1>
<title>Examples</title>
<para>
<example>
<title>Ukázka <function>Sprintf</function>: zero-padded integers</title>
<programlisting role="php">
$isodate = sprintf ("%04d-%02d-%02d", $year, $month, $day);
</programlisting>
</example>
<example>
<title>Ukázka <function>Sprintf</function>: formatting currency</title>
<programlisting role="php">
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money will output "123.1";
$formatted = sprintf ("%01.2f", $money);
// echo $formatted will output "123.10"
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.strncasecmp">
<refnamediv>
<refname>strncasecmp</refname>
<refpurpose>
Binary safe case-insensitive string comparison of the first n characters
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strncasecmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
<paramdef>int <parameter>len</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function is similar to <function>strcasecmp</function>, with the
difference that you can specify the (upper limit of the) number of
characters (<parameter>len</parameter>) from each string to be
used in the comparison. If any of the strings is shorter than
<parameter>len</parameter>, then the length of that string will be
used for the comparison.
</para>
<simpara>
Returns < 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
</simpara>
<simpara>
Viz také <function>ereg</function>, <function>strcasecmp</function>,
<function>strcmp</function>, <function>substr</function>,
<function>stristr</function>, and <function>strstr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strcasecmp">
<refnamediv>
<refname>strcasecmp</refname>
<refpurpose>
Binary safe case-insensitive string comparison
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strcasecmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns < 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
<example>
<title>Ukázka <function>strcasecmp</function></title>
<programlisting role="php">
$var1 = "Hello";
$var2 = "hello";
if (!strcasecmp ($var1, $var2)) {
echo '$var1 is equal to $var2 in a case-insensitive string comparison';
}
</programlisting>
</example>
</para>
<simpara>
Viz také <function>ereg</function>, <function>strcmp</function>,
<function>substr</function>, <function>stristr</function>,
<function>strncasecmp</function>, and <function>strstr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strchr">
<refnamediv>
<refname>strchr</refname>
<refpurpose>
Find the first occurrence of a character
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strchr</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function is an alias for <function>strstr</function>, and is
identical in every way.
</para>
</refsect1>
</refentry>
<refentry id="function.strcmp">
<refnamediv>
<refname>strcmp</refname>
<refpurpose>Binary safe string comparison</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strcmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Returns < 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
</simpara>
<simpara>
Note that this comparison is case sensitive.
</simpara>
<simpara>
Viz také <function>ereg</function>,
<function>strcasecmp</function>, <function>substr</function>,
<function>stristr</function>, <function>strncasecmp</function>,
<function>strncmp</function>, and <function>strstr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strcspn">
<refnamediv>
<refname>strcspn</refname>
<refpurpose>
Find length of initial segment not matching mask
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strcspn</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Returns the length of the initial segment of
<parameter>str1</parameter> which does <emphasis>not</emphasis>
contain any of the characters in <parameter>str2</parameter>.
</simpara>
<simpara>
Viz také <function>strspn</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strip-tags">
<refnamediv>
<refname>strip_tags</refname>
<refpurpose>Strip HTML and PHP tags from a string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strip_tags</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string
<parameter><optional>allowable_tags</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function tries to strip all HTML and PHP tags from the given
string. It errors on the side of caution in case of incomplete
or bogus tags. It uses the same tag stripping state machine as
the <function>fgetss</function> function.
</para>
<para>
You can use the optional second parameter to specify tags which
should not be stripped.
<note>
<para>
<parameter>Allowable_tags</parameter> was added in PHP 3.0.13,
PHP4B3.
</para>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.stripcslashes">
<refnamediv>
<refname>stripcslashes</refname>
<refpurpose>
Un-quote string quoted with <function>addcslashes</function>
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>stripcslashes</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns a string with backslashes stripped off. Recognizes
C-like <literal>\n</literal>, <literal>\r</literal> ..., octal
and hexadecimal representation.
<note>
<simpara>
Added in PHP4b3-dev.
</simpara>
</note>
</para>
<simpara>
Viz také <function>addcslashes</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.stripslashes">
<refnamediv>
<refname>stripslashes</refname>
<refpurpose>
Un-quote string quoted with <function>addslashes</function>
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>stripslashes</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns a string with backslashes stripped off.
(<literal>\'</literal> becomes <literal>'</literal> and so on.)
Double backslashes are made into a single backslash.
</para>
<simpara>
Viz také <function>addslashes</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.stristr">
<refnamediv>
<refname>stristr</refname>
<refpurpose>
Case-insensitive <function>strstr</function>
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>stristr</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns all of <parameter>haystack</parameter> from the first
occurrence of <parameter>needle</parameter> to the end.
<parameter>needle</parameter> and <parameter>haystack</parameter>
are examined in a case-insensitive manner.
</para>
<para>
If <parameter>needle</parameter> is not found, returns false.
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
</para>
<para>
Viz také <function>strchr</function>,
<function>strrchr</function>, <function>substr</function>, and
<function>ereg</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strlen">
<refnamediv>
<refname>strlen</refname>
<refpurpose>Get string length</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strlen</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the length of <parameter>string</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.strnatcmp">
<refnamediv>
<refname>strnatcmp</refname>
<refpurpose>
String comparisons using a "natural order" algorithm
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strnatcmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function implements a comparison algorithm that orders
alphanumeric strings in the way a human being would, this is
described as a "natural ordering". An example of the difference
between this algorithm and the regular computer string sorting
algorithms (used in <function>strcmp</function>) can be seen
below:
<informalexample>
<programlisting>
$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png");
echo "Standard string comparison\n";
usort($arr1,"strcmp");
print_r($arr1);
echo "\nNatural order string comparison\n";
usort($arr2,"strnatcmp");
print_r($arr2);
</programlisting>
</informalexample>
The code above will generate the following output:
<informalexample>
<programlisting>
Standard string comparison
Array
(
[0] => img1.png
[1] => img10.png
[2] => img12.png
[3] => img2.png
)
Natural order string comparison
Array
(
[0] => img1.png
[1] => img2.png
[2] => img10.png
[3] => img12.png
)
</programlisting>
</informalexample>
For more infomation see: Martin Pool's <ulink
url="&url.strnatcmp;">Natural Order String Comparison</ulink>
page.
</para>
<simpara>
Similar to other string comparison functions, this one returns
< 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
</simpara>
<simpara>
Note that this comparison is case sensitive.
</simpara>
<simpara>
Viz také <function>ereg</function>,
<function>strcasecmp</function>, <function>substr</function>,
<function>stristr</function>, <function>strcmp</function>,
<function>strncmp</function>, <function>strncasecmp</function>,
<function>strnatcasecmp</function>, <function>strstr</function>,
<function>natsort</function> and <function>natcasesort</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strnatcasecmp">
<refnamediv>
<refname>strnatcasecmp</refname>
<refpurpose>
Case insensitive string comparisons using a "natural order" algorithm
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strnatcasecmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function implements a comparison algorithm that orders
alphanumeric strings in the way a human being would. The
behavior of this function is similar to
<function>strnatcmp</function>, except that the comparison is
not case sensitive. For more infomation see: Martin Pool's
<ulink url="&url.strnatcmp;">Natural Order String
Comparison</ulink> page.
</para>
<simpara>
Similar to other string comparison functions, this one returns
< 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
</simpara>
<simpara>
Viz také <function>ereg</function>,
<function>strcasecmp</function>, <function>substr</function>,
<function>stristr</function>, <function>strcmp</function>,
<function>strncmp</function>, <function>strncasecmp</function>,
<function>strnatcmp</function>, and <function>strstr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strncmp">
<refnamediv>
<refname>strncmp</refname>
<refpurpose>
Binary safe string comparison of the first n characters
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strncmp</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
<paramdef>int <parameter>len</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function is similar to <function>strcmp</function>, with the
difference that you can specify the (upper limit of the) number of
characters (<parameter>len</parameter>) from each string to be
used in the comparison. If any of the strings is shorter than
<parameter>len</parameter>, then the length of that string will be
used for the comparison.
</para>
<simpara>
Returns < 0 if <parameter>str1</parameter> is less than
<parameter>str2</parameter>; > 0 if <parameter>str1</parameter>
is greater than <parameter>str2</parameter>, and 0 if they are
equal.
</simpara>
<simpara>
Note that this comparison is case sensitive.
</simpara>
<simpara>
Viz také <function>ereg</function>, <function>strncasecmp</function>,
<function>strcasecmp</function>, <function>substr</function>,
<function>stristr</function>, <function>strcmp</function>,
and <function>strstr</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.str-pad">
<refnamediv>
<refname>str_pad</refname>
<refpurpose>Pad a string to a certain length with another string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>str_pad</function></funcdef>
<paramdef>string <parameter>input</parameter></paramdef>
<paramdef>int <parameter>pad_length</parameter></paramdef>
<paramdef>string
<parameter><optional>pad_string</optional></parameter></paramdef>
<paramdef>int
<parameter><optional>pad_type</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
This functions pads the <parameter>input</parameter> string on
the left, the right, or both sides to the specifed padding
length. If the optional argument
<parameter>pad_string</parameter> is not supplied, the
<parameter>input</parameter> is padded with spaces, otherwise it
is padded with characters from <parameter>pad_string</parameter>
up to the limit.
</para>
<para>
Optional argument <parameter>pad_type</parameter> can be
STR_PAD_RIGHT, STR_PAD_LEFT, or STR_PAD_BOTH. If
<parameter>pad_type</parameter> is not specified it is assumed to
be STR_PAD_RIGHT.
</para>
<para>
If the value of <parameter>pad_length</parameter> is negative or
less than the length of the input string, no padding takes
place.
</para>
<para>
<example>
<title>Ukázka <function>str_pad</function></title>
<programlisting role="php">
$input = "Alien";
print str_pad($input, 10); // produces "Alien "
print str_pad($input, 10, "-=", STR_PAD_LEFT); // produces "-=-=-Alien"
print str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Alien___"
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.strpos">
<refnamediv>
<refname>strpos</refname>
<refpurpose>
Find position of first occurrence of a string
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strpos</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
<paramdef>int
<parameter><optional>offset</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the numeric position of the first occurrence of
<parameter>needle</parameter> in the
<parameter>haystack</parameter> string. Unlike the
<function>strrpos</function>, this function can take a full
string as the <parameter>needle</parameter> parameter and the
entire string will be used.
</para>
<para>
If <parameter>needle</parameter> is not found, returns false.
<note>
<para>
It is easy to mistake the return values for "character found at
position 0" and "character not found". Here's how to detect
the difference:
<informalexample>
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strpos ($mystring, "b");
if ($pos === false) { // note: three equal signs
// not found...
}
// in versions older than 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) && !$pos) {
// not found...
}
</programlisting>
</informalexample>
</para>
</note>
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
</para>
<para>
The optional <parameter>offset</parameter> parameter allows you
to specify which character in <parameter>haystack</parameter> to
start searching. The position returned is still relative to the
the beginning of <parameter>haystack</parameter>.
</para>
<para>
Viz také <function>strrpos</function>,
<function>strrchr</function>, <function>substr</function>,
<function>stristr</function>, and <function>strstr</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strrchr">
<refnamediv>
<refname>strrchr</refname>
<refpurpose>
Find the last occurrence of a character in a string
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strrchr</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
This function returns the portion of
<parameter>haystack</parameter> which starts at the last
occurrence of <parameter>needle</parameter> and goes until the
end of <parameter>haystack</parameter>.
</para>
<para>
Returns false if <parameter>needle</parameter> is not found.
</para>
<para>
If <parameter>needle</parameter> contains more than one
character, the first is used.
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
<example>
<title>Ukázka <function>Strrchr</function></title>
<programlisting role="php">
// get last directory in $PATH
$dir = substr (strrchr ($PATH, ":"), 1);
// get everything after last newline
$text = "Line 1\nLine 2\nLine 3";
$last = substr (strrchr ($text, 10), 1 );
</programlisting>
</example>
</para>
<para>
Viz také <function>substr</function>,
<function>stristr</function>, and <function>strstr</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.str-repeat">
<refnamediv>
<refname>str_repeat</refname>
<refpurpose>Repeat a string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>str_repeat</function></funcdef>
<paramdef>string <parameter>input</parameter></paramdef>
<paramdef>int <parameter>multiplier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns <parameter>input_str</parameter> repeated
<parameter>multiplier</parameter> times.
<parameter>multiplier</parameter> has to be greater than 0.
</para>
<example>
<title>Ukázka <function>Str_repeat</function></title>
<programlisting role="php">
echo str_repeat ("-=", 10);
</programlisting>
</example>
<para>
This will output "-=-=-=-=-=-=-=-=-=-=".
</para>
<note>
<para>
Tato funkce byla přidána v PHP 4.0.
</para>
</note>
</refsect1>
</refentry>
<refentry id="function.strrev">
<refnamediv>
<refname>strrev</refname>
<refpurpose>Reverse a string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strrev</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns <parameter>string</parameter>, reversed.
</para>
</refsect1>
</refentry>
<refentry id="function.strrpos">
<refnamediv>
<refname>strrpos</refname>
<refpurpose>
Find position of last occurrence of a char in a string
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strrpos</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>char <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns the numeric position of the last occurrence of
<parameter>needle</parameter> in the
<parameter>haystack</parameter> string. Note that the needle in
this case can only be a single character. If a string is passed
as the needle, then only the first character of that string will
be used.
</para>
<para>
If <parameter>needle</parameter> is not found, returns false.
<note>
<para>
It is easy to mistake the return values for "character found at
position 0" and "character not found". Here's how to detect
the difference:
<informalexample>
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strrpos ($mystring, "b");
if ($pos === false) { // note: three equal signs
// not found...
}
// in versions older than 4.0b3:
$pos = strrpos ($mystring, "b");
if (is_string ($pos) && !$pos) {
// not found...
}
</programlisting>
</informalexample>
</para>
</note>
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
</para>
<para>
Viz také <function>strpos</function>,
<function>strrchr</function>, <function>substr</function>,
<function>stristr</function>, and <function>strstr</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strspn">
<refnamediv>
<refname>strspn</refname>
<refpurpose>
Find length of initial segment matching mask
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>strspn</function></funcdef>
<paramdef>string <parameter>str1</parameter></paramdef>
<paramdef>string <parameter>str2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<simpara>
Returns the length of the initial segment of
<parameter>str1</parameter> which consists entirely of characters
in <parameter>str2</parameter>.
</simpara>
<para>
<informalexample>
<programlisting role="php">
strspn ("42 is the answer, what is the question ...", "1234567890");
</programlisting>
<para>
will return 2 as result.
</para>
</informalexample>
</para>
<simpara>
Viz také <function>strcspn</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.strstr">
<refnamediv>
<refname>strstr</refname>
<refpurpose>Find first occurrence of a string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strstr</function></funcdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Returns all of <parameter>haystack</parameter> from the first
occurrence of <parameter>needle</parameter> to the end.
</para>
<para>
If <parameter>needle</parameter> is not found, returns false.
</para>
<para>
If <parameter>needle</parameter> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
</para>
<para>
<note>
<para>
Note that this function is case-sensitive. For
case-insensitive searches, use <function>stristr</function>.
</para>
</note>
</para>
<para>
<example>
<title>Ukázka <function>Strstr</function></title>
<programlisting role="php">
$email = '[EMAIL PROTECTED]';
$domain = strstr ($email, '@');
print $domain; // prints @designmultimedia.com
</programlisting>
</example>
</para>
<para>
Viz také <function>stristr</function>,
<function>strrchr</function>, <function>substr</function>, and
<function>ereg</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strtok">
<refnamediv>
<refname>strtok</refname>
<refpurpose>Tokenize string</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strtok</function></funcdef>
<paramdef>string <parameter>arg1</parameter></paramdef>
<paramdef>string <parameter>arg2</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>strtok</function> is used to tokenize a string. That
is, if you have a string like "This is an example string" you
could tokenize this string into its individual words by using the
space character as the token.
<example>
<title>Ukázka <function>Strtok</function></title>
<programlisting role="php">
$string = "This is an example string";
$tok = strtok ($string," ");
while ($tok) {
echo "Word=$tok<br>";
$tok = strtok (" ");
}
</programlisting>
</example>
</para>
<para>
Note that only the first call to strtok uses the string argument.
Every subsequent call to strtok only needs the token to use, as
it keeps track of where it is in the current string. To start
over, or to tokenize a new string you simply call strtok with the
string argument again to initialize it. Note that you may put
multiple tokens in the token parameter. The string will be
tokenized when any one of the characters in the argument are
found.
</para>
<para>
Also be careful that your tokens may be equal to "0". This
evaluates to false in conditional expressions.
</para>
<para>
Viz také <function>split</function> and
<function>explode</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strtolower">
<refnamediv>
<refname>strtolower</refname>
<refpurpose>Změnit řetězec na malá písmena</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strtolower</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí <parameter>string</parameter> se všemi abecedními znaky změněnými na
malá písmena
</para>
<para>
Pozn.: co je 'abecední' je dáno aktuálním místním nastavením. Například ve
standardním místním nastavení "C" se znaky jako přehlasované a (Ä)
nepřevedou.
</para>
<example>
<title>Ukázka <function>Strtolower</function></title>
<programlisting role="php">
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtolower($str);
print $str; # vytiskne mary had a little lamb and she loved it so
</programlisting>
</example>
<para>
Viz také <function>strtoupper</function> a <function>ucfirst</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strtoupper">
<refnamediv>
<refname>strtoupper</refname>
<refpurpose>Změnit řetězec na velká písmena</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strtoupper</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí <parameter>string</parameter> se všemi abecedními znaky změněnými na
velká písmena.
</para>
<para>
Pozn.: co je 'abecední' je dáno aktuálním místním nastavením. Například ve
standardním místním nastavení "C" se znaky jako přehlasované a (ä) nepřevedou.
</para>
<example>
<title>Ukázka <function>strtoupper</function></title>
<programlisting role="php">
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtoupper ($str);
print $str; # vytiskne MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
</programlisting>
</example>
<para>
Viz také <function>strtolower</function> a <function>ucfirst</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.str-replace">
<refnamediv>
<refname>str_replace</refname>
<refpurpose>
Nahradit všechny výskyty jednoho řetězce v jiném dalším řetězcem
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>str_replace</function></funcdef>
<paramdef>string <parameter>needle</parameter></paramdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string <parameter>haystack</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce nahradí všechny výskyty argumentu <parameter>needle</parameter>
v <parameter>haystack</parameter> argumentem <parameter>str</parameter>.
Pokud nepotřebujete složitá pravidla pro nahrazování, měli byste vždy použít
tuto funkci místo <function>ereg_replace</function>.
</para>
<para>
<example>
<title>Ukázka <function>str_replace</function></title>
<programlisting role="php">
$bodytag = str_replace ("%body%", "black", "<body text=%body%>");
</programlisting>
</example>
</para>
<para>
Tato funkce je XXX binárně bezpečná.
</para>
<note>
<para>
<function>Str_replace</function> was added in PHP 3.0.6, but was
buggy up until PHP 3.0.8.
</para>
</note>
<para>
Viz také <function>ereg_replace</function> and
<function>strtr</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.strtr">
<refnamediv>
<refname>strtr</refname>
<refpurpose>Přeložit určité znaky</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>strtr</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>string <parameter>from</parameter></paramdef>
<paramdef>string <parameter>to</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce upraví <parameter>str</parameter> tak, že všechny výskyty
všech znaků ve <parameter>from</parameter> přeloží na odpovídající znaky v
<parameter>to</parameter> a vrátí výsledek.
</para>
<para>
Pokud jsou <parameter>from</parameter> a <parameter>to</parameter> různě
dlouhé, přebývající znaky z delšího z těch dvou se ignorují.
<example>
<title>Ukázka <function>strtr</function></title>
<programlisting role="php">
$addr = strtr($addr, "äĺö", "aao");
</programlisting>
</example>
</para>
<para>
<function>strtr</function> se dá také volat pouze se dvěma argumenty. Při
volání se dvěma argumenty se chová takto: <parameter>from</parameter> musí
být pole obsahující páry řetězců, které se zamění ve zdrojovém řetězci.
<function>strtr</function> vždy hledá nejdelší možnou shodu a *NENAHRAZUJE*
ty části řetězce, na kterých už pracovala.
</para>
<para>
Ukázky:
<informalexample>
<programlisting role="php">
$trans = array ("ahoj" => "nazdar", "nazdar" => "ahoj");
echo strtr("nazdar lidi, řekl jsem ahoj", $trans) . "\n";
</programlisting>
</informalexample>
Výsledek: "ahoj lidi, řekl jsem nazdar",
</para>
<note>
<simpara>
Tato vlastnost (dva argumenty) byla přidána v PHP 4.0.
</simpara>
</note>
<para>
Viz také <function>ereg_replace</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.substr">
<refnamediv>
<refname>substr</refname>
<refpurpose>Vrátit část řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>substr</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int <parameter>start</parameter></paramdef>
<paramdef>int
<parameter><optional>length</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>substr</function> vrátí část argumentu <parameter>string</parameter>
určenou argumenty <parameter>start</parameter> a <parameter>length</parameter>.
</para>
<para>
Pokud je <parameter>start</parameter> pozitivní, vrácený řetězec začne
<parameter>start</parameter>-tým znakem řetězce <parameter>string</parameter>,
počítáno od nuly. Například v řetězci '<literal>abcdef</literal>' je znakem
na <literal>0</literal>-té pozici '<literal>a</literal>', znakem na pozici
<literal>2</literal> je '<literal>c</literal>', atd.
</para>
<para>
Příklady:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", 1); // vrátí "bcdef"
$rest = substr ("abcdef", 1, 3); // vrátí "bcd"
</programlisting>
</informalexample>
</para>
<para>
Pokud je <parameter>start</parameter> negativní, vrácený řetězec začne
<parameter>start</parameter>-tým znakem od konce argumentu
<parameter>string</parameter>.
</para>
<para>
Příklady:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", -1); // vrátí "f"
$rest = substr ("abcdef", -2); // vrátí "ef"
$rest = substr ("abcdef", -3, 1); // vrátí "d"
</programlisting>
</informalexample>
</para>
<para>
Pokud je argument <parameter>length</parameter> kladný, vrácený řetězec
skončí <parameter>length</parameter> znaků od <parameter>start</parameter>.
Pokud by to znamenalo řetězec se zápornou délkou (<parameter>start</parameter>
je za <parameter>length</parameter>), vrácený řetězec bude sestávat z
jediného znaku na pozici <parameter>start</parameter>.
</para>
<para>
Pokud je argument <parameter>length</parameter> kladný, vrácený řetězec
skončí <parameter>length</parameter> znaků od konce argumentu
<parameter>string</parameter>. Pokud by to znamenalo řetězec se zápornou
délkou, vrácený řetězec bude sestávat z jediného znaku na pozici
<parameter>start</parameter>.
</para>
<para>
Příklady:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", 1, -1); // vrátí "bcde"
</programlisting>
</informalexample>
</para>
<para>
Viz také <function>strrchr</function> a
<function>ereg</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.substr-count">
<refnamediv>
<refname>substr_count</refname>
<refpurpose>Spočítat počet výskytů řetězce</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>substr_count</function></funcdef>
<paramdef>string <parameter>haystrack</parameter></paramdef>
<paramdef>string <parameter>needle</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>substr_count</function> vrátí počet výskytů řetězce
<parameter>needle</parameter> v řetězci <parameter>haystack</parameter>
string.
</para>
<para>
<example>
<title>Ukázka <function>substr_count</function></title>
<programlisting>
print substr_count("This is a test", "is"); // prints out 2
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.substr-replace">
<refnamediv>
<refname>substr_replace</refname>
<refpurpose>Nahradit část řetězce jiným řetězcem</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>substr_replace</function></funcdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>string <parameter>replacement</parameter></paramdef>
<paramdef>int <parameter>start</parameter></paramdef>
<paramdef>int
<parameter><optional>length</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>substr_replace</function> nahradí část řetězce
<parameter>string</parameter> ohraničenou argumenty
<parameter>start</parameter> a (volitelně)
<parameter>length</parameter> řetězcem v argumentu
<parameter>replacement</parameter>. Vrátí výsledek.
</para>
<para>
Pokud je <parameter>start</parameter> pozitivní, náhrada začne na
<parameter>start</parameter>-tém znaku argumentu
<parameter>string</parameter>.
</para>
<para>
Pokud je <parameter>start</parameter> negativní, náhrada začne na
<parameter>start</parameter>-tém znaku od konce argumentu
<parameter>string</parameter>.
</para>
<para>
Pokud je přítomen <parameter>length</parameter>, a je pozitivní, představuje
délku části argumentu <parameter>string</parameter>, která bude nahražena.
Pokud je negativní, představuje počet znaků od konce
<parameter>string</parameter>, kde má nahrazování skončit. Pokud přítomen
není, bere se standardně strlen( <parameter>string</parameter> ); tj.
nahrazování končí na konci argumentu <parameter>string</parameter>.
</para>
<para>
<example>
<title>Ukázka <function>Substr_replace</function></title>
<programlisting role="php">
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Originál: $var<hr>\n";
/* Tyto dva příklady nahradí celý obsah proměnné $var řetězcem 'bob'. */
echo substr_replace ($var, 'bob', 0) . "<br>\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "<br>\n";
/* Toto vloží 'bob' na začátek $var. */
echo substr_replace ($var, 'bob', 0, 0) . "<br>\n";
/* Tyto dva příklady nahradí 'MNRPQR' ve $var řetězcem 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "<br>\n";
echo substr_replace ($var, 'bob', -7, -1) . "<br>\n";
/* Toto z $var odstraní 'MNRPQR'. */
echo substr_replace ($var, '', 10, -1) . "<br>\n";
?>
</programlisting>
</example>
</para>
<para>
Viz také <function>str_replace</function> a <function>substr</function>.
</para>
<note>
<simpara>
Funkce <function>substr_replace</function> byla přidána v PHP 4.0.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.trim">
<refnamediv>
<refname>trim</refname>
<refpurpose>
Odstranit netisknutelné znaky ze začátku a konce řetězce
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>trim</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce odstraní netisknutelné znaky ze začátku a konce řetězce a
vrátí řetězec bez těchto znaků. Netisknutelné znaky, které se v současnosti
odstraňují, jsou: "\n", "\r", "\t", "\v", "\0", a mezera.
</para>
<para>
Viz také <function>chop</function>, <function>rtrim</function> a
<function>ltrim</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ucfirst">
<refnamediv>
<refname>ucfirst</refname>
<refpurpose>Make a string's first character uppercase</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ucfirst</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Capitalizes the first character of <parameter>str</parameter> if
that character is alphabetic.
</para>
<para>
Note that 'alphabetic' is determined by the current locale. For
instance, in the default "C" locale characters such as umlaut-a
(ä) will not be converted.
<example>
<title>Ukázka <function>Ucfirst</function></title>
<programlisting role="php">
$text = 'mary had a little lamb and she loved it so.';
$text = ucfirst ($text); // $text is now Mary had a little lamb
// and she loved it so.
</programlisting>
</example>
</para>
<para>
Viz také <function>strtoupper</function> and
<function>strtolower</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.ucwords">
<refnamediv>
<refname>ucwords</refname>
<refpurpose>
Uppercase the first character of each word in a string
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ucwords</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Capitalizes the first character of each word in
<parameter>str</parameter> if that character is alphabetic.
<example>
<title>Ukázka <function>ucwords</function></title>
<programlisting role="php">
$text = "mary had a little lamb and she loved it so.";
$text = ucwords($text); // $text is now: Mary Had A Little
// Lamb And She Loved It So.
</programlisting>
</example>
<note>
<simpara>
The definition of a word is any string of characters
that is immediately after a whitespace (These are:
space, form-feed, newline, carriage return, horizontal tab,
and vertical tab).
</simpara>
</note>
</para>
<para>
Viz také <function>strtoupper</function>,
<function>strtolower</function> and <function>ucfirst</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.wordwrap">
<refnamediv>
<refname>wordwrap</refname>
<refpurpose>
Wraps a string to a given number of characters using a string
break character.
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>wordwrap</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
<paramdef>int
<parameter><optional>width</optional></parameter>
</paramdef>
<paramdef>string
<parameter><optional>break</optional></parameter>
</paramdef>
<paramdef>int
<parameter><optional>cut</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
Wraps the string <parameter>str</parameter> at the column number
specified by the (optional) <parameter>width</parameter>
parameter. The line is broken using the (optional)
<parameter>break</parameter> parameter.
</para>
<para>
<function>wordwrap</function> will automatically wrap at column
75 and break using '\n' (newline) if <parameter>width</parameter>
or <parameter>break</parameter> are not given.
</para>
<para>
If the <parameter>cut</parameter> is set to 1, the string is
always wrapped at the specified width. So if you have a word
that is larger than the given width, it is broken appart.
(See second example).
<note>
<para>
The <parameter>cut</parameter> parameter was added in PHP 4.0.3.
</para>
</note>
</para>
<para>
<example>
<title>Ukázka <function>wordwrap</function></title>
<programlisting role="php">
$text = "The quick brown fox jumped over the lazy dog.";
$newtext = wordwrap( $text, 20 );
echo "$newtext\n";
</programlisting>
</example>
</para>
<para>
This example would display:
</para>
<para>
<informalexample>
<programlisting>
The quick brown fox
jumped over the lazy dog.
</programlisting>
</informalexample>
</para>
<para>
<example>
<title>Ukázka <function>wordwrap</function></title>
<programlisting role="php">
$text = "A very long woooooooooooord.";
$newtext = wordwrap( $text, 8, "\n", 1);
echo "$newtext\n";
</programlisting>
</example>
</para>
<para>
This example would display:
</para>
<para>
<informalexample>
<programlisting>
A very
long
wooooooo
ooooord.
</programlisting>
</informalexample>
</para>
<para>
Viz také <function>nl2br</function>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/cs/functions/url.xml
+++ phpdoc/cs/functions/url.xml
<reference id="ref.url">
<title>URL Functions</title>
<titleabbrev>URLs</titleabbrev>
<refentry id="function.base64-decode">
<refnamediv>
<refname>base64_decode</refname>
<refpurpose>Dekódovat data kódovaná pomocí MIME base64</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>base64_decode</function></funcdef>
<paramdef>string <parameter>encoded_data</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Base64_decode</function> dekóduje
<parameter>encoded_data</parameter> a vrátí původní data. Vrácená
data mohou být binární
</para>
<para>
Viz také: <function>base64_encode</function>, RFC 2045 sekce 6.8.
</para>
</refsect1>
</refentry>
<refentry id="function.base64-encode">
<refnamediv>
<refname>base64_encode</refname>
<refpurpose>Zakódovat data pomocí MIME base64</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>base64_encode</function></funcdef>
<paramdef>string <parameter>data</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Base64_encode</function> vrátí
<parameter>data</parameter> zakódovaný pomocí base64. Toto kódování
je navrženo tak, aby umožnilo binárním datům přežít transport přenosovými
vrstvami, které nejsou osmibitové, jako jsou například těla emailů.
</para>
<para>
Data kódovaná pomocí base64 zabírají o zhruba 33% prostoru více než původní
data.
</para>
<para>
Viz také:
<function>base64_decode</function>,
<function>chunk_split</function>,
RFC-2045 sekce 6.8.
</para>
</refsect1>
</refentry>
<refentry id="function.parse-url">
<refnamediv>
<refname>parse_url</refname>
<refpurpose>Rozebrat URL a vrátit její komponenty</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>parse_url</function></funcdef>
<paramdef>string <parameter>url</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Tato funkce vrátí asociativní pole všech komponent URL přítomnych v
<parameter>url</parameter>. Ty mohou být: "scheme", "host", "port",
"user", "pass", "path", "query" a "fragment".
</para>
</refsect1>
</refentry>
<refentry id="function.rawurldecode">
<refnamediv>
<refname>rawurldecode</refname>
<refpurpose>Dekódovat URL-kódovaný řetězec</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>rawurldecode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec, ve kterém sekvence znaku procent (<literal>%</literal>)
následových dvěma šestnáctkovými číslicemi byly nahrazeny prostými znaky.
Například řetězec <screen>foo%20bar%40baz</screen> dekóduje na
<screen>foo bar@baz</screen>.
</para>
<simpara>
Viz také: <function>rawurlencode</function>,
<function>urldecode</function>,
<function>urlencode</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.rawurlencode">
<refnamediv>
<refname>rawurlencode</refname>
<refpurpose>URL-kódovat podle RFC1738</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>rawurlencode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec, ve kterém byly všechny nealfanumerické znaky kromě
<screen>-_.</screen> nahrazeny znakem procent (<literal>%</literal>)
následovaným dvěma šestnáctkovými číslicemi. To je kódování popsané
v RFC1738 na ochranu prostých znaků před interpretací jako zvláštní
oddělovače v URL a na ochranu URL před komolením přenosovými systémy
se znakovými konvencemi (jako jsou některé emailové systémy). Například,
pokud chcete k FTP URL přidat heslo:
<example>
<title>Příklad <function>rawurlencode</function> č. 1</title>
<programlisting role="php">
echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'),
'@ftp.my.com/x.txt">';
</programlisting>
</example>
Nebo, pokud předáváte informace v komponentě URL obsahující info o cestě:
<example>
<title>Příklad <function>rawurlencode</function> č. 2</title>
<programlisting role="php">
echo '<A HREF="http://x.com/department_list_script/',
rawurlencode ('sales and marketing/Miami'), '">';
</programlisting>
</example>
</para>
<simpara>
Viz také: <function>rawurldecode</function>,
<function>urldecode</function>,
<function>urlencode</function>.
</simpara>
</refsect1>
</refentry>
<refentry id="function.urldecode">
<refnamediv>
<refname>urldecode</refname>
<refpurpose>Dekódovat URL-kódovaný řetězec</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>urldecode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Dekóduje všechny <literal>%<replaceable>##</replaceable></literal>
kódy v daném řetězci. Vrátí dekódovaný řetězec.
<example>
<title>Příklad <function>urldecode</function></title>
<programlisting role="php">
$a = split ('&', $querystring);
$i = 0;
while ($i < count ($a)) {
$b = split ('=', $a [$i]);
echo 'Hodnota argumentu ', htmlspecialchars (urldecode ($b [0])),
' je ', htmlspecialchars (urldecode ($b [1])), "<BR>";
$i++;
}
</programlisting>
</example>
</para>
<para>
Viz také <function>urlencode</function>,
<function>rawurlencode</function>,
<function>rawurldecode</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.urlencode">
<refnamediv>
<refname>urlencode</refname>
<refpurpose>URL-kódovat řetězec</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>urlencode</function></funcdef>
<paramdef>string <parameter>str</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrátí řetězec, ve kterém byly všechny nealfanumerické znaky kromě
<literal>-_.</literal> nahrazeny znakem procent (<literal>%</literal>)
následovaným dvěma šestnácktovými číslicemi a mezery kódovány jako
znaky plus (<literal>+</literal>). Kódování je stejné jako u dat
postovaných z WWW formuláře, tj. stejně jako u
<literal>application/x-www-form-urlencoded</literal> typu.
To se liší od RFC1738 kódování (viz
<function>rawurlencode</function>) v tom, že z historických důvodů
se mezery kódují jako znaky plus (<literal>+</literal>). Tato funkce
je vhodná při kódování řetězce, který se má použít jako query část URL
jako příhodný způsob předání proměnných na další stránku:
<example>
<title>Příklad <function>Urlencode</function></title>
<programlisting role="php">
echo '<A HREF="mycgi?foo=', urlencode ($userinput), '">';
</programlisting>
</example>
</para>
<para> Poznámka: pozor při předávání proměnných, které by mohly
odpovídat HTML entitám. Věci jako &amp, &copy a &pound
browser analyzuje a místo požadovaného jména proměnné použije
odpovídající entitu. To je zřejmý problém, na který W3C upozorňuje už
léta. Příručka je tady: <ulink url="&url.argsep;">&url.argsep;</ulink>
PHP podporuje změnu oddělovače argumentů na středník doporučovaný W3C
skrze .ini direktivu arg_separator. Bohužel, většina uživatelských programů
neposílá data z formulářů v tomto formátu. Přenositelnější formou je
použít jako oddělovač &amp; místo &. Na to nemusíte měnit
arg_separator. Nechte ho na &, ale kódujte URL pomocí
<function>htmlentities</function> (urlencode($data)).
<example>
<title>Příklad na <function>urlencode/htmlentities</function></title>
<programlisting role="php">
echo '<A HREF="mycgi?foo=', htmlentities (urlencode ($userinput) ), '">';
</programlisting>
</example>
</para>
<para>
Viz také <function>urldecode</function>,
<function>htmlentities</function>,
<function>rawurldecode</function>,
<function>rawurlencode</function>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
