<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.strings">
  <title>Funkce pro prci s etzci</title>
  <titleabbrev>etzce</titleabbrev>

  <partintro>
   <simpara>
   Vechny tyto funkce rznmi zpsoby pracuj s etzci. Nkter
   specializovanj funkce najdete v sekcch regulrnch vraz a manipulace s
   URL.
   </simpara>

   <para>
   Informace o chovn etzc, zvlt v souvislosti s pouitm jednoduchch
   uvozovek, dvojitch uvozovek a escape sekvenc viz poloku
   <link linkend="language.types.string">etzce</link> v sekci
   <link linkend="language.types">Typy</link> tohoto manulu.
   </para>
  </partintro>

  <refentry id="function.addcslashes">
   <refnamediv>
    <refname>addcslashes</refname>
    <refpurpose>Opatit etzec lomtky ve stylu jazyka C</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>addcslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>charlist</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac etzec se zptnmi lomtky ped znaky, kter jsou vypsny v argumentu
    <parameter>charlist</parameter>. XXX Excapes
     <literal>\n</literal>, <literal>\r</literal> atd. podobn jako v C,
     znaky s ASCII kdem nim ne 32 a vym ne 126 se pevedou na
     osmikovou reprezentaci. V <parameter>charlist</parameter> mete udat
     rozsah, nap. "\0..\37", co by XXX escapovao vechny znaky s ASCII kdem
     mezi 0 a 31.
     <example>
      <title>Ukzka <function>addcslashes</function></title>
      <programlisting role="php">
$escaped = addcslashes ($not_escaped, "\0..\37!@\177..\377");
      </programlisting>
     </example>
     <note>
      <simpara>
       Pidno 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>Opatit etzec lomtky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>addslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac etzec se zptnmi lomtky ped znaky, kter potebuj XXX be quoted
    v databzovch dotazech apod. Tyto znaky jsou jednoduch uvozovka
    (<literal>'</literal>), dvojit uvozovka (<literal>"</literal>), zptn
    lomtko (<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>Pevst binrn data na hexadecimln reprezentaci</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>bin2hex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac ASCII etec obsahujc hexadecimln reprezentaci
    <parameter>str</parameter>. Konverze probh po bytech, horn slabika
    prvn.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chop">
   <refnamediv>
    <refname>chop</refname>
    <refpurpose>Odstranit netisknuteln znaky z konce etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>chop</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac pedan etzec bez netisknutelnch znak (v. konc dku) na konci.
     <example>
      <title>Ukzka <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 etzce odstrauje 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>Vrtit urit znak</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>chr</methodname>
      <methodparam><type>int</type><parameter>ascii</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac etzec jednoho znaku obsahujc znak specifikovan argumentem
    <parameter>ascii</parameter>.
     <example>
      <title>Ukzka <function>chr</function></title>
      <programlisting role="php">
$str .= chr (27); /* pid escape znak na konec $str */

/* Toto je vtinou uitenj */

$str = sprintf ("etzec koni escape znakem: %c", 27);
      </programlisting>
     </example>
     Tato funkce se dopluje s funkc <function>ord</function>.
     Viz tak: <function>sprintf</function> s formtovacm etzcem
     <literal>%c</literal>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chunk-split">
   <refnamediv>
    <refname>chunk_split</refname>
    <refpurpose>Rozdlit etzec na men sti</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>chunk_split</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>chunklen</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>end</parameter></methodparam>
     </methodsynopsis>
    <para>
    D se pout k rozdlen etzce na men sti, co me bt uiten nap.
    pi uvdn vstupu z
    <link linkend="function.base64-encode">base64_encode</link> do souladu se
    smantikou RFC 2045. Kadch <parameter>chunklen</parameter> (defaultn 76)
    znak vlo etzec <parameter>end</parameter> (defaultn "\r\n"). Vrac
    nov etzec, pvodn zstv beze zmny.
     <example>
      <title>Ukzka <function>chunk_split</function></title>
      <programlisting role="php">
# naformtuje $data s pouitm RFC 2045 smantiky

$new_string = chunk_split (base64_encode($data));
      </programlisting>
     </example>
     Tato funkce je vrazn rychlej ne <function>ereg_replace</function>.
     <note>
      <para>
      Tato funkce byla pidna v 3.0.6.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.convert-cyr-string">
   <refnamediv>
    <refname>convert_cyr_string</refname>
    <refpurpose>
    Pevst z jedn znakov sady Azbuky do jin
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>convert_cyr_string</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>from</parameter></methodparam>
      <methodparam><type>string</type><parameter>to</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce pevede dan etzec z jedn znakov sady azbuky do jin.
    Argumenty <parameter>from</parameter> a <parameter>to</parameter> jsou
    jednotliv znaky, kter pedstavuj zdrojovou a clovou 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>Vrtit informace o znacch pouitch v etzci</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>count_chars</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type></type><parameter>
        mode
       </parameter></methodparam>
     </methodsynopsis>
    <para>
    Pot poet vskyt vech byte hodnot (0..255) v
    <parameter>string</parameter> a vrac je rznmi zpsoby.
    Voliteln argument <parameter>Mode</parameter> m defaultn hodnotu 0.
    V zvislosti na <parameter>mode</parameter> vrac
     <function>count_chars</function> jednu z nsledujcch monost:
     <itemizedlist>
      <listitem>
       <simpara>
	0 - pole s kli tvoenmi byte hodnotami a hodnotami tvoenmi etnost
	kadho bytu.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	1 - stejn jako 0, ale vrac pouze byte hodnoty s etnost vy ne
	nula.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	2 - stejn jako 0, ale vrac pouze byte hodnoty s etnost rovnou nule.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	3 - vrac etzec obsahujc vechny pouit byte hodnoty.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	4 - vrac etzec obsahujc vechny nepouit byte hodnoty.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <note>
     <para>
      Tato funkce byla pidna v PHP 4.0.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.crc32">
   <refnamediv>
    <refname>crc32</refname>
    <refpurpose>Spotat crc32 XXX polynomial etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>crc32</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Generuje 32bitov XXX polynomial kontrolnho soutu pro
    <parameter>str</parameter>. Obvykle se pouv ke kontrole integrity
    penench dat.
    </para>
	<para>
	Viz tak: <function>md5</function>.
	</para>
   </refsect1>
  </refentry>

  <refentry id="function.crypt">
   <refnamediv>
    <refname>crypt</refname>
    <refpurpose>Zaifrovat etzec algoritmem DES</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>crypt</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>salt</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>crypt</function> zaifruje etzec pomoc standardn Unixovsk
     ifrovac metody <abbrev>DES</abbrev>. Argumenty jsou etzec k zaifrovn
     a voliteln dvouznakov XXX salt, na kterm se ifrovn zalo.
     Vce informac viz Unixovsk man strnka va crypt funkce.
    </para>
    <simpara>
    Pokud nen poskytnut XXX salt argument, PHP jej nhodn vygeneruje.
    </simpara>
    <simpara>
    Nkter operan systmy podporuj vce typ ifrovn. Nkdy se standardn
    DES ifrovn nahrazuje ifrovacm algoritmem zaloenm na MD5. Typ
    ifrovn se zvol podle XXX salt argumentu. Pi instalaci PHP zjist
    schopnosti funkce crypt a XXX bude pijmat XXX salt pro jin typy
    ifrovn. Pi absenci XXX salt PHP defaultn automaticky vygeneruje
    standardn dvouznakov DES XXX salt, nicmn pokud je defaultnm typem
    ifrovn na danm systmu MD5, vygeneruje nhodn XXX salt kompatibiln s
    MD5. PHP vytv konstantu CRYPT_SALT_LENGTH, kter vm ekne, jestli se na
    v systm hod bn dvouznakov XXX salt nebo del dvanctiznakov MD5
    XXX salt.
    </simpara>
    <simpara>
    Pokud pouvte poskytnut XXX salt, mli byste si bt vdomi toho, e se
    generuje jednou. Pokud tuto funkci volte rekurzivn, me to mt inek na
    vzhled, a, do urit mry, bezpenost.
    </simpara>
    <simpara>
    U standardnho DES ifrovn <function>crypt</function> pid XXX salt jako
    prvn dva znaky vstupu.
    </simpara>
    <simpara>
    Na systmech, kde funkce <function>crypt()</function> podporuje vce typ
    ifrovn se nsledujc konstanty nastav na 0 nebo 1 podle toho, jestli
    je dan typ dostupn:
    </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       CRYPT_STD_DES - Standardn DES ifrovn s dvouznakovm XXX SALT
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_EXT_DES - Rozen DES ifrovn s devtiznakovm XXX SALT
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_MD5 - MD5 ifrovn s dvanctiznakovm XXX SALT zanajcm $1$
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       CRYPT_BLOWFISH - Rozen DES ifrovn s estnctiznakovm XXX SALT
       zanajcm $2$
      </simpara>
     </listitem>
    </itemizedlist>
    <simpara>
    Neexistuje dn decrypt funkce, protoe <function>crypt</function> pouv
    jednosmrn algoritmus.
    </simpara>
    <simpara>
    	Viz tak: <function>md5</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.echo">
   <refnamediv>
    <refname>echo</refname>
    <refpurpose>Vytisknout jeden nebo vce etzc</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <methodname>echo</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>argn...</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Outputs all parameters.
    </simpara>
    <para>
     <function>echo</function> vlastn nen funkce (je to jazykov konstrukt),
     take u nj nemuste pouvat zvorky.
     <example>
      <title>Ukzka <function>echo</function></title>
      <programlisting role="php">
echo "Hello World";

echo "Toto zabr
nkolik dk. Konce dk se
vytisknou tak";

echo "Toto zabr\nnkolik dk. Konce dk se\nvytisknou tak.";
      </programlisting>
     </example>
    </para>
    <note>
     <para>
     Pokud chcete echo pedat vce argument, argumenty dokonce uzvorkovat
     nesmte.
     </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>Rozdlit etzec na jinm etzci</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>explode</methodname>
      <methodparam><type>string</type><parameter>separator</parameter></methodparam>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac pole etzc, z nich kad je st argumentu
    <parameter>string</parameter> vznikl jeho rozdlenm na hranicch
    tvoench etzcem <parameter>delim</parameter>.
    Pokud je definovn <parameter>limit</parameter>, vrcen pole bude obsahovat
    maximln <parameter>limit</parameter> prvk, a posledn prvek bude
    obsahovat cel zbytek <parameter>string</parameter>.
    </para>
    <note>
     <para>
      Argument <parameter>limit</parameter> byl pidn v PHP 4.0.1
     </para>
    </note>
    <para>
     <example>
      <title>Ukzka <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> me z historickch dvod pijmat
     argumenty v obou monch poadch, <function>explode</function> neme.
     Muste se ujistit, e je argument <parameter>separator</parameter> ped
     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>
     Vrtit pekladovou tabulku pouvanou v
     <function>htmlspecialchars</function> a
     <function>htmlentities</function>
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>get_html_translation_table</methodname>
      <methodparam><type>int</type><parameter>table</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>get_html_translation_table</function> vrac pekladovou tabulku,
     kter se intern pouv ve funkcch <function>htmlspecialchars</function>
     a <function>htmlentities</function>. Dv nov konstanty
     (<parameter>HTML_ENTITIES</parameter>,
     <parameter>HTML_SPECIALCHARS</parameter>) vm umouj urit, kterou
     tabulku chcete. A stejn jako u funkc
     <function>htmlspecialchars</function> a
     <function>htmlentities</function> mete ppadn urit
     <parameter>quote_style</parameter> se kterm pracujete. Defaultn hodnota je
     ENT_COMPAT md. Viz popis tchto md u
     <function>htmlspecialchars</function>.
     <example>
      <title>Ukzka na pekladovou tabulku</title>
      <programlisting role="php">
$trans = get_html_translation_table (HTML_ENTITIES);
$str = "Hallo &amp; &lt;Frau&gt; &amp; Kr&auml;mer";
$encoded = strtr ($str, $trans);
      </programlisting>
     </example>
     Promnn <literal>$encoded</literal> te obsahuje: "Hallo
     &amp;<sgmltag>amp</sgmltag>;
     &amp;<sgmltag>lt</sgmltag>;Frau&amp;<sgmltag>gt</sgmltag>;
     &amp;<sgmltag>amp</sgmltag>; Kr&amp;<sgmltag>auml</sgmltag>;mer".
    </para>
    <para>
    Skvl je, e pomoc <function>array_flip</function> mete zmnit smr
    pekladu.
     <informalexample>
      <programlisting role="php">
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
      </programlisting>
     </informalexample>
      Obsahem <literal>$original</literal> je: "Hallo &amp;
      &lt;Frau> &amp; Kr&auml;mer".
     <note>
      <para>
       Tato funkce byla pidna 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>
    Zskat hodnoty content atribut vech meta tag v souboru a vrtit pole
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>get_meta_tags</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
     </methodsynopsis>
    <para>
    Oteve <parameter>filename</parameter>, pete ho po dcch, a vyhled
    &lt;meta&gt; tagy ve tvaru
     <example>
      <title>Ukzka na Meta Tagy</title>
      <programlisting role="html">
&lt;meta name="author" content="name">
&lt;meta name="tags" content="php3 documentation">
&lt;/head> &lt;!-- tady ten skon -->
      </programlisting>
     </example>
     (vnujte pozornost koncm dk - PHP pouv ke ten vstupu nativn
     funkci, take Macovsk soubor na Unixu nebude fungovat).
    </para>
    <para>
    Hodnota atributu name se ve vrcenm poli stv klem, hodnota atributu
    content hodnotou tohoto pole, take ho mete snadno projt nebo zskat
    jednotliv hodnoty pomoc snandardnch funkc pro prci s poli.
    Zvltn znaky v hodnot atributu name jsou nahrazeny znakem '_', zbytek
    se pevede na mal psmena.
    </para>
    <para>
    Pokud je <parameter>use_include_path</parameter> rovno 1, PHP se pokus
    otevt soubor v standardn include cest.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrev">
   <refnamediv>
    <refname>hebrev</refname>
    <refpurpose>
    Pevst logick Hebrejsk text na vizuln text
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrev</methodname>
      <methodparam><type>string</type><parameter>hebrew_text</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_chars_per_line</parameter></methodparam>
     </methodsynopsis>
    <para>
    Voliteln argument <parameter>max_chars_per_line</parameter> indikuje
    maximln poet znak na dek vstupu. Funkce se sna nerozdlovat slova.
    </para>
	<para>
     Viz tak: <function>hebrevc</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.hebrevc">
   <refnamediv>
    <refname>hebrevc</refname>
    <refpurpose>
    Pevst logick Hebrejsk text na vizuln text s konverz konc dk
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>hebrevc</methodname>
      <methodparam><type>string</type><parameter>hebrew_text</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>max_chars_per_line</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce se podob <function>hebrev</function> s tm rozdlem, e pevd
    konce dk (\n) na "&lt;br&gt;\n". Voliteln argument
    <parameter>max_chars_per_line</parameter> indikuje maximln poet znak na
    dek vstupu. Funkce se sna nerozdlovat slova.
    </para>
	<para>
     Viz tak: <function>hebrev</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.htmlentities">
   <refnamediv>
    <refname>htmlentities</refname>
    <refpurpose>Pevst vechny pouiteln znaky na HTML entity</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlentities</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce je ve vem shodn s <function>htmlspecialchars</function> krom
    toho, e na HTML entity se pevedou vechny znaky, kter maj odpovdajc
    entity. Stejn jako <function>htmlspecialchars</function> pijm voliteln
    druh argument, kter indikuje, co se m stt s jednoduchmi a dvojitmi
    uvozovkami. <constant>ENT_COMPAT</constant> (default) pevede pouze dvojit
    uvozovky, <constant>ENT_QUOTES</constant> pevede dvojit i jednoduch
    uvozovky, a <constant>ENT_NOQUOTES</constant> ponech jednoduch i dvojit
    uvozovky bez konverze.
    </para>
    <para>
    V souasnosti se pouv znakov sada ISO-8859-1. Voliteln druh argument
    byl pidn 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>Pevst zvltn znaky na HTML entity</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>htmlspecialchars</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam>
     </methodsynopsis>
    <para>
    Nkter znaky maj v HTML zvltn vznam, a pokud si maj zachovat bn
    vznam, mly by bt reprezentovny HTML entitami. Tato funkce vrac etzec,
    ve kterm dolo k nkterm z tchto konverz; provdj se ty peklady,
    kter jsou v kadodennm programovn pro web nejuitenj. Pokud
    poadujete peklad vech znakovch entit HTML, pouijte
    <function>htmlentities</function>.
    </para>
    <simpara>
    Tato funkce je uiten, pokud se chcete chrnit ped ppadnm vskytem
    HTML v textu dodanm uivateli, napklad u aplikac typu kniha host nebo
    diskusn skupina. Voliteln druh argument, quote_style, uruje, co se m
    stt s jednoduchmi a dvojitmi uvozovkami. Defaultn md, ENT_COMPAT, je
    zptn kompatibiln md, konvertuje pouze dvojit uvozovky a jednoduch
    uvozovky ponechv nepeloen. Pokud zadte ENT_QUOTES, pelo se
    jednoduch i dvojit uvozovky, a pokud zadte ENT_NOQUOTES, oba druhy
    zstanou bez pekladu.
    </simpara>
    <para>
    Dochz k tmto pekladm:
     <itemizedlist>
      <listitem>
       <simpara>
        '&amp;' (ampersand) se stv '&amp;amp;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&quot;' (dvojit uvozovka) se stv '&amp;quot;' when ENT_NOQUOTES is not set.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&#039;' (jednoduch uvozovka) se stv '&amp;#039;' only when ENT_QUOTES is set.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&lt;' (men ne) se stv '&amp;lt;'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        '&gt;' (vt ne) se stv '&amp;gt;'
       </simpara>
      </listitem>
     </itemizedlist>
     <example>
      <title>Ukzka <function>htmlspecialchars</function></title>
      <programlisting role="php">
$new = htmlspecialchars("&lt;a href='test'&gt;Test&lt;/a&gt;", ENT_QUOTES);
      </programlisting>
     </example>
    </para>
    <para>
    Poznmka: tato funkce provd pouze ve uveden peklady. Kompletn peklad
    entit viz <function>htmlentities</function>.
    Voliteln druh argument byl pidn 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 etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>implode</methodname>
      <methodparam><type>string</type><parameter>glue</parameter></methodparam>
      <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac etzec obsahujc etzcovou reprezentaci vech prvk pole v pvodnm
    poad s etzcem <parameter>glue</parameter> mezi kadmi dvma prvky.
     <example>
      <title>Ukzka <function>implode</function></title>
      <programlisting role="php">
$colon_separated = implode (":", $array);
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      <function>implode</function> me z historickch dvod pijmat
     argumenty v obou monch poadch. Kvli konzistenci s
     <function>explode</function> se ale doporuuje pouvat dokumentovan
     poad 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 etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>join</methodname>
      <methodparam><type>string</type><parameter>glue</parameter></methodparam>
      <methodparam><type>array</type><parameter>pieces</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Funkce <function>join</function> je alias k <function>implode</function>,
     a je ve vech 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>
    Spotat XXX Levenshteinovu vzdlenost mezi dvma etzci
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_ins</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_rep</parameter></methodparam>
      <methodparam><type>int</type><parameter>cost_del</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis>
      <type>int</type><methodname>levenshtein</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>function</type><parameter>cost</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce vrac XXX Levenshtein-Distance mezi pedanmi etzci nebo -1,
    pokud dlka jednoho z pedanch etzc peshne omezen 255 znak (255 by
    mlo bt pro bn porovnn vc ne dost, a nikdo se zdravm rozumem nebude
    v PHP dlat genetickou analzu).
    </para>
    <para>
    Levenshteinova vzdlenost se definuje jako minimln poet znaku, kter
    muste nahradit, vloit nebo smazat, abyste zmnili
    <parameter>str1</parameter> na <parameter>str2</parameter>.
    Sloitost tohoto algoritmu je <literal>O(m*n)</literal>, kde
    <literal>n</literal> a <literal>m</literal> jsou dlky
    <parameter>str1</parameter> a <parameter>str2</parameter> (celkem slun
    v porovnn 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 etzce jako
    argumenty a spot poet vloen, nahrazen a smazn nutnch k
    transformaci <parameter>str1</parameter> na <parameter>str2</parameter>.
    </para>
    <para>
    Druh varianta pijme ti dal argumenty, kter definuj nklady na operace
    vloen, nahrazeni a smazn. Tato varianta je veobecnj a
    pizpsobivj ne varianta prvn, ale ne tak vkonn.
    </para>
    <para>
    Tet varianta (zatm neimplementovan) bude nejveobecnj a
    nejpizpsobivj, ale tak nejpomalej alternativou. Bude volat
    uivatelskou funkci, kter ur nklady na vechny mon operace.
    </para>
    <para>
    Tato uivatelsk funkce se bude volat s nsledujcmi argumenty:
     <itemizedlist>
      <listitem>
       <simpara>
		 	  operatce, kter se m provst: 'I', 'R' or 'D'
       </simpara>
      </listitem>
      <listitem>
       <simpara>
		 	  pvodn znak v etzci 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
			  pvodn znak v etzci 2
       </simpara>
      </listitem>
      <listitem>
       <simpara>
			  pozice v etzci 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
			  pozice v etzci 2
       </simpara>
      </listitem>
      <listitem>
       <simpara>
			  znaky zbvajc v etzci 1
       </simpara>
      </listitem>
      <listitem>
       <simpara>
			  znaky zbvajc v etzci 2
       </simpara>
      </listitem>
     </itemizedlist>
    Tato uivatelsk funkce mus vrtit kladn cel slo vyslujc nklady
    na tuto konkrtn operaci, ale me se rozhodnout pout pouze nkter
    z pijatch argument.
    </para>
    <para>
    Tento pstup nabz monost zohlednit dleitost uritch symbol (znak)
    a/nebo rozdly mezi nimi, i dokonce kontext, ve kterm se vyskytuj pi
    urovn nklad na vloen, zmnu nebo smazn, ale za cenu ztrty vech
    optimalizac vyuit CPU registru a XXX cache misses, kter byly zapracovny
    do pedchozch 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 zatku etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>ltrim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Tato funkce ozne netisknuteln znaky ze zatku etzce a vrac oznut
    etzec. Netisknuteln znaky, kter se v souasnosti odstrauj, 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>Spotat MD5 XXX hash etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>md5</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Spot MD5 XXX hash argumentu <parameter>str</parameter> pomoc
     <ulink url="&url.rfc;rfc1321.html">MD5 Message-Digest Algoritmu spolenosti
     RSA Data Security, Inc.</ulink>.
    </para>
	<para>
	Viz tak: <function>crc32</function>.
	</para>
   </refsect1>
  </refentry>

  <refentry id="function.metaphone">
   <refnamediv>
    <refname>metaphone</refname>
    <refpurpose>Spotat metaphone kl etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>metaphone</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Spot metaphone kl argumentu <parameter>str</parameter>.
    </para>
    <para>
    <function>metaphone</function>, podobn jako <function>soundex</function>,
    vytvo stejn kl pro podobn znjc slova. Je pesnj ne
    <function>soundex</function>, protoe zn zkladn pravidla anglick
    vslovnosti. Metaphone kle maj promnlivou dlku.
    </para>
    <para>
     Metaphone vyvinul Lawrence Philips
     &lt;lphilips@verity.com&gt;. Je popsno v ["Practical
     Algorithms for Programmers", Binstock &amp; Rex, Addison Wesley,
     1995].
     <note>
      <para>
       Tato funkce byla pidna v PHP 4.0.
      </para>
     </note>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.nl2br">
   <refnamediv>
    <refname>nl2br</refname>
    <refpurpose>Pevede konce dk na HTML konce dk</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>nl2br</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac <parameter>string</parameter>, ve kterm je ped kad konec dku
    vloen tag '&lt;BR&gt;'.
    </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>Vrtit ASCII hodnotu znaku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>ord</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac ASCII hodnotu prvnho znaku v <parameter>string</parameter>. Tato
    funkce dopluje <function>chr</function>.
     <example>
      <title>Ukzka <function>ord</function></title>
      <programlisting role="php">
if (ord ($str) == 10) {
    echo "Prvnm 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>Roparsovat etzec do promnnch</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>parse_str</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>arr</parameter></methodparam>
     </methodsynopsis>
    <para>
    Rozparsuje etzec jako kdyby to byl querystring pedan v URL a definuje
    pslun promnn v souasnm scope. Pokud je pedn druh argument
    <parameter>arr</parameter>, promnn se msto toho ulo do tto promnn
    jako pole.
    </para>
    <para>
     <example>
      <title>Using <function>parse_str</function></title>
      <programlisting role="php">
$str = "first=value&amp;second[]=this+works&amp;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 etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <methodname>print</methodname>
      <methodparam><type>string</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <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 formtovan etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>printf</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
    Vytvo vtup podle argumentu <parameter>format</parameter>, kter je popsn
    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>
     Pevst quoted-printable etzec na osmibitov etzec
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>quoted_printable_decode</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <simpara>
    Tato funkce vrac osmibitov binrn etzec odpovdajc dekdovanmu
    quoted printable etzci. Tato funkce je podobn
    <function>imap_qprint</function> s tou vjimkou, e tato funkce nevyaduje
    IMAP modul.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.quotemeta">
   <refnamediv>
    <refname>quotemeta</refname>
    <refpurpose>Opatit lomtky metaznaky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>quotemeta</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac verzi <parameter>str</parameter> se zptnm lomtkem ped vemi vskyty
    nsledujcch 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 etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>rtrim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
    Vrac pedan etzec bez netisknutelnch znak (v. konc dku) na konci.
    Toto je alias k <function>chop</function>.
     <example>
      <title>Ukzka <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>Rozparsovat vstupn etzec podle formtu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>sscanf</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Funkce <function>sscanf</function> je vstupnm analogem
	 <function>printf</function>. <function>sscanf</function> te etzec
	 <parameter>str</parameter> a interpretuje ho podle formtu
	 <parameter>format</parameter>. Pokud jsou j pedny pouze dva argumenty,
	 vrac rozparsovan hodnoty v poli.
	 <example>
	 <title>Ukzka <function>sscanf</function></title>
	 <programlisting role="php">
// zjitn sriovho sla
$serial = sscanf("SN/2350001","SN/%d");
// a data vroby
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate,"%s %d %d");
echo "Zbo $serial bylo vyrobeno: $year-".substr($month,0,3)."-$day\n";
	 </programlisting>
	 </example>
	 Pokud jsou j pedny voliteln argumenty, vrac tato funkce poet
	 piazench hodnot. Voliteln argumenty mus bt pedny odkazem.
 <example>
	 <title>Ukzka <function>sscanf</function> - pouit volitelnch argument</title>
	 <programlisting role="php">
// zjistit informace o autorovi a vygenerovat DocBook zznam
$auth = "24\tLewis Carroll";
$n = sscanf($auth,"%d\t%s %s", &amp;$id, &amp;$first, &amp;$last);
echo "&lt;author id='$id'&gt;
	&lt;firstname&gt;$first&lt;/firstname&gt;
	&lt;surname&gt;$last&lt;/surname&gt;
&lt;/author&gt;\n";
	 </programlisting>
	 </example>
    </para>
    <para>
     Viz tak: <function>fscanf</function>,
     <function>printf</function> a
     <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.setlocale">
   <refnamediv>
    <refname>setlocale</refname>
    <refpurpose>Set locale information</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>setlocale</methodname>
      <methodparam><type>string</type><parameter>category</parameter></methodparam>
      <methodparam><type>string</type><parameter>locale</parameter></methodparam>
     </methodsynopsis>
    <para>
     <parameter>category</parameter> je etzec urujc kategorii funkc
     ovlivnnch nastavenm locale:
     <itemizedlist>
      <listitem>
       <simpara>
	LC_ALL pro vechny ne uveden kategorie
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_COLLATE pro porovnvn etzc - v PHP v souasnosti neimplementovno
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_CTYPE pro klasifikaci a konverzi znak, nap.
	<function>strtoupper</function>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_MONETARY pro localeconv() - v PHP v souasnosti neimplementovno
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_NUMERIC pro oddlova desetinnch mst
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	LC_TIME pro formtovn data a asu pomoc <function>strftime</function>
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Pokud je <parameter>locale</parameter> przn etzec
     (<literal>""</literal>), nzvy locale se nastav na hodnoty systmovch
     promnnch se stejnmi jmny jako maj ve uveden kategorie, nebo z "LANG".
    </para>
    <para>
     Pokud je <parameter>locale</parameter> nula nebo <literal>"0"</literal>,
     locale se nezmn, pouze se vrt souasn hodnota.
    </para>
    <para>
     <function>setlocale</function> vrac nov aktuln locale nebo
     &false;, pokud na dotyn platform nen funkcionalita
     locale implementovna, zadan locale neexistuje, nebo je nzev kategorie
     neplatn. Neplatn nzev kategorie tak vyvol varovn.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.similar-text">
   <refnamediv>
    <refname>similar_text</refname>
    <refpurpose>Spotat podobnost dvou etzc</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>similar_text</methodname>
      <methodparam><type>string</type><parameter>first</parameter></methodparam>
      <methodparam><type>string</type><parameter>second</parameter></methodparam>
      <methodparam choice="opt"><type>double</type><parameter>percent</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>similar_text</function> spot podobnost dvou etzc podle
     Oliver [1993]. Pozn.: Tato implementace nepouv stack jako v Oliverov
     pseudokdu, nbr rekurzivn voln, co me i nemus cel proces
     zrychlit. Komplexita tohoto algoritmu je O(N**3) kde N je dlka nejdelho
     etzce.
    </para>
    <para>
     Pokud je <function>similar_text</function> pedn tet argument (odkazem),
     spot tato funkce podobnost v procentech. Vrac poet znak shodnch
     v obou etzcch.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.soundex">
   <refnamediv>
    <refname>soundex</refname>
    <refpurpose>Spotat soundex kl etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>soundex</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Spot soundex kl <parameter>str</parameter>.
    </para>
    <para>
     Soundex kle maj tu vlastnost, e slova vyslovovan podobn produkuj
     shodn soundex kle, a daj se proto vyut ke zjednoduen hledn v
     databzch, kde znte vslovnost, ale ne hlskovn. Tato funkce vrac
     etzec dlouh 4 znaky zanajc psmenem.
    </para>
    <para>
     Tato konkrtn soundex funkce je popsna Donaldem Knuthem v "The Art Of
     Computer Programming, vol. 3: Sorting And Searching", Addison-Wesley
     (1973), pp. 391-392.
    </para>
    <para>
     <example>
      <title>Soundex ukzky</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>Vrtit formtovan etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>sprintf</methodname>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>mixed</type><parameter>args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Vrac etzec vytvoen podle formtovacho etzce
     <parameter>format</parameter>.
    </simpara>
    <simpara>
     Formtovac etzec se skld z nula nebo vce direktiv:
     bnch znak (krom <literal>%</literal>), kter se pmo kopruj do
     vsledku, a <emphasis>pevodnch specifikac</emphasis>, z nich kad
     pijm jeden argument. Toto plat pro <function>sprintf</function> i
     <function>printf</function>.
    </simpara>
    <para>
     Kad pevodn specifikace se skld ze znaku procenta
     (<literal>%</literal>), nsledovanho jednm nebo vce z tchto znak, v
     tomto poad:
     <orderedlist>
      <listitem>
       <simpara>
        Voliteln <emphasis>padding specifier</emphasis>, kter uruje, jak
        znak se pouije na doplnn vsledku na sprvnou dlku etzce. Me to
        bt mezera nebo <literal>0</literal> (psmeno nula). Default je nula.
        Jin doplujc znak mete zadat tak, e ped nj pedadte jednoduchou
        uvozovku (<literal>'</literal>). Viz ukzky ne.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Voliteln <emphasis>alignment specifier</emphasis>, kter uruje, jestli
        se m vsledek zarovnat doleva nebo doprava. Default je doprava, pomlka
        (<literal>-</literal>) to zmn na doleva.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Voliteln slo <emphasis>width specifier</emphasis>, kter uruje,
        kolik znak (minimln) m obsahovat vsledek pevodu.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Voliteln <emphasis>precision specifier</emphasis>, kter uruje, kolik
        desetinnch mst se m zobrazit u sel s desetinnou rkou. Tento
        pepna nem dn vliv na jin typy ne double. (Dal funkc
        uitenou na formtovn sel je <function>number_format</function>.)
       </simpara>
      </listitem>
      <listitem>
       <para>
        <emphasis>type specifier</emphasis>, kter uruje, za jak typ se maj
        data argumentu povaovat. Mon typy:
        <simplelist>
         <member>
          <literal>%</literal> - a doslovn znak procenta. Nevyaduje se dn
          argument.
         </member>
         <member>
          <literal>b</literal> - argument se povauje za integer a je
          prezentovn jako binrn slo.
         </member>
         <member>
          <literal>c</literal> - argument se povauje za integer a je
          prezentovn jako znak s touto ASCII hodnotou.
         </member>
         <member>
          <literal>d</literal> - argument se povauje za integer a je
          prezentovn jako destkov slo.
         </member>
         <member>
          <literal>f</literal> - argument se povauje za double a je
          prezentovn jako slo s plovouc desetinou rkou.
         </member>
         <member>
          <literal>o</literal> - argument se povauje za integer a je
          prezentovn jako oktalov slo.
         </member>
         <member>
          <literal>s</literal> - argument se povauje za etzec a je takto
          prezentovn.
         </member>
         <member>
          <literal>x</literal> - the argument se povauje za integer a je
          prezentovn jako hexadecimln slo (s malmi psmeny).
         </member>
         <member>
          <literal>X</literal> - argument se povauje za integer a je
          prezentovn jako hexadecimln slo (s kapitlkami).
         </member>
        </simplelist>
       </para>
      </listitem>
     </orderedlist>
    </para>
    <simpara>
     Viz tak: <function>printf</function>,
     <function>sscanf</function>,
	 <function>fscanf</function> a
	 <function>number_format</function>.
    </simpara>
   </refsect1>
   <refsect1>
    <title>Ukzky</title>
    <para>
     <example>
      <title>Ukzka <function>sprintf</function>: zero-padded integers</title>
      <programlisting role="php">
$isodate = sprintf ("%04d-%02d-%02d", $year, $month, $day);
      </programlisting>
     </example>
     <example>
      <title>Ukzka <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>
     Binrn bezpen case-insensitive porovnn prvnch n znak etzc
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strncasecmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>int</type><parameter>len</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce se podob <function>strcasecmp</function>, s tm rozdlem, e
     mete urit (maximln) poet znak (<parameter>len</parameter>) z kadho
     z etzc, kter se pouij pi porovnn. Pokud je nkter z etzc
     krat ne <parameter>len</parameter>, pak se pro porovnn pouije dlka
     tohoto etzce.
    </para>
    <simpara>
     Pokud je <parameter>str1</parameter> mn ne <parameter>str2</parameter>,
     vrac &lt; 0; pokud je <parameter>str1</parameter> vt ne
     <parameter>str2</parameter>, vrac &gt; 0, a 0, pokud jsou stejn.
    </simpara>
    <simpara>
     Viz tak: <function>ereg</function>,
     <function>strcasecmp</function>,
     <function>strcmp</function>,
     <function>substr</function>,
     <function>stristr</function> a
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strcasecmp">
   <refnamediv>
    <refname>strcasecmp</refname>
    <refpurpose>
     Binrn bezpen case-insensitive porovnn etzc
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strcasecmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokud je <parameter>str1</parameter> mn ne <parameter>str2</parameter>
     vrac &lt; 0; pokud je <parameter>str1</parameter> vt ne
     <parameter>str2</parameter> vrac &gt; 0, a 0, pokud jsou stejn.
    <example>
      <title>Ukzka <function>strcasecmp</function></title>
      <programlisting role="php">
$var1 = "Hello";
$var2 = "hello";
if (!strcasecmp ($var1, $var2)) {
    echo 'v case-insensitive textovm porovnn se $var1 rovn $var2';
}
      </programlisting>
    </example>
    </para>
    <simpara>
     Viz tak: <function>ereg</function>,
     <function>strcmp</function>,
     <function>substr</function>,
     <function>stristr</function>,
     <function>strncasecmp</function> a
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strchr">
   <refnamediv>
    <refname>strchr</refname>
    <refpurpose>Najt prvn vskyt znaku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strchr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce je alias k <function>strstr</function>, a je ve vech smrech
     identick.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strcmp">
   <refnamediv>
    <refname>strcmp</refname>
    <refpurpose>Binrn bezpen porovnat etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strcmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Pokud je <parameter>str1</parameter> mn ne <parameter>str2</parameter>,
     vrac &lt; 0; pokud je <parameter>str1</parameter> vt ne
     <parameter>str2</parameter>, vrac &gt; 0, a 0, pokud jsou stejn.
    </simpara>
    <simpara>
     Pozn.: toto srovnn je case-sensitive.
    </simpara>
    <simpara>
     Viz tak: <function>ereg</function>,
     <function>strcasecmp</function>,
     <function>substr</function>,
     <function>stristr</function>,
     <function>strncasecmp</function>,
     <function>strncmp</function> a
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strcspn">
   <refnamediv>
    <refname>strcspn</refname>
    <refpurpose>
     Najt dlku vodnho segmentu neodpovdajcho masce
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strcspn</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Vrac dlku vodnho segmentu <parameter>str1</parameter>, kter
     <emphasis>ne</emphasis>obsahuje dn ze znak <parameter>str2</parameter>.
    </simpara>
    <simpara>
     Viz tak: <function>strspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strip-tags">
   <refnamediv>
    <refname>strip_tags</refname>
    <refpurpose>Odstranit z etzce HTML a PHP tagy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strip_tags</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce se sna odstranit z pedanho etzce vechny HTML a PHP tagy.
     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>
     Voliteln druh argument mete pout k uren tag, kter se nemaj
     odstranit.
     <note>
      <para>
       Argument <parameter>allowable_tags</parameter> byl pidn v PHP 3.0.13,
       PHP 4 b3.
      </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>
     <methodsynopsis>
      <type>string</type><methodname>stripcslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac etzec bez odstrannch zptnch lomtek. Rozeznv Ckov
     <literal>\n</literal>, <literal>\r</literal> ..., oktalov a hexadecimln
     reprezentace.
     <note>
      <simpara>
       Tato funkce byla pidna v 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>
     <methodsynopsis>
      <type>string</type><methodname>stripslashes</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac etzec bez odstrannch zptnch lomtek.
     (<literal>\'</literal> se stv <literal>'</literal> a pod.)
     Zdvojen zptn lomtka se spojuj do jednoduchch.
    </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>
     <methodsynopsis>
      <type>string</type><methodname>stristr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac <parameter>haystack</parameter> od prvnho vskytu
     <parameter>needle</parameter> do konce.
     <parameter>needle</parameter> a <parameter>haystack</parameter>
     se zkoumaj bez ohledu na velikost psmen.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nenajde, vrac &false;.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nen etzec, pevede se na integer a
     pouije se jako XXX ordinal hodnota znaku.
    </para>
    <para>
     Viz tak: <function>strchr</function>,
     <function>strrchr</function>,
     <function>substr</function> a
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strlen">
   <refnamediv>
    <refname>strlen</refname>
    <refpurpose>Zjistit dlku etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strlen</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac dlku (poet znak) argumentu <parameter>string</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcmp">
   <refnamediv>
    <refname>strnatcmp</refname>
    <refpurpose>Porovnn etzc algoritmem "pirozenho tdn"</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce implementuje srovnvac algoritmus kter td alfanumerick
     etzce stejnm zpsobem jako lovk, toto se popisuje jako "pirozen
     tdn". Ukzka rozdlu mzi tmto algoritmem a bnmi potaovmi
     algoritmy pro azen etzc (nap. <function>strcmp</function>):
	 <informalexample>
	  <programlisting>
$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png");
echo "Standardn porovnvn etzc\n";
usort($arr1,"strcmp");
print_r($arr1);
echo "\nPirozen porovnvn etzc\n";
usort($arr2,"strnatcmp");
print_r($arr2);
	  </programlisting>
	 </informalexample>
	 Ve uveden kd vygeneruje nsledujc vstup:
	 <informalexample>
	  <programlisting>
Standardn porovnvn etzc
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img10.png
    [2] =&gt; img12.png
    [3] =&gt; img2.png
)

Pirozen porovnvn etzc
Array
(
    [0] =&gt; img1.png
    [1] =&gt; img2.png
    [2] =&gt; img10.png
    [3] =&gt; img12.png
)
	  </programlisting>
	 </informalexample>
	 Vce informac viz strnka Martina Poola <ulink
	 url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
	</para>
	<simpara>
	 Podobn jako jin funkce pro porovnvn etzc i tato vrac &lt; 0
	 pokud je <parameter>str1</parameter> men ne
	 <parameter>str2</parameter>; &gt; 0 pokud je <parameter>str1</parameter>
	 vt ne <parameter>str2</parameter>, a 0 pokud jsou shodn.
    </simpara>
    <simpara>
     Pozn.: toto porovnn je 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> a
     <function>natcasesort</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strnatcasecmp">
   <refnamediv>
    <refname>strnatcasecmp</refname>
    <refpurpose>
	 Case-insensitive textov porovnn s vyuitm "natural order" algoritmu
	</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strnatcasecmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce implementuje srovnvac algoritmus kter td alfanumerick
     etzce stejnm zpsobem jako lovk. Chovn tto funkce se podob
	 <function>strnatcmp</function> s tou vjimkou, e porovnn je
	 case-insensitive. Vce informac viz strnka Martina Poola
	 <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink>.
	</para>
	<simpara>
	 Podobn jako jin funkce pro porovnvn etzc i tato vrac &lt; 0
	 pokud je <parameter>str1</parameter> men ne
	 <parameter>str2</parameter>; &gt; 0 pokud je <parameter>str1</parameter>
	 vt ne <parameter>str2</parameter>, a 0 pokud jsou shodn.
    </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> a
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strncmp">
   <refnamediv>
    <refname>strncmp</refname>
    <refpurpose>
	 Binrn bezpen porovnn prvnch n znak v etzcch
	</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strncmp</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
      <methodparam><type>int</type><parameter>len</parameter></methodparam>
     </methodsynopsis>
    <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>
	 Vrac &lt; 0 pokud je <parameter>str1</parameter> men ne
	 <parameter>str2</parameter>; &gt; 0 pokud je <parameter>str1</parameter>
	 vt ne <parameter>str2</parameter>, a 0 pokud jsou shodn.
    </simpara>
    <simpara>
     Pozn.: toto srovnn je case-sensitive.
    </simpara>
    <simpara>
     Viz tak: <function>ereg</function>,
     <function>strncasecmp</function>,
     <function>strcasecmp</function>,
     <function>substr</function>,
     <function>stristr</function>,
     <function>strcmp</function> a
     <function>strstr</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.str-pad">
   <refnamediv>
    <refname>str_pad</refname>
    <refpurpose>Doplnit etzec jinm etzcem na uritou dlku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>str_pad</methodname>
      <methodparam><type>string</type><parameter>input</parameter></methodparam>
      <methodparam><type>int</type><parameter>pad_length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>pad_string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>pad_type</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>str_pad</function> dopln etzec <parameter>input</parameter>
     zleva, zprava nebo z obou stran na danou dlku. Pokud j nen pedn
     voliteln argument <parameter>pad_string</parameter>, dopln se
     <parameter>input</parameter> mezerami, jinak se dopln znaky z
     <parameter>pad_string</parameter>.
    </para>
    <para>
     Voliteln argument <parameter>pad_type</parameter> me nabt hodnot
     STR_PAD_RIGHT, STR_PAD_LEFT nebo STR_PAD_BOTH. Default je STR_PAD_RIGHT.
    </para>
    <para>
     Pokud je hodnota <parameter>pad_length</parameter> negativn nebo men ne
     je dlka <parameter>input</parameter>, k doplnn nedojde.
    </para>
    <para>
     <example>
      <title>Ukzka <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>Najt pozici prvnho vskytu etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strpos</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac selnou pozici prvnho vskytu <parameter>needle</parameter> v
     etzci <parameter>haystack</parameter>. Narozdl od
     <function>strrpos</function> tato funkce pijme jako
     argument <parameter>needle</parameter> etzec vce znak, a cel tento
     etzec se pouije.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nenajde, vrac &false;.
     <note>
      <para>
       Nvratov hodnoty "znak nalezen na pozici 0" a "znak nenalezen" se daj
       snadno zamnit. Tady je nvod, jak zjistit tento rozdl:
       <informalexample>
	<programlisting role="php">
// v PHP 4.0b3 a novjch:
$pos = strpos ($mystring, "b");
if ($pos === false) { // ti rovntka
    // nenalezeno...
}

// ve verzch starch ne 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
    // nenalezeno...
}
	</programlisting>
       </informalexample>
      </para>
     </note>
    </para>
    <para>
     Pokud <parameter>needle</parameter> nen etzec, pevede se na integer a
     pouije se jako XXX ordinal hodnota znaku.
    </para>
    <para>
     Voliteln argument <parameter>offset</parameter> vm umouje urit na
     kter pozici v <parameter>haystack</parameter> m hledn zat. Vrcen
     pozice je i tak relativn k zatku <parameter>haystack</parameter>.
    </para>
    <para>
     Viz tak: <function>strrpos</function>,
     <function>strrchr</function>,
     <function>substr</function>,
     <function>stristr</function> a
     <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrchr">
   <refnamediv>
    <refname>strrchr</refname>
    <refpurpose>Najt posledn vskyt znaku v etzci</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strrchr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce vrac tu st <parameter>haystack</parameter>, kter zan
     poslenm vskytem <parameter>needle</parameter> a pokrauje do konce
     <parameter>haystack</parameter>.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nenajde, vrac &false;.
    </para>
    <para>
     Pokud <parameter>needle</parameter> obsahuje vce ne jeden znak, pouije
     se prvn z nich.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nen etzec, pevede se na integer a
     pouije se jako XXX ordinal hodnota znaku.
     <example>
      <title>Ukzka <function>strrchr</function></title>
      <programlisting role="php">
// zskat posledn adres v $PATH
$dir = substr (strrchr ($PATH, ":"), 1);

// zskat vechno po poslednm konci dku
$text = "dek 1\ndek 2\ndek 3";
$last = substr (strrchr ($text, 10), 1 );
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak: <function>substr</function>,
     <function>stristr</function> a
     <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.str-repeat">
   <refnamediv>
    <refname>str_repeat</refname>
    <refpurpose>Opakovat etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>str_repeat</methodname>
      <methodparam><type>string</type><parameter>input</parameter></methodparam>
      <methodparam><type>int</type><parameter>multiplier</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac <parameter>input_str</parameter> <parameter>multiplier</parameter>
     krt opakovan.
     <parameter>multiplier</parameter> mus bt vt ne 0.
    </para>
    <example>
     <title>Ukzka <function>str_repeat</function></title>
     <programlisting role="php">
echo str_repeat ("-=", 10);
     </programlisting>
    </example>
    <para>
     This will output "-=-=-=-=-=-=-=-=-=-=".
    </para>
    <note>
     <para>
      Tato funkce byla pidna v PHP 4.0.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.strrev">
   <refnamediv>
    <refname>strrev</refname>
    <refpurpose>Obrtit etzec</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strrev</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac <parameter>string</parameter> v opanm poad.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strrpos">
   <refnamediv>
    <refname>strrpos</refname>
    <refpurpose>Najt pozici poslednho vskytu znaku v etzci</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strrpos</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>char</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac selnou pozici poslednho vskytu <parameter>needle</parameter> v
     etzci <parameter>haystack</parameter>. <parameter>needle</parameter> me
     bt jen jeden znak dlouh. Pokud obsahuje vce znak, pouije se prvn z
     nich.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nenajde, vrac &false;.
     <note>
      <para>
       Nvratov hodnoty "znak nalezen na pozici 0" a "znak nenalezen" se daj
       snadno zamnit. Tady je nvod, jak zjistit tento rozdl:
       <informalexample>
	<programlisting role="php">
// v PHP 4.0b3 a novjch:
$pos = strpos ($mystring, "b");
if ($pos === false) { // ti rovntka
    // nenalezeno...
}

// ve verzch starch ne 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
    // nenalezeno...
}
	</programlisting>
       </informalexample>
      </para>
     </note>
    </para>
    <para>
     Pokud <parameter>needle</parameter> nen etzec, pevede se na integer a
     pouije se jako XXX ordinal hodnota znaku.
    </para>
    <para>
     Viz tak: <function>strpos</function>,
     <function>strrchr</function>,
     <function>substr</function>,
     <function>stristr</function> a
     <function>strstr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strspn">
   <refnamediv>
    <refname>strspn</refname>
    <refpurpose>Zjistit dlku vodnho segmentu odpovdajcho masce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>strspn</methodname>
      <methodparam><type>string</type><parameter>str1</parameter></methodparam>
      <methodparam><type>string</type><parameter>str2</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Vrac vodnho segmentu <parameter>str1</parameter>, kter se skld
     vhradn ze znak v <parameter>str2</parameter>.
    </simpara>
    <para>
     <informalexample>
      <programlisting role="php">
strspn ("42 je odpov, co je otzka...", "1234567890");
      </programlisting>
      <para>
       vrt 2.
      </para>
     </informalexample>
    </para>
    <simpara>
     Viz tak: <function>strcspn</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.strstr">
   <refnamediv>
    <refname>strstr</refname>
    <refpurpose>Najt prvn vskyt etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strstr</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac st <parameter>haystack</parameter> od prvnho vskytu
     <parameter>needle</parameter> do konce.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nenajde, vrac &false;.
    </para>
    <para>
     Pokud <parameter>needle</parameter> nen etzec, pevede se na integer a
     pouije se jako XXX ordinal hodnota znaku.
    </para>
    <para>
     <note>
      <para>
       Pozn.: tato funkce je case-sensitive. Pro case-insensitive hledn
       pouijte <function>stristr</function>.
      </para>
     </note>
    </para>
    <para>
     <example>
      <title>Ukzka <function>strstr</function></title>
      <programlisting role="php">
$email = 'sterling@designmultimedia.com';
$domain = strstr ($email, '@');
print $domain; // vytiskne @designmultimedia.com
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak: <function>stristr</function>,
     <function>strrchr</function>,
     <function>substr</function> a
     <function>ereg</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtok">
   <refnamediv>
    <refname>strtok</refname>
    <refpurpose>Tokenize string</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strtok</methodname>
      <methodparam><type>string</type><parameter>arg1</parameter></methodparam>
      <methodparam><type>string</type><parameter>arg2</parameter></methodparam>
     </methodsynopsis>
    <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>Ukzka <function>strtok</function></title>
      <programlisting role="php">
$string = "This is an example string";
$tok = strtok ($string," ");
while ($tok) {
    echo "Word=$tok&lt;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> a
     <function>explode</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtolower">
   <refnamediv>
    <refname>strtolower</refname>
    <refpurpose>Zmnit etzec na mal psmena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strtolower</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac <parameter>string</parameter> se vemi alfabetickmi znaky zmnnmi
     na mal psmena.
    </para>
    <para>
     Pozn.: co je 'alfabetick' je dno aktulnm mstnm nastavenm. Napklad
     ve standardnm "C" locale se znaky jako pehlasovan a () nepevedou.
    </para>
    <example>
     <title>Ukzka <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>Zmnit etzec na velk psmena</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strtoupper</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac <parameter>string</parameter> se vemi alfabetickmi znaky zmnnmi
     na velk psmena.
    </para>
    <para>
     Pozn.: co je 'alfabetick' je dno aktulnm mstnm nastavenm. Napklad
     ve standardnm "C" locale se znaky jako pehlasovan a () nepevedou.
    </para>
    <example>
     <title>Ukzka <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 vechny vskyty jednoho etzce v jinm dalm etzcem
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>str_replace</methodname>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce nahrad vechny vskyty <parameter>needle</parameter> v argumentu
     <parameter>haystack</parameter> argumentem <parameter>str</parameter>.
     Pokud nepotebujete sloit pravidla pro nahrazovn, mli byste vdy pout
     tuto funkci msto <function>ereg_replace</function>.
    </para>
    <para>
     <example>
      <title>Ukzka <function>str_replace</function></title>
      <programlisting role="php">
$bodytag = str_replace ("%body%", "black", "&lt;body text=%body%>");
      </programlisting>
     </example>
    </para>
    <para>
     Tato funkce je XXX binrn bezpen.
    </para>
    <note>
     <para>
      Funkce <function>str_replace</function> byla pidna v PHP 3.0.6, ale a
      do verze PHP 3.0.8 fungovala patn.
     </para>
    </note>
    <para>
     Viz tak: <function>ereg_replace</function> a
     <function>strtr</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.strtr">
   <refnamediv>
    <refname>strtr</refname>
    <refpurpose>Peloit urit znaky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>strtr</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam><type>string</type><parameter>from</parameter></methodparam>
      <methodparam><type>string</type><parameter>to</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce uprav <parameter>str</parameter> tak, e vechny vskyty
     vech znak ve <parameter>from</parameter> pelo na odpovdajc znaky v
     <parameter>to</parameter> a vrt vsledek.
    </para>
    <para>
     Pokud jsou <parameter>from</parameter> a <parameter>to</parameter> rzn
     dlouh, pebvajc znaky z delho z tch dvou se ignoruj.
     <example>
      <title>Ukzka <function>strtr</function></title>
      <programlisting role="php">
$addr = strtr($addr, "", "aao");
      </programlisting>
     </example>
    </para>
    <para>
     <function>strtr</function> se d tak volat pouze se dvma argumenty. Pi
     voln se dvma argumenty se chov takto: <parameter>from</parameter> mus
     bt pole obsahujc pry etzc, kter se zamn ve zdrojovm etzci.
     <function>strtr</function> vdy hled nejdel monou shodu a *NENAHRAZUJE*
     ty sti etzce, na kterch u pracovala.
    </para>
    <para>
     Ukzky:
     <informalexample>
      <programlisting role="php">
$trans = array ("ahoj" =&gt; "nazdar", "nazdar" =&gt; "ahoj");
echo strtr("nazdar lidi, ekl jsem ahoj", $trans) . "\n";
      </programlisting>
     </informalexample>
     Vsledek: "ahoj lidi, ekl jsem nazdar",
    </para>
    <note>
     <simpara>
      Tato vlastnost (dva argumenty) byla pidna 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>Vrtit st etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>substr</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam><type>int</type><parameter>start</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr</function> vrac st argumentu <parameter>string</parameter>
     urenou argumenty <parameter>start</parameter> a <parameter>length</parameter>.
    </para>
    <para>
     Pokud je <parameter>start</parameter> pozitivn, vrcen etzec zane
     <parameter>start</parameter>-tm znakem etzce <parameter>string</parameter>,
     potno od nuly. Napklad v etzci '<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>
     Pklady:
     <informalexample>
      <programlisting role="php">
$rest = substr ("abcdef", 1);    // vrt "bcdef"
$rest = substr ("abcdef", 1, 3); // vrt "bcd"
      </programlisting>
     </informalexample>
    </para>
    <para>
     Pokud je <parameter>start</parameter> negativn, vrcen etzec zane
     <parameter>start</parameter>-tm znakem od konce argumentu
     <parameter>string</parameter>.
    </para>
    <para>
     Pklady:
     <informalexample>
      <programlisting role="php">
$rest = substr ("abcdef", -1);    // vrt "f"
$rest = substr ("abcdef", -2);    // vrt "ef"
$rest = substr ("abcdef", -3, 1); // vrt "d"
      </programlisting>
     </informalexample>
    </para>
    <para>
     Pokud je argument <parameter>length</parameter> kladn, vrcen etzec
     skon <parameter>length</parameter> znak od <parameter>start</parameter>.
     Pokud by to znamenalo etzec se zpornou dlkou (<parameter>start</parameter>
     je za <parameter>length</parameter>), vrcen etzec bude sestvat z
     jedinho znaku na pozici <parameter>start</parameter>.
    </para>
    <para>
     Pokud je argument <parameter>length</parameter> kladn, vrcen etzec
     skon <parameter>length</parameter> znak od konce argumentu
     <parameter>string</parameter>. Pokud by to znamenalo etzec se zpornou
     dlkou, vrcen etzec bude sestvat z jedinho znaku na pozici
     <parameter>start</parameter>.
    </para>
    <para>
     Pklady:
     <informalexample>
      <programlisting role="php">
$rest = substr ("abcdef", 1, -1); // vrt "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>Spotat poet vskyt etzce</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>substr_count</methodname>
      <methodparam><type>string</type><parameter>haystrack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_count</function> vrac poet vskyt etzce
     <parameter>needle</parameter> v etzci <parameter>haystack</parameter>
     string.
    </para>

    <para>
     <example>
      <title>Ukzka <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 etzce jinm etzcem</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>substr_replace</methodname>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam><type>string</type><parameter>replacement</parameter></methodparam>
      <methodparam><type>int</type><parameter>start</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>substr_replace</function> nahrazuje st etzce
     <parameter>string</parameter> ohranienou argumenty
     <parameter>start</parameter> a (voliteln)
     <parameter>length</parameter> etzcem v argumentu
     <parameter>replacement</parameter>. Vrac vsledek.
    </para>
    <para>
     Pokud je <parameter>start</parameter> pozitivn, nhrada zane na
     <parameter>start</parameter>-tm znaku argumentu
     <parameter>string</parameter>.
    </para>
    <para>
     Pokud je <parameter>start</parameter> negativn, nhrada zane na
     <parameter>start</parameter>-tm znaku od konce argumentu
     <parameter>string</parameter>.
    </para>
    <para>
     Pokud je ptomen <parameter>length</parameter>, a je pozitivn, pedstavuje
     dlku sti argumentu <parameter>string</parameter>, kter bude nahraena.
     Pokud je negativn, pedstavuje poet znak od konce
     <parameter>string</parameter>, kde m nahrazovn skonit. Pokud ptomen
     nen, bere se standardn strlen( <parameter>string</parameter> ); tj.
     nahrazovn kon na konci argumentu <parameter>string</parameter>.
    </para>
    <para>
     <example>
      <title>Ukzka <function>substr_replace</function></title>
      <programlisting role="php">
&lt;?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Originl: $var&lt;hr&gt;\n";

/* Tyto dva pklady nahrad cel obsah promnn $var etzcem 'bob'. */
echo substr_replace ($var, 'bob', 0) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "&lt;br&gt;\n";

/* Toto vlo 'bob' na zatek $var. */
echo substr_replace ($var, 'bob', 0, 0) . "&lt;br&gt;\n";

/* Tyto dva pklady nahrad 'MNRPQR' ve $var etzcem 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', -7, -1) . "&lt;br&gt;\n";

/* Toto z $var odstran 'MNRPQR'. */
echo substr_replace ($var, '', 10, -1) . "&lt;br&gt;\n";
?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>str_replace</function> a <function>substr</function>.
    </para>
    <note>
     <simpara>
      Funkce <function>substr_replace</function> byla pidna v PHP 4.0.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.trim">
   <refnamediv>
    <refname>trim</refname>
    <refpurpose>
     Odstranit netisknuteln znaky ze zatku a konce etzce
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>trim</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tato funkce odstrauje netisknuteln znaky ze zatku a konce etzce a
     vrac etzec bez tchto znak. Netisknuteln znaky, kter se v souasnosti
     odstrauj, 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>Zmn prvn psmeno etzce na velk</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>ucfirst</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zmn prvn znak argumentu <parameter>str</parameter>, pokud je tento znak
     alfabetick.
    </para>
    <para>
     Pozn.: co znamen 'alfabetick' uruje aktuln mstn nastaven (locale).
     Napklad ve standardnm "C" locale se znaky jako pehlasovan a ()
     nepevedou.
     <example>
      <title>Ukzka <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> a
     <function>strtolower</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ucwords">
   <refnamediv>
    <refname>ucwords</refname>
    <refpurpose>
     Zmnit prvn znak kadho slova v etzci na velk psmeno
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>ucwords</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zmn prvn znak kadho slova v argumentu <parameter>str</parameter> na
     velk psmeno, pokud je tento znak alfabetick.
     <example>
      <title>Ukzka <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>
       Definice slova je: jakkoli etzec znak, kter nsleduje bezprostedn
       po netisknutelnm znaku (to jsou: mezera, posun o tiskouvou stranu,
       pesun na novou dku, nvrat vozku, horizontln tabeltor a vertikln
       tabeltor0.
      </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>
     Zalmat etzec na dan poet znak pomoc break znaku
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>wordwrap</methodname>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>width</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>break</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>cut</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zalme etzec <parameter>str</parameter> na sloupci urenm (volitelnm)
     argumentem <parameter>break</parameter>.
    </para>
    <para>
     Pokud nen zadn argument <parameter>width</parameter> nebo
     <parameter>break</parameter>, <function>wordwrap</function> automaticky
     zalme dky etzce na sloupci 75 znakem '\n' (konec dku).
    </para>
    <para>
     Pokud m argument <parameter>cut</parameter> hodnotu 1, etzec se na
     urenou ku zalom vdy. Take pokud mte slovo del ne je dan ka,
     rozdl se.
	 (Viz druh pklad.)
     <note>
      <para>
       Argument <parameter>cut</parameter> byl pidn PHP 4.0.3.
      </para>
     </note>
    </para>
    <para>
     <example>
      <title>Ukzka <function>wordwrap</function></title>
      <programlisting role="php">
$text = "Rychl hnd lika peskoila lnho psa.";
$newtext = wordwrap( $text, 20 );

echo "$newtext\n";
      </programlisting>
     </example>
    </para>
    <para>
     Tato ukzka by zobrazila:
    </para>
    <para>
     <informalexample>
      <programlisting>
Rychl hnd lika
peskoila lnho psa.
      </programlisting>
     </informalexample>
    </para>
    <para>
     <example>
      <title>Ukzka <function>wordwrap</function></title>
      <programlisting role="php">
$text = "Velmi dlouh slooooooooooovo.";
$newtext = wordwrap( $text, 8, "\n", 1);

echo "$newtext\n";
      </programlisting>
     </example>
    </para>
    <para>
     Tato ukzka by zobrazila:
    </para>
    <para>
     <informalexample>
      <programlisting>
Velmi
dlouh
sloooooo
ooooovo.
      </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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->