<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.filesystem">
  <title>Filesystmov funkce</title>
  <titleabbrev>Filesystm</titleabbrev>

  <refentry id="function.basename">
   <refnamediv>
    <refname>basename</refname>
    <refpurpose>Vrt st cesty obsahujc nzev souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>basename</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pijm etzec obsahujc cestu na soubor, vrac nzev souboru.
    </para>
    <para>
     Na Windows se jako oddlova cesty d pout jak lomtko
     (<literal>/</literal>), tak zptn lomtko (<literal>\</literal>).
     V ostatnch prostedch je to normln lomtko (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title>Ukzka <function>basename</function></title>
      <programlisting role="php">
$path = '/home/httpd/html/index.php3' ;
$file = basename( $path ) ; // $file m hodnotu "index.php3"
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>dirname</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chgrp">
   <refnamediv>
    <refname>chgrp</refname>
    <refpurpose>Zmnit skupinu souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>chgrp</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>group</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokus se nastavit skupinu souboru <parameter>filename</parameter> na
     <parameter>group</parameter>. Pouze superuivatel me libovoln zmnit
     skupinu souboru; ostatn uivatel mohou zmnit skupinu souboru na jinou
     skupinu, j jsou leny.
    </para>
    <para>
     Pi spchu vrac &true;; jinak &false;.
    </para>
    <para>
     Viz tak <function>chown</function> a <function>chmod</function>.
    </para>
    <note>
     <simpara>
      Tato funkce nefunguje na Windows systmech.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.chmod">
   <refnamediv>
    <refname>chmod</refname>
    <refpurpose>Zmnit md souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>chmod</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokus se zmnit md souboru <parameter>filename</parameter> na
     <parameter>mode</parameter>.
    </para>
    <para>
     Pozn.: <parameter>mode</parameter> se nepovauje automaticky za oktalovou
     hodnotu, take etzce (jako "g+w") nebudou sprvn fungovat. Pokud si
     chcete zajistit oekvan chovn, muste na zatek
     <parameter>mode</parameter> pidat nulu (0):
     <informalexample>
      <programlisting role="php">
chmod ("/somedir/somefile", 755);   // desitkove cislo; zrejme nespravne
chmod ("/somedir/somefile", "u+rwx,go+rx"); // retezec; nespravny
chmod ("/somedir/somefile", 0755);  // oktal; spravna hodnota modu
      </programlisting>
     </informalexample>
    </para>
    <para>
     Pi spchu vrac &true;, jinak &false;.
    </para>
    <para>
     Viz tak <function>chown</function> a <function>chgrp</function>.
    </para>
    <note>
     <simpara>
      Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.chown">
   <refnamediv>
    <refname>chown</refname>
    <refpurpose>Zmn vlastnka souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>chown</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>user</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokus se zmnit vlastnka souboru na <parameter>user</parameter>. Pouze
     superuivatel me zmnit majitele souboru.
    </para>
    <para>
     Pi spchu vrac &true;, jinak &false;.
    </para>
    <para>
     Viz tak <function>chown</function> a <function>chmod</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.clearstatcache">
   <refnamediv>
    <refname>clearstatcache</refname>
    <refpurpose>Vymae cache stavu soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>clearstatcache</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Voln systmovch funkc <systemitem>stat</systemitem> i
     <systemitem>lstat</systemitem> m pomrn velkou reii. Tud se vsledek
     poslednho voln vech stavovch funkc (viz seznam ne) ukld pro pouit
     pi dalm takovm voln pouvajcm stejn nzev souboru. Pokud chcete
     vynutit novou kontrolu stavu, nap. pokud je soubor kontrolovn mnohokrt
     a me se zmnit nebo zmizet, pouijte tuto funkci k uvolnn vsledk
     poslednho voln z pamti.
    </para>
    <para>
     Tato hodnota se cachuje pouze po dobu bhu skriptu.
    </para>
    <para>
     Ovlivnn funkce:
     <function>stat</function>,
     <function>lstat</function>,
     <function>file_exists</function>,
     <function>is_writable</function>,
     <function>is_readable</function>,
     <function>is_executable</function>,
     <function>is_file</function>,
     <function>is_dir</function>,
     <function>is_link</function>,
     <function>filectime</function>,
     <function>fileatime</function>,
     <function>filemtime</function>,
     <function>fileinode</function>,
     <function>filegroup</function>,
     <function>fileowner</function>,
     <function>filesize</function>,
     <function>filetype</function>, a
     <function>fileperms</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.copy">
   <refnamediv>
    <refname>copy</refname>
    <refpurpose>Zkopruje soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>copy</methodname>
      <methodparam><type>string</type><parameter>source</parameter></methodparam>
      <methodparam><type>string</type><parameter>dest</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vytvo kopii souboru. Vrac &true; pokud se koprovn
     zdailo, jinak &false;.
     <example>
      <title>Ukzka <function>copy</function></title>
      <programlisting role="php">
if (!copy($file, $file.'.bak')) {
    print ("failed to copy $file...&lt;br&gt;\n");
}
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>rename</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.delete">
   <refnamediv>
    <refname>delete</refname>
    <refpurpose>Falen poloka manulu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>void</type><methodname>delete</methodname>
      <methodparam><type>string</type><parameter>file</parameter></methodparam>
     </methodsynopsis>
    <para>
     Toto je falen poloka manulu, kter by mla pomoci lidem, kte hledaj
     <function>unlink</function> nebo <function>unset</function> na patnm
     mst.
    </para>
    <para>
     Viz tak <function>unlink</function> (mazn soubor),
     <function>unset</function> (mazn promnnch).
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dirname">
   <refnamediv>
    <refname>dirname</refname>
    <refpurpose>Vrac st cesty obsahujc nzev adrese</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>dirname</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pijm etzec obsahujc cestu na soubor a vrac nzev adrese.
    </para>
    <para>
     Na Windows se jako oddlova sesty daj pouvat jak lomtko
     (<literal>/</literal>), tak zptn lomtko (<literal>\</literal>). Na
     ostatnch systmech je to lomtko (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title>Ukzka <function>dirname</function></title>
      <programlisting role="php">
$path = "/etc/passwd";
$file = dirname ($path); // $file obsahuje "/etc"
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>basename</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.diskfreespace">
   <refnamediv>
    <refname>diskfreespace</refname>
    <refpurpose>Vrt diskov prostor dostupn v adresi</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>float</type><methodname>diskfreespace</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pijm etzec obsahujc cestu na adres, vrac poet byt dostupnch
     na odpovdajcm filesystmu nebo oddlu.
    </para>
    <para>
     <example>
      <title>Ukzka <function>diskfreespace</function></title>
      <programlisting role="php">
$df = diskfreespace("/"); // $df obsahuje pocet bytu
                          // dostupnych na "/"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fclose">
   <refnamediv>
    <refname>fclose</refname>
    <refpurpose>Zave oteven deskriptor souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Soubor, na kter <parameter>fp</parameter> ukazuje, se zave.
    </para>
    <para>
     Vrac &true; pi spchu a &false; pi
     selhn.
    </para>
    <para>
     Deskriptor souboru mus bt platn, a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function> nebo
     <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.feof">
   <refnamediv>
    <refname>feof</refname>
    <refpurpose>Test na konec souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>feof</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true;, pokud je konec souboru (EOF) nebo nastala chyba,
     jinak &false;.
    </para>
    <para>
     Deskriptor souboru mus bt platn a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fflush">
   <refnamediv>
    <refname>fflush</refname>
    <refpurpose>Zape obsah vstupnho bufferu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fflush</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Funkce vynut okamit zpis vekerch dat uloench ve vstupnm bufferu
     do souboru odkazovanho pomoc deskriptoru
     <parameter>fp</parameter>. Vrac &true; pi spchu, jinak &false;.
    </para>
    <para>
     Deskriptor souboru mus bt platn a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetc">
   <refnamediv>
    <refname>fgetc</refname>
    <refpurpose>Nate 1 znak ze souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetc</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrt etzec obsahujc jedin znak peten ze souboru odkazovanho
     pomoc deskriptoru <parameter>fp</parameter>.
     Je-li konec souboru (EOF), vrac &false;.
    </para>
    <para>
     Deskriptor souboru mus bt platn a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
    </para>
    <para>
     Viz tak <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fsockopen</function>, a
     <function>fgets</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetcsv">
   <refnamediv>
    <refname>fgetcsv</refname>
    <refpurpose>
     Nate dek ze souboru a parsuje ho na CSV hodnoty
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>fgetcsv</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        delimiter
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Podobn jako <function>fgets</function> s vjimkou toho. e
     <function>fgetcsv</function> parsuje peten dek podle
     <acronym>CSV</acronym> formtu a vrac pole obsahujc
     zskan hodnoty. Oddlovaem je rka, pokud nespecifikujete
     jin oddlova jako nepovinn tet parametr.
    </simpara>
    <simpara>
     <parameter>Fp</parameter> mus bt platn deskriptor souboru
     spn otevenho pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>
    </simpara>
    <simpara>
     Dlka <parameter>length</parameter> mus bt vt ne nejdel
     dek, vyskytujc se v souboru (nepotaje v to znak konce dku).
    </simpara>
    <simpara>
     <function>fgetcsv</function> vrac &false; pi chyb vetn konce
     souboru (EOF).
    </simpara>
    <simpara>
     N.B. Przdn dek v CSV souboru bude vrcen jako pole s jedinm
     &null; polem, ani by to bylo vyhodnoceno jako chyba.
    </simpara>
    <example>
     <title>
      <function>fgetcsv</function> pklad - ten a tisk celho
      CVS souboru
     </title>
     <programlisting role="php">
$row = 1;
$fp = fopen ("test.csv","r");
while ($data = fgetcsv ($fp, 1000, ",")) {
    $num = count ($data);
    print "&lt;p&gt; $num fields in line $row: &lt;br&gt;";
    $row++;
    for ($c=0; $c&lt;$num; $c++) {
        print $data[$c] . "&lt;br&gt;";
    }
}
fclose ($fp);
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.fgets">
   <refnamediv>
    <refname>fgets</refname>
    <refpurpose>Pete dek ze souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgets</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac dek o dlce max. <parameter>length</parameter> - 1 byte
     peten ze souboru. ten kon, pokud bylo peteno
     <parameter>length</parameter> - 1 byt, nastal konec dku
     nebo konec souboru (podle toho, co pijde prvn).
    </para>
    <para>
     Pi vskytu chyby vrac &false;.
    </para>
    <para>
     Nejastj skal:
    </para>
    <simpara>
     Lid, kte pouvali 'C' smantiku funkce fgets, by si mli
     uvdomit rozdl v tom, jak je vrcen konec souboru.
    </simpara>
    <simpara>
     Deskriptor souboru mus bt platn a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
    </simpara>
    <para>
     Jednoduch pklad:
     <example>
      <title>ten souboru dek po dku</title>
      <programlisting role="php">
$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fgetc</function>,
     <function>fsockopen</function>, a
     <function>socket_set_timeout</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetss">
   <refnamediv>
    <refname>fgetss</refname>
    <refpurpose>
     Pete dek ze souboru a odstran HTML znaky
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetss</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        allowable_tags
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Identick s <function>fgets</function>, ale jsou zde
     z petenho textu odstraovny HTML a PHP znaky.
    </para>
    <para>
     Jako nepovinn tet parametr mete specifikovat znaky, kter
     nebudou odstraovny.
     <note>
      <para>
       <parameter>allowable_tags</parameter> - pidno v PHP 3.0.13,
       PHP4B3.
      </para>
     </note>
    </para>
    <para>
     Viz tak <function>fgets</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>, a
     <function>strip_tags</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.file">
   <refnamediv>
    <refname>file</refname>
    <refpurpose>Nate cel soubor do pole</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Identick s <function>readfile</function>, soubor je vak
     vrcen v podob pole. Kad element pole odpovd jednomu
     dku v souboru vetn znaku konce dku.
    </para>
    <para>
     Mete pout nepovinn druh parametr a nastavit ho na "1",
     pokud chcete hledat soubor tak v
     <link linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
&lt;?php
// nati WWW strnku do pole a vytiskni ji
$fcontents = file ('http://www.php.net');
while (list ($line_num, $line) = each ($fcontents)) {
    echo "&lt;b&gt;Line $line_num:&lt;/b&gt; " . htmlspecialchars ($line) . "&lt;br&gt;\n";
}

// nati WWW strnku do etzce
$fcontents = join ('', file ('http://www.php.net'));
?&gt;
      </programlisting>
     </informalexample>
    </para>
    <para>
     Viz tak <function>readfile</function>,
     <function>fopen</function>, <function>fsockopen</function>, a
     <function>popen</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.file-exists">
   <refnamediv>
    <refname>file_exists</refname>
    <refpurpose>Zjist, zda soubor existuje</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>file_exists</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Vrac &true;, pokud soubor specifikovan pomoc
     <parameter>filename</parameter> existuje, jinak &false;.
    </simpara>
    <simpara>
     <function>file_exists</function> nefunguje na vzdlench souborech;
     soubor k oven mus bt pstupn prostednictvm filesystmu serveru.
    </simpara>
    <simpara>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </simpara>
   </refsect1>
  </refentry>


  <refentry id="function.fileatime">
   <refnamediv>
    <refname>fileatime</refname>
    <refpurpose>Vrac as poslednho pstupu k souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileatime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Vrac as poslednho pstupu k souboru, pi chyb &false;.
     as je vrcen jako Unix timestamp.
    </simpara>
    <simpara>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </simpara>
    <simpara>
     Pozn.: Atime (as posl. pstupu) souboru se obvykle
     mn pi ten datovch blok ze souboru. To se me znan
     negativn projevit na vkonu systmu, pokud aplikace pistupuje
     k velkmu potu soubor nebo adres. Nkter Unixov
     filesystmy mohou mt atime deaktivovn za elem zven
     vkonu pro takov aplikace; takovm ppadem jsou USENET news
     spools. Tehdy je tato funkce bezpedmtn.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filectime">
   <refnamediv>
    <refname>filectime</refname>
    <refpurpose>Vrac as zmny inodu souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>filectime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac as posledn zmny inodu souboru, pi chyb &false;. as je
     vracen
     jako Unix timestamp.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Pozn.: Na vtin unixovch filesystm plat,
     e soubor je povaovn za zmnn, pokud jsou zmnna
     data v Inodu, tj. pstupov prva, vlastnk, skupina
     nebo jin metadata jsou zapsna do Inodu.
     <function>filemtime</function> (toto je to, co chcete pout,
     kdy chcete vytvoit daj "Posledn zmna" na WWW strnce) a
     <function>fileatime</function>.
    </para>
    <para>
     Pozn.: Na nkterch Unixech je ctime povaovn za as
     vytvoen souboru. To je chyba. Na vtin unixovch
     filesystm neexistuje dn as vytvoen unixovch
     soubor.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filegroup">
   <refnamediv>
    <refname>filegroup</refname>
    <refpurpose>Vrac skupinu pro soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>filegroup</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac ID skupiny vlastnka souboru, pi chyb &false;.
     Skupinov ID je v selnm tvaru, pouijte
     <function>posix_getgrgid</function> pro zskn nzvu skupiny.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.fileinode">
   <refnamediv>
    <refname>fileinode</refname>
    <refpurpose>Vrac inode souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileinode</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac inode slo souboru, pi chyb &false;.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.filemtime">
   <refnamediv>
    <refname>filemtime</refname>
    <refpurpose>Vrac as zmny souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>filemtime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac as posledn zmny souboru, pi chyb &false;.
     as je vracen jako Unix timestamp.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Tato funkce vrac as, kdy byly zapsny datov bloky,
     tj. as posledn zmny obsahu souboru. Pouijte funkci
     <function>date</function> na vsledek tto funkce k
     zskn formtovanho tvaru data pro pouit na WWW
     strnkch.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fileowner">
   <refnamediv>
    <refname>fileowner</refname>
    <refpurpose>Vrac vlastnka souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileowner</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac ID uivatele (UID), vlastncho soubor; pi chyb &false;.
     Hodnota je v selnm tvaru, pouijte funkci
     <function>posix_getpwuid</function> k zskn uivatelskho jmna.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.fileperms">
   <refnamediv>
    <refname>fileperms</refname>
    <refpurpose>Vrac pstupov prva k souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileperms</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac pstupov prva (permissions) k souboru, pi chyb &false;.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filesize">
   <refnamediv>
    <refname>filesize</refname>
    <refpurpose>Vrac velikost souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>filesize</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac velikost souboru, pi chyb &false;.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filetype">
   <refnamediv>
    <refname>filetype</refname>
    <refpurpose>Vrac typ souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>filetype</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac typ souboru. Mon hodnoty jsou fifo, char, dir, block, link,
     file a unknown.
    </para>
    <para>
     Pi chyb vrac &false;.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.flock">
   <refnamediv>
    <refname>flock</refname>
    <refpurpose>Jednotn "portable advisory" zamykn
     souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>flock</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>operation</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        wouldblock
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     PHP podporuje "portable" zpsob zamykn celch soubor na zklad
     jednotnho "advisory" principu (tzn. vechny pistupujc programy
     mus pouvat tent systm zamykn, jinak to nebude fungovat).
    </simpara>
    <simpara>
     <function>flock</function> funguje na deskriptoru
     <parameter>fp</parameter>, kter mus patit otevenmu souboru.
     <parameter>operation</parameter> je jedna z nsledujcch hodnot:
    </simpara>
    <para>
     <itemizedlist>
      <listitem>
       <simpara>
         K zskn sdlenho (shared) zmku (ten) nastavte
         <parameter>operation</parameter> na LOCK_SH (resp. 1 u verz do
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         K zskn vhradnho zmku (zpis) nastavte
         <parameter>operation</parameter> na LOCK_EX (resp. 2 u verz do
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         K uvolnn zmku (sdlenho nebo vhradnho) nastavte
         <parameter>operation</parameter> na LOCK_UN (resp. 3 u verz do
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         Pokud nechcete, aby funkce <function>flock</function> blokovala
         bhem zamykn, pidejte k <parameter>operation</parameter>
         hodnotu LOCK_NB (4 pro verze do PHP 4.0.1).
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <simpara>
     <function>flock</function> umonuje jednoduch model ten/zpis
     pouiteln teoreticky na vech platformch (vetn vtiny
     Unix a nejsp i Windows). Nepovinn tet argument se nastav na
     &true;, pokud by zmek ml blokovat (EWOULDBLOCK errno podmnka).
    </simpara>
    <simpara>
     <function>flock</function> vrac &true; pi spchu, &false; pi
     chyb (nap. kdy nelze vytvoit zmek).
    </simpara>
    <warning>
     <para>
      Na vtin operanch systm je funkce <function>flock</function>
      implementovna na rovni proces. Pi pouit multithreadovho
      serverovho API (jako je ISAPI) nemete spolhat na ochranu
      soubor proti jinm PHP skriptm bcm v paralelnch vlknech
      stejn instance serveru!
     </para>
    </warning>
   </refsect1>
  </refentry>

  <refentry id="function.fopen">
   <refnamediv>
    <refname>fopen</refname>
    <refpurpose>Oteve soubor nebo URL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fopen</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Jestlie <parameter>filename</parameter> zan "http://"
     (velkmi nebo malmi psmeny), je oteveno spojen na
     pslun server protokolem HTTP 1.0 a je vrcen deskriptor
     ukazujc na zatek tla dokumentu. Posl se hlavika
     'Host:' pro pstup k virtulnm serverm zaloenm na
     jmn.
    </simpara>
    <simpara>
     Nezpracovv HTTP pesmrovn, je teba vloit koncov
     lomtko za nzev adrese.
    </simpara>
    <simpara>     
     Kdy <parameter>filename</parameter> zan "ftp://" (velk
     i mal psmena), je otevena FTP relace na pslun server
     a vrcen deskriptor na poadovan soubor.  Pokud server
     nepodporuje pasivn reim FTP komunikace, sele to. Mete
     pes FTP otvrat soubory pro ten i zpis, ale ne pro oboj
     najednou.
    </simpara>
    <simpara>
     Kdy <parameter>filename</parameter> je bu "php://stdin",
     "php://stdout", nebo "php://stderr", bude oteven standardn
     vstup/vstup (stdio). (To plat od verze PHP 3.0.13;
     v dvjch verzch se mus pout nzvy jako "/dev/stdin"
     nebo "/dev/fd/0".)
    </simpara>
    <simpara>
     Kdy <parameter>filename</parameter> zan mkoli jinm,
     bude oteven obyejn soubor (z filesystmu) a vrcen
     jeho deskriptor.
    </simpara>
    <simpara>
     Pokud otvrn sele, funkce vrt &false;.
    </simpara>
    <para>
     <parameter>mode</parameter> me bt kterkoli z tchto:
     <itemizedlist>
      <listitem>
       <simpara>
        'r' - Otevt pouze pro ten; nastav ukazatel na zatek
        souboru.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'r+' - Otevt pro ten a zpis; nastav ukazatel na zatek
        souboru.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w' - Otevt pouze pro zpis; nastav ukazatel na zatek
        souboru a zkrt soubor na nulovou dlku. Pokud soubor
        neexistuje, pokus se ho vytvoit.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w+' - Otevt pro ten a zpis; nastav ukazatel na zatek
        souboru a zkrt soubor na nulovou dlku. Pokud soubor
        neexistuje, pokus se ho vytvoit.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a' - Otevt pouze pro zpis; nastav ukazatel na konec
        souboru, Pokud soubor neexistuje, pokus se ho vytvoit.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a+' -Otevt pro ten a zpis; nastav ukazatel na konec
        souboru. Pokud soubor neexistuje, pokus se ho vytvoit.
       </simpara>
      </listitem>
     </itemizedlist>
     <parameter>mode</parameter> me obsahovat psmeno 'b'.
     To je uiten pouze na systmech kter rozliuj mezi
     binrnmi a textovmi soubory (nikoli nap. na Unixu). 
     Pokud nen zapoteb, je ignorovn.
    </para>
    <para>
     Mete pout nepovinn tet parametr a nastavit ho na
     "1", pokud chcete hledat soubor tak v
     <link linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     <example>
      <title><function>fopen</function> pklad</title>
      <programlisting role="php">
$fp = fopen ("/home/rasmus/file.txt", "r");
$fp = fopen ("/home/rasmus/file.gif", "wb");
$fp = fopen ("http://www.php.net/", "r");
$fp = fopen ("ftp://user:password@example.com/", "w");
      </programlisting>
     </example>
    </para>
    <simpara>
	 Pokud jste zaznamenali problmy se tenm a zpisem do soubor
	 a pouvte PHP jako modul do serveru, nezapomete zajistit, aby
	 soubory a adrese, kter pouvte, byly pstupn pro serverov
	 proces.
    </simpara>
    <para>
	 Na Windows je teba oescapovat vechna zptn lomtka ve specifikaci
	 cesty k souboru nebo pouvat obyejn (dopedn) lomtka.
     <informalexample>
      <programlisting role="php">
$fp = fopen ("c:\\data\\info.txt", "r");
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Viz tak <function>fclose</function>,
     <function>fsockopen</function>,
     <function>socket_set_timeout</function>, a
     <function>popen</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fpassthru">
   <refnamediv>
    <refname>fpassthru</refname>
    <refpurpose>
	 Vype vechna zbvajc data v souboru
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fpassthru</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <simpara>
	 te a do dosaen konce souboru specifikovanho deskriptorem a
	 naten pepisuje na standardn vstup. 
    </simpara>
    <simpara>
     Pokud nastane chyba, funkce <function>fpassthru</function>
     vrac &false;.
    </simpara>
    <simpara>
	 Deskriptor souboru mus bt platn a mus ukazovat na soubor
     spn oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
     A funkce <function>fpassthru</function> ukon ten, zave soubor
     (deskriptor <parameter>fp</parameter> tm ztrc smysl).
    </simpara>
    <simpara>
	 Kdy chcete vypsat obsah souboru na standardn vstup (stdout),
	 mete pou funkci <function>readfile</function>, kter vs
     uet voln funkce <function>fopen</function>.
    </simpara>
    <simpara>
     Viz tak <function>readfile</function>,
     <function>fopen</function>, <function>popen</function>, a
     <function>fsockopen</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fputs">
   <refnamediv>
    <refname>fputs</refname>
    <refpurpose>Zape do souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fputs</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        length
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Funkce <function>fputs</function> je alias k
     <function>fwrite</function> a je s n tedy naprosto identick.
     Uvdomte si, e parametr <parameter>length</parameter> je nepovinn
     a pokud nen specifikovn, zape se cel etezec.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fread">
   <refnamediv>
    <refname>fread</refname>
    <refpurpose>Binrn bezpen ten ze souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>fread</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fread</function> pete nejve
     <parameter>length</parameter> byt ze souboru specifikovanho
     deskriptorem <parameter>fp</parameter>. ten kon, pokud je
     peteno <parameter>length</parameter> byt nebo je dosaen konec
     souboru (podle toho, co pijde dv).
    </simpara>
    <para>
     <informalexample>
      <programlisting role="php">
// nacte obsah souboru do retezce
$filename = "/usr/local/something.txt";
$fd = fopen ($filename, "r");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Viz tak <function>fwrite</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>,
     <function>fgets</function>, <function>fgetss</function>,
     <function>fscanf</function>, <function>file</function>, a
     <function>fpassthru</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fscanf">
   <refnamediv>
    <refname>fscanf</refname>
    <refpurpose>Parsuje vstup ze souboru podle formtu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>fscanf</methodname>
      <methodparam><type>int</type><parameter>handle</parameter></methodparam>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
     Funkce <function>fscanf</function> je podobn
     <function>sscanf</function>, ale nat ze souboru specifikovanho
     <parameter>handle</parameter> a interpretuje vstupn data podle
     specifikovanho formtu <parameter>format</parameter>. Pokud m
	 funkce pouze dva parametry, parsovan hodnoty bude vrceny jako pole. 
     Jinak, kdy jsou pouity nepovinn parametry, funkce vrac urit
	 poet asignovanch hodnot. Nepovinn parametry mus bt vloeny
	 odkazem. 
     <example>
      <title><function>fscanf</function> Pklad</title>
      <programlisting role="php">
$fp = fopen ("users.txt","r");
while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
    list ($name, $profession, $countrycode) = $userinfo;
    //... udelej neco s hodnotami
}
fclose($fp);
      </programlisting>
     </example>
     <example>
      <title>users.txt</title>
      <programlisting>
javier  argonaut        pe
hiroshi sculptor        jp
robert  slacker us
luigi   florist it
      </programlisting>
     </example>
    </para>
    <para>
     Viz tak <function>fread</function>, <function>fgets</function>,
     <function>fgetss</function>, <function>sscanf</function>,
     <function>printf</function>, a <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fseek">
   <refnamediv>
    <refname>fseek</refname>
    <refpurpose>Posouv ukazatel v souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fseek</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>offset</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Nastav ukazatel pozice v souboru specifikovan pomoc
     deskriptoru <parameter>fp</parameter>. Nov pozice, men
	 potem byt od zatku souboru, je zskna pitenm hodnoty
     <parameter>offset</parameter> k pozici specifikovan pomoc
     <parameter>whence</parameter>, jeho hodnota je definovanna:
     <simplelist>
      <member>SEEK_SET - Nastav na pozici rovnu
      <parameter>offset</parameter> byt.</member> <member>SEEK_CUR -
      Nastav pozici na souasnou plus poet byt v
      <parameter>offset</parameter>.</member> <member>SEEK_END - Nastav
      na konec souboru plus
      <parameter>offset</parameter> byt.</member>
     </simplelist>
    </para>
    <para>Pokud nen parametr <parameter>whence</parameter> specifikovn,
    pouije se SEEK_SET.
    </para>
    <para>
	 Pi spchu vrac 0, jinak -1. Pozn.: pesun za konec souboru
	 nen povaovn za chybu.
    </para>
    <para>
	 Nelze pout na deskriptor souboru vrcen funkc
     <function>fopen</function>, jestlie byl pouit formt "http://" nebo
	 "ftp://".
    </para>
    <note>
     <para>
      Argument <parameter>whence</parameter> byl pidn po verzi PHP 4.0 RC1.
     </para>
    </note>
    <para>
     Viz tak <function>ftell</function> a
     <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fstat">
   <refnamediv>
    <refname>fstat</refname>
    <refpurpose>
     Vrac informace o otevenm souboru
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>fstat</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Sbr statistiky otevenho souboru specifikovanm
	 deskriptorem <parameter>fp</parameter>. Tato funkce je
	 podobn funkci <function>stat</function>, pracuje
	 vak s deskriptorem, nikoli nzvem souboru.
    </para>
    <para>
     Vrac pole se statistikami souboru s tmito elementy:
     <orderedlist>
      <listitem><simpara>device</simpara></listitem>
      <listitem><simpara>inode</simpara></listitem>
      <listitem><simpara>number of links</simpara></listitem>
      <listitem><simpara>user id of owner</simpara></listitem>
      <listitem><simpara>group id owner</simpara></listitem>
      <listitem><simpara>device type if inode device *</simpara></listitem>
      <listitem><simpara>size in bytes</simpara></listitem>
      <listitem><simpara>time of last access</simpara></listitem>
      <listitem><simpara>time of last modification</simpara></listitem>
      <listitem><simpara>time of last change</simpara></listitem>
      <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem>
      <listitem><simpara>number of blocks allocated</simpara></listitem>
     </orderedlist>
     * - platn pouze na systmech s podporou typu st_blksize -- jinde
     (nap. na Windows) vrac -1</para>
    <para>
	 Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftell">
   <refnamediv>
    <refname>ftell</refname>
    <refpurpose>Vrac pozici v souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftell</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Vrac pozici v souboru odkazovanm deskriptorem fp; typicky
     offset ve streamu.
    </para>
    <para>
     Pokud nastane chyba, vrac &false;.
    </para>
    <para>
     Deskriptor souboru mus bt platn a mus ukazovat na soubor
     spn oteven pomoc <function>fopen</function>,
     <function>popen</function>, nebo <function>fsockopen</function>.
    </para>
    <para>
     Viz tak <function>fopen</function>, <function>popen</function>,
     <function>fseek</function> a <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftruncate">
   <refnamediv>
    <refname>ftruncate</refname>
    <refpurpose>
     Zkrt soubor na danou dlku
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftruncate</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Vezme soubor specifikovan pomoc <parameter>fp</parameter> a
	 zkrt ho na dlku <parameter>size</parameter>.
     Vrac &true; pi spchu a &false; pi chyb.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fwrite">
   <refnamediv>
    <refname>fwrite</refname>
    <refpurpose>Binrn bezpen zpis do souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>fwrite</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        length
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fwrite</function> zape obsah etzce
     <parameter>string</parameter> do souboru specifikovanho pomoc
     <parameter>fp</parameter>. Pokud je zde argument
	 <parameter>length</parameter>, zpis skon po zapsn
     <parameter>length</parameter> byt nebo pi dosaen konce
     etzce <parameter>string</parameter>, podle toho, co pijde
     dv.
    </simpara>
    <simpara>
     Pozn.: pokud je dn argument <parameter>length</parameter>, volba
     <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
     v konfiguraci bude ignorovna a nebudou odstraovna dn
	 lomtka z etzce <parameter>string</parameter>.
    </simpara>
    <simpara>
     Viz tak <function>fread</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>, a
     <function>fputs</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.set-file-buffer">
   <refnamediv>
    <refname>set_file_buffer</refname>
    <refpurpose>
     Nastav buffer pro soubor
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>set_file_buffer</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>buffer</parameter></methodparam>
     </methodsynopsis>
    <simpara>
	 Vstup pomoc  <function>fwrite</function> je implicitn bufferovn
	 do bufferu o velikosti 8 KB. To znamen, e kdy chtj dva procesy
	 zapisovat do tho streamu (souboru), kad je vdy po 8 KB peruen,
     aby ten druh mohl zapisovat. Funkce
	 <function>set_file_buffer</function>
     nastavuje buffering pro zpis pes dan deskriptor
     <parameter>fp</parameter> na <parameter>buffer</parameter> byt.
     Pokud je <parameter>buffer</parameter> roven 0, zpisy nejsou
     bufferovny. To zajiuje, e vechny zpisy jsou dokoneny
     dv, ne ostatn procesy mohou do souboru zapisovat.
    </simpara>
    <simpara>
	 Funkce vrac 0 pi spchu nebo EOF (konec souboru) pokud
	 poadavek neme bt uskutenn. 
    </simpara>
    <para>
	 Nsledujc pklad demonstruje, jak pouvat funkci
     <function>set_file_buffer</function> k vytvoen nebufferovanho
	 streamu.
     <example>
      <title><function>set_file_buffer</function> example</title>
      <programlisting role="php">
$fp=fopen($file, "w");
if($fp){
  set_file_buffer($fp, 0);
  fputs($fp, $output);
  fclose($fp);
}
      </programlisting>
     </example>
    </para>

    <simpara>
     Viz tak <function>fopen</function>, <function>fwrite</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.is-dir">
   <refnamediv>
    <refname>is_dir</refname>
    <refpurpose>Zjist, zda je dan soubor adresem</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_dir</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true; kdy soubor existuje a jedn se o adres.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_file</function> a
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-executable">
   <refnamediv>
    <refname>is_executable</refname>
    <refpurpose>Zjist, zda je soubor spustiteln</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_executable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true;, kdy soubor existuje a je spustiteln (provediteln)
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_file</function> a
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-file">
   <refnamediv>
    <refname>is_file</refname>
    <refpurpose>
     Zjist, zda se jedn o obyejn (regular) soubor
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true;, kdy soubor existuje a jedn se o obyejn (regular) soubor
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_dir</function> a
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-link">
   <refnamediv>
    <refname>is_link</refname>
    <refpurpose>
     Zjist, zda se jedn o symbolick odkaz (link)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_link</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true;, kdy soubor existuje a jedn se o symbolick odkaz (link).
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_dir</function> a
     <function>is_file</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.is-readable">
   <refnamediv>
    <refname>is_readable</refname>
    <refpurpose>
     Zjist, zda lze ze souboru st
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_readable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Vrac &true;, kdy soubor existuje a lze z nj st.
    </para>
    <para>
	 Mjte na pamti, e PHP me pistupovat k souboru s prvy,
	 ktermi disponuje WWW server (obvykle 'nobody'). Omezen
     bezpenho reimu (safe mode limitations) 
     are not taken into account.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_writable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writable">
   <refnamediv>
    <refname>is_writable</refname>
    <refpurpose>Zjist, zda lze do souboru zapisovat</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Vrac &true;, kdy soubor existuje a lze do nj zapisovat.
     Nzev souboru (argument filename) me bt nzev adrese,
	 potom se zjiuje, zda lze do adrese zapisovat.
    </para>
    <para>
     Mjte na pamti, e PHP me pistupovat k souboru s prvy,
	 ktermi disponuje WWW server (obvykle 'nobody'). Omezen
     bezpenho reimu (safe mode limitations) 
     are not taken into account.
    </para>
    <para>
     Vsledek tto funkce je cachovn. Vce detail - viz
     <function>clearstatcache</function>.
    </para>
    <para>
     Viz tak <function>is_readable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-uploaded-file">
   <refnamediv>
    <refname>is_uploaded_file</refname>
    <refpurpose>Zjist, zda byl soubor uploadovn pomoc HTTP POST</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>

    <para>
	 Tato funkce je dostupn pouze na verzch PHP 3 od 3.0.16
     a na verzch  PHP 4 od 4.0.2.
    </para>

    <para>
	 Vrac &true;, pokud soubor nazvan <varname>filename</varname>
     byl uploadovn pomoc HTTP POST. To je uiten k ujitn se,
	 zda se neukznn uivatel nepokusil upravit skript tak, aby
	 pracoval se soubory, se ktermi by pracovat neml -- napklad 
     <filename>/etc/passwd</filename>.
    </para>

    <para>
	 Tento druh test je zvlt dleit, je-li monost,
     e akce na uploadovanch souborech me zpstupnit jejich
	 obsah uivateli nebo jinm uivatekm tohoto systmu. 
    </para>

    <para>
     Viz tak <function>move_uploaded_file</function>, a sekce
     <link linkend="features.file-upload">Handling file uploads</link>,
     kde je pklad jednoduchho pouit.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.link">
   <refnamediv>
    <refname>link</refname>
    <refpurpose>Vytvo hard link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>link</methodname>
      <methodparam><type>string</type><parameter>target</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>link</function> vytvo hard link.</para>
    <para>
     Viz tak <function>symlink</function> pro vytven symbolickch link
     a <function>readlink</function> spolu s
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.linkinfo">
   <refnamediv>
    <refname>linkinfo</refname>
    <refpurpose>Vrac informaci o odkazu (linku)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>linkinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>linkinfo</function> vrac poloku st_dev field
     struktury UNIX C stat zskanou systmovm volnm lstat.
     Tato funkce se pouv pro oven, zda odkaz (specifikovan
     pomoc <parameter>path</parameter>) opravdu existuje (pouv se
	 tat metoda jako je makro S_ISLNK definovan v stat.h). Vrac 0,
	 v ppad chyby&false;.
    </para>
    <para>
     Viz tak <function>symlink</function>, <function>link</function>,
     a <function>readlink</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.mkdir">
   <refnamediv>
    <refname>mkdir</refname>
    <refpurpose>Vytvo adres</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>mkdir</methodname>
      <methodparam><type>string</type><parameter>pathname</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Pokus se vytvoit adres specifikovan svm nzvem.     
    </para>
    <para>	 
     Pozn.: Pravdpodobn chcete specifikovat md jako oktalov slo,
	 potom by vak mlo zanat nulou.
     <informalexample>
      <programlisting role="php">
mkdir ("/path/to/my/dir", 0700);
      </programlisting>
     </informalexample>
    </para>
    <para>
     Vrac &true; pi spchu a &false; pi chyb.
    </para>
    <para>
     Viz tak <function>rmdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.move-uploaded-file">
   <refnamediv>
    <refname>move_uploaded_file</refname>
    <refpurpose>Pesune uploadovan soubor na nov msto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>bool</type><methodname>move_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>string</type><parameter>destination</parameter></methodparam>
     </methodsynopsis>

    <para>
	 tato fuknce je dostupn pouze ve verzch PHP 3 od 3.0.16 a
	 ve verzch PHP 4 od 4.0.2.
    </para>

    <para>
	 Tato si ovuje, zda soubor identifikovan nzvem
     <parameter>filename</parameter> je platnm uploadovanm souborem
	 (prostednictvm HTTP POST mechanismu poskytovanho PHP).
	 Pokud je soubor platn, je pesunut/pejmenovn na
     <parameter>destination</parameter>.
    </para>

    <para>
     Pokud <parameter>filename</parameter> nen platn uploadovan soubor,
	 funkce <function>move_uploaded_file</function> nic neprovede a 
     vrt &false;.
    </para>

    <para>
     Pokud <parameter>filename</parameter> je platn uploadovan soubor,
	 ale z njakho dvodu neme bt pesunut, funkce
	 <function>move_uploaded_file</function> nic neprovede a vrt
     &false;. Navc je vygenerovno varovn (warning).
    </para>

    <para>
	 Tento druh test je zvlt dleit, je-li monost,
     e akce na uploadovanch souborech me zpstupnit jejich
	 obsah uivateli nebo jinm uivatekm tohoto systmu.
    </para>

    <para>
     Viz tak <function>is_uploaded_file</function>, a sekce
     <link linkend="features.file-upload">Handling file uploads</link>,
     kde je pklad jednoduchho pouit.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pclose">
   <refnamediv>
    <refname>pclose</refname>
    <refpurpose>Zave procesov soubor (rouru)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>pclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Zave rouru otevenou pomoc funkce
     <function>popen</function>.
    </para>
    <para>
     Deskriptor souboru mus bt platn a mus ukazovat na rouru spn
     otevenou pomoc <function>popen</function>.
    </para>
    <para>
	 Vrac nvratov kd procesu, kter na roue bel.
    </para>
    <para>
     Viz tak <function>popen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.popen">
   <refnamediv>
    <refname>popen</refname>
    <refpurpose>Oteve procesov soubor (rouru)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>popen</methodname>
      <methodparam><type>string</type><parameter>command</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Oteve rouru do procesu sputnho roztpenm stvajcho procesu
	 nslednm a sputnm programu specifikovanho parametrem
     <parameter>command</parameter>.
    </para>
    <para>
	 Vrac deskriptor souboru identick s tm, kter vrac funkce
     <function>fopen</function>, je vak vdy pouze jednosmrn
     (me bt oteven pro ten nebo zpis, nikoli souasn)
	 a na zvr mus bt zaven pomoc
     <function>pclose</function>. Tento deskriptor me bt pouit
	 funkcemi <function>fgets</function>, <function>fgetss</function>,
	 a <function>fputs</function>.
    </para>
    <para>
     Nastane-li chyba, vrac &false;.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
$fp = popen ("/bin/ls", "r");
      </programlisting>
     </informalexample>
    </para>
    <para>
     Viz tak <function>pclose</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readfile">
   <refnamediv>
    <refname>readfile</refname>
    <refpurpose>Vype soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>readfile</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <para>
	 Pete soubor a vype ho na standardn vstup.
    </para>
    <para>
	 Vrac poet byt petench ze souboru. Pokud nastane chyba,
	 vrt &false; a pokud nebyla pouita notace @readfile,
	 vype se chybov hlen.
    </para>
    <para>	
     Kdy <parameter>filename</parameter> zan "http://"
     (velkmi nebo malmi psmeny), oteve se spojen na pslun
	 server protokolem HTTP 1.0 a zskan dokument se vype na
	 standardn vstup.
    </para>
    <para>
	 Nezpracovv HTTP pesmrovn, je teba vloit koncov
     lomtko za nzev adrese.
    </para>
    <para>
	 Kdy <parameter>filename</parameter> zan "ftp://" (velk
     i mal psmena), je otevena FTP relace na pslun server
     a dokument se vype na standardn vstup.  Pokud server
     nepodporuje pasivn reim FTP komunikace, sele to.
    </para>
    <para>
	 Kdy <parameter>filename</parameter> zan mkoli jinm,
     bude oteven obyejn soubor (z filesystmu) a jeho obsah
	 vypsn na standardn vstup.
    </para>
    <para>
	 Mete pout nepovinn tet parametr a nastavit ho na
     "1", pokud chcete hledat soubor tak v
     <link linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     Viz tak <function>fpassthru</function>,
     <function>file</function>, <function>fopen</function>,
     <function>include</function>, <function>require</function>, a
     <function>virtual</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readlink">
   <refnamediv>
    <refname>readlink</refname>
    <refpurpose>Vrac cl symbolickho odkazu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>readlink</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>readlink</function> provd tot jako funkce
	readlink v C a vrac nzev souboru, na kter symbolick
	odkaz (link) ukazuje. Pi chyb vrac 0.
    </para>
    <para>
     Viz tak <function>symlink</function>,
     <function>readlink</function> a
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
     Tato funkce nefunguje na Windows systmech
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.rename">
   <refnamediv>
    <refname>rename</refname>
    <refpurpose>Pejmenuje soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>rename</methodname>
      <methodparam><type>string</type><parameter>oldname</parameter></methodparam>
      <methodparam><type>string</type><parameter>newname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokus se pejmenovat soubor <parameter>oldname</parameter> na
     <parameter>newname</parameter>.
    </para>
    <para>
     Vrac &true; pi spchu a &false; pi chyb.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rewind">
   <refnamediv>
    <refname>rewind</refname>
    <refpurpose>Vrt ukazatel v souboru na zatek</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>rewind</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Nastav pozici ukazatele v souboru specifikovan deskriptorem
	 <parameter>fp</parameter> na zatek tohoto souboru.
	</para>
	
	<para>
	 Nastane-li chyba, vrac 0.
	</para>
	
	<para>
	 Deskriptor souboru mus bt platn a mus ukazovat na soubor spn
     oteven pomoc <function>fopen</function>.
    </para>
    <para>
     Viz tak <function>fseek</function> a
     <function>ftell</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.rmdir">
   <refnamediv>
    <refname>rmdir</refname>
    <refpurpose>Odstran adres</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>rmdir</methodname>
      <methodparam><type>string</type><parameter>dirname</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Pokus se odstranit adres specifikovan svm nzvem. Adres
	 mus bt bt przdn a mt nastavena odpovdajc oprvnn.
    </para>
    <para>
     Nastane-li chyba, vrac 0.
    </para>
    <para>
     Viz tak <function>mkdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stat">
   <refnamediv>
    <refname>stat</refname>
    <refpurpose>Zjiuje informace o souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>stat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Sbr statistiky o souboru indentifikovanm nzvem
	 <parameter>filename</parameter>.
	</para>
    <para>
	 Vrac pole se statistikami souboru s tmito elementy:
     <orderedlist>
      <listitem><simpara>device</simpara></listitem>
      <listitem><simpara>inode</simpara></listitem>
      <listitem><simpara>inode protection mode</simpara></listitem>
      <listitem><simpara>number of links</simpara></listitem>
      <listitem><simpara>user id of owner</simpara></listitem>
      <listitem><simpara>group id owner</simpara></listitem>
      <listitem><simpara>device type if inode device *</simpara></listitem>
      <listitem><simpara>size in bytes</simpara></listitem>
      <listitem><simpara>time of last access</simpara></listitem>
      <listitem><simpara>time of last modification</simpara></listitem>
      <listitem><simpara>time of last change</simpara></listitem>
      <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem>
      <listitem><simpara>number of blocks allocated</simpara></listitem>
     </orderedlist>
     * - platn pouze na systmechs podporou typu st_blksize -- jinde
     (nap. na Windows) vrt -1</para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.lstat">
   <refnamediv>
    <refname>lstat</refname>
    <refpurpose>
     Zjiuje informace o souboru nebo symbolickm odkazu
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>array</type><methodname>lstat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Sbr statistiky o souboru nebo symbolickm odkazu (linku)
	 identifikovanm pomoc nzvu <parameter>filename</parameter>.
     Tato funkce je identick s funkc
     <function>stat</function>, s vjimkou situace, kdy parametrem 
     <parameter>filename</parameter> je symbolick odkaz -- tehdy
	 jsou vrceny informace o odkazu, nikoli o souboru, na kter
	 ukazuje. 
    </para>
    <para>
     Vrac pole se statistikami souboru s tmito elementy:
     <orderedlist>
      <listitem><simpara>device</simpara></listitem>
      <listitem><simpara>inode</simpara></listitem>
      <listitem><simpara>inode protection mode</simpara></listitem>
      <listitem><simpara>number of links</simpara></listitem>
      <listitem><simpara>user id of owner</simpara></listitem>
      <listitem><simpara>group id owner</simpara></listitem>
      <listitem><simpara>device type if inode device *</simpara></listitem>
      <listitem><simpara>size in bytes</simpara></listitem>
      <listitem><simpara>time of last access</simpara></listitem>
      <listitem><simpara>time of last modification</simpara></listitem>
      <listitem><simpara>time of last change</simpara></listitem>
      <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem>
      <listitem><simpara>number of blocks allocated</simpara></listitem>
     </orderedlist>
     * - platn pouze na systmechs podporou typu st_blksize -- jinde
     (nap. na Windows) vrt -1</para>
    <para>
     Vsledek tto funkce je cachovn. Vce informac - viz
     <function>clearstatcache</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.realpath">
   <refnamediv>
    <refname>realpath</refname>
    <refpurpose>Vrt absolutn cestu v kanonickm tvaru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>realpath</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>realpath</function> zpracuje vechny symbolick odkazy
	 a vyhodnot odkazy na '/./', '/../' a samostatn znaky '/' 
	 v parametru <parameter>path</parameter> a vrac absolutn  
	 cestu v kanonickm tvaru. Tato vsledn cesta neobsahuje
	 symbolick odkazy a komponenty typu '/./' or '/../'.
    </para>
    <para>
     <example>
      <title><function>realpath</function> pklad</title>
      <programlisting role="php">
$real_path = realpath ("../../index.php");
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.symlink">
   <refnamediv>
    <refname>symlink</refname>
    <refpurpose>Vytvo symbolick odkaz</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>symlink</methodname>
      <methodparam><type>string</type><parameter>target</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>symlink</function> vytvo symbolick odkaz (link)
     k existujcmu souboru <parameter>target</parameter> a nazve
     ho <parameter>link</parameter>.
    </para>
    <para>
     Viz tak <function>link</function> -- vytven hard link,
     a <function>readlink</function> spolen s
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
      Tato funkce nefunguje na Windows systmech.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.tempnam">
   <refnamediv>
    <refname>tempnam</refname>
    <refpurpose>Vytvo soubor s uniktnm nzvem</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>tempnam</methodname>
      <methodparam><type>string</type><parameter>dir</parameter></methodparam>
      <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
     </methodsynopsis>
    <para>
	 Ve specifikovanm adresi vytvo doasn soubor s uniktnm
	 nzvem. Pokud adres neexistuje, <function>tempnam</function>
	 me vytvoit soubor v systmovm adresi pro doasn soubory.
    </para>
    <para>
	 Chovn funkce <function>tempnam</function> je zvisl na
	 platform. Na Windows m parametr <parameter>dir</parameter>
	 pednost ped systmovou promnnou TMP, na Linuxu m pedost
	 promnn TMPDIR a SVR4 vdy pouije parametr
	 <parameter>dir</parameter>, pokud tento adres existuje.
	 Podvejte se do dokumentace k vaemu systmu na funkci
	 tempnam(3).
    </para>
    <para>
	 Vrac nzev novho doasnho souboru, pi chyb pak etzec
	 &null;.
     <example>
      <title><function>tempnam</function> pklad</title>
      <programlisting role="php">
$tmpfname = tempnam ("/tmp", "FOO");
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
	  Chovn tto funkce bylo zmnno ve verzi 4.0.3. 
      The temporary file is also
      created to avoid a race condition where the file might appear in the
      filesystem between the time the string was generated and before the
      the script gets around to creating the file.
     </simpara>
    </note>
    <para>
     Viz tak <function>tmpfile</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.tmpfile">
   <refnamediv>
    <refname>tmpfile</refname>
    <refpurpose>Vytvo doasn soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>tmpfile</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Vytvo doasn soubor s uniktnm nzvem, v mdu zpisu,
	 a vrac deskriptor tohoto souboru podobn jako
	 <function>fopen</function>. Soubor se pi zaven (pomoc
	 <function>fclose</function>) nebo pi ukonen skriptu
	 automaticky smae.
    </para>
    <para>
     Detaily viz systmov dokumentace k funkci
     <literal>tmpfile(3)</literal> a soubor <filename>stdio.h</filename>.
    </para>
    <para>
     Viz tak <function>tempnam</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.touch">
   <refnamediv>
    <refname>touch</refname>
    <refpurpose>Nastavit as zmny souboru</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>touch</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
         time
        </parameter></methodparam>
     </methodsynopsis>
    <para>
     Pokus se nastavit as zmnu souboru <parameter>filename</parameter> na
     <parameter>time</parameter>. Pokud <parameter>filename</parameter> nen
     ptomen, pouije se aktuln as.
    </para>
    <para>
     Pokud tento soubor neexistuje, vytvo se.
    </para>
    <para>
     Pi spchu vrac &true;, jinak &false;.
     <example>
      <title>Ukzka <function>touch</function></title>
      <programlisting role="php">
if (touch ($FileName)) {
    print "$FileName modification time has been
           changed to todays date and time";
} else {
    print "Sorry Could Not change modification time of $FileName";
}
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.umask">
   <refnamediv>
    <refname>umask</refname>
    <refpurpose>Zmn souasn nastaven umask</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>umask</methodname>
      <methodparam><type>int</type><parameter>mask</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>umask</function> nastav umask PHP na &amp; 0777 a
	 vrt star nastaven umask. Pokud PHP b jako modul serveru,
	 je star nastaven obnoveno po ukonen kadho HTTP poadavku. 
    </para>
    <para>
     <function>umask</function> bez parametr vrac souasn
	 nastaven umask.
    </para>
    <note>
     <simpara>
      Tato funkce nemus na Windows fungovat
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.unlink">
   <refnamediv>
    <refname>unlink</refname>
    <refpurpose>Smazat soubor</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>unlink</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Smae <parameter>filename</parameter>. Podobn Unixov C funkci unlink().
    </para>
    <para>
     Pi chyb vrac 0 nebo &false;.
    </para>
    <para>
     Viz tak <function>rmdir</function> pro mazn adres.
    </para>
    <note>
     <simpara>
      Tato funkce nemus na Windows fungovat
     </simpara>
    </note>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
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:
-->