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:
-->
