<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.115 Maintainer: adi Status: partial -->
<!-- $Revision: 1.11 $ -->
 <reference id="ref.filesystem">
  <title>System plikw</title>
  <titleabbrev>System plikw</titleabbrev>

  <refentry id="function.basename">
   <refnamediv>
    <refname>basename</refname>
    <refpurpose>
     Zwraca nazw pliku, bdcego skadow cieki
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>basename</methodname>
      <methodparam><type>string</type><parameter>cieka</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>przyrostek</parameter></methodparam>
     </methodsynopsis>
    <para>
     Z podanego acucha zawierajcego ciek do pliku, funkcja
     zwraca sam nazw pliku.
     Jeli koniec nazwy pliku pasuje do parametru <parameter>przyrostek</parameter>
     to zostanie on take obcity.
    </para>
    <para>
     W Windows jako separator cieki uywany jest znak slash
     (<literal>/</literal>) i backslash (<literal>\</literal>).  W
     innych rodowiskach jest to slash (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title><function>basename</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$path = "/home/httpd/html/index.php";
$file = basename ($path);        // $file zawiera "index.php"
$file = basename ($path,".php"); // $file zawiera "index"
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Parametr <parameter>przyrostek</parameter> zosta dodany w PHP 4.1.0.
     </para>
    </note>
    <para>
     Patrz take: <function>dirname</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chgrp">
   <refnamediv>
    <refname>chgrp</refname>
    <refpurpose>Zmienia grup pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>chgrp</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>grupa</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dokonuje zmiany grupy pliku podanego w parametrze <parameter>nazwa_pliku</parameter>
     na wybran parametrem <parameter>grupa</parameter> (okrelon przez nazw lub numer).
     Tylko super uytkownik moe zmieni dowolnie grup pliku; inni uytkownicy mog
     zmieni grup pliku na dowoln grup, ktrej czonkiem jest ten uytkownik.
    </para>
    <para>
     Zwraca &true; gdy sukces; w przeciwnym wypadku zwraca &false;.
    </para>
    <para>
     Patrz take <function>chown</function> i
          <function>chmod</function>.
    </para>
 &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.chmod">
   <refnamediv>
    <refname>chmod</refname>
    <refpurpose>Zmienia prawa dostpu do pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>chmod</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam><type>int</type><parameter>prawa</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dokonuje zmiany praw pliku podanego w parametrze
     <parameter>nazwa_pliku</parameter> na podane w
     <parameter>prawa</parameter>.
    </para>
    <para>
     Pamitaj, e parametr <parameter>prawa</parameter> nie jest
     automatycznie zastpowany wartoci oktaln, wic acuchy
     (takie jak "g+w") nie bd poprawnie interpretowane.
     Aby zapewni poprawno operacji musisz parametr
     <parameter>prawa</parameter> poprzedzi prefixem zero (0):
     <informalexample>
      <programlisting role="php">
<![CDATA[
chmod ("/katalog/plik", 755);   // dziesitnie; prawdopodobnie nieprawidowo
chmod ("/katalog/plik", "u+rwx,go+rx"); // acuch; nieprawidowo
chmod ("/katalog/plik", 0755);  // semkowo; poprawna warto dla praw
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Zwraca &true; gdy sukces i &false; w przeciwnym wypadku.
    </para>
    <para>
     Patrz take <function>chown</function> i
     <function>chgrp</function>.
    </para>
 &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.chown">
   <refnamediv>
    <refname>chown</refname>
    <refpurpose>Zmienia waciciela pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>chown</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>uytkownik</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dokonuje zmiany waciciela pliku nazwa_pliku na uytkownika
     podanego w parametrze uytkownik (okrelonego przez nazw lub numer).
     Tylko super uytkownik moe zmieni waciciela pliku.
    </para>
    <para>
      Zwraca &true; gdy sukces; w przeciwnym wypadku zwraca &false;.
    </para>
    <para>
     Patrz take <function>chown</function> i
     <function>chmod</function>.
    </para>
     &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.clearstatcache">
   <refnamediv>
    <refname>clearstatcache</refname>
    <refpurpose>Czyci cache statystki pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>void</type><methodname>clearstatcache</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Wywoywanie systemowych <systemitem>stat</systemitem> lub
     <systemitem>lstat</systemitem> w wikszoci systemw jest
     zbyt kosztowne. Dlatego, wynik ostatniego wywoania kadej z funkcji
     statusowej (przedstawionej poniej) jest przechowywany do wykorzystania
     go przy nastpnym wywoaniu funkcji z t sam nazw pliku.
     Jeli chcesz wymusi ponowne sprawdzenie statusu, pliku ktry jest
     sprawdzany wielokrotnie i mg si zmieni lub znikn, uyj tej
     funkcji aby wyczyci wyniki ostatniego wywoania tych funkcji z pamici.
    </para>
    <para>
     Te wartoci s cachowane tylko przez czas dziaania pojedynczego wywoania.
    </para>
    <para>
     Dotyczy funkcji <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> i
     <function>fileperms</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.copy">
   <refnamediv>
    <refname>copy</refname>
    <refpurpose>Kopiuje plik</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>copy</methodname>
      <methodparam><type>string</type><parameter>rdo</parameter></methodparam>
      <methodparam><type>string</type><parameter>przeznaczenie</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tworzy kopi pliku. Zwraca &true; jeli kopiowanie powiodo si,
     &false; w przeciwnym przypadku.
     <example>
      <title><function>copy</function> przykad</title>
      <programlisting role="php">
<![CDATA[
if (!copy($file, $file.'.bak')) {
    print ("Kopiowanie pliku nie powiodo si...<br>\n");
}
]]>
      </programlisting>
     </example>
    </para>
    <warning>
     <para>
      Jeli docelowy plik istnieje to zostanie nadpisany.
     </para>
    </warning>
    <para>
     Patrz take: <function>move_uploaded_file</function>,
     <function>rename</function>, i cz podrcznika dotyczca
     <link linkend="features.file-upload">obsugi uploadowanych plikw</link>.

    </para>
   </refsect1>
  </refentry>

  <refentry id="function.delete">
   <refnamediv>
    <refname>delete</refname>
    <refpurpose>lepy wpis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>void</type><methodname>delete</methodname>
      <methodparam><type>string</type><parameter>plik</parameter></methodparam>
     </methodsynopsis>
    <para>
     To jest lepy wpis aby zadowoli ludzi ktrzy szukaj
     <function>unlink</function> lub
     <function>unset</function> w nie waciwym miejscu.
    </para>
    <para>
     Patrz take: <function>unlink</function> do kasowania plikw,
     <function>unset</function> do kasowania zmiennych.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dirname">
   <refnamediv>
    <refname>dirname</refname>
    <refpurpose>Zwraca nazw katalogu, bdcego skadow cieki</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>dirname</methodname>
      <methodparam><type>string</type><parameter>cieka</parameter></methodparam>
     </methodsynopsis>
    <para>
     Z podanego acucha zawierajcego ciek do pliku, funkcja ta
     zwrci nazw katalogu.
     </para>
    <para>
     W Windows jako separator cieki uywany jest znak slash
     (<literal>/</literal>) i backslash (<literal>\</literal>).  W
     innych rodowiskach jest to slash (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title><function>dirname</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$path = "/etc/passwd";
$file = dirname ($path); // $file zawiera "/etc"
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take: <function>basename</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-free-space">
   <refnamediv>
    <refname>disk_free_space</refname>
    <refpurpose>Zwraca ilo wolnego miejsca w katalogu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_free_space</methodname>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para>
     Podajc acuch zawierajcy katalog, funkcja zwrci ilo wolnego
     miejsca (w bajtach) w odpowiadajcym mu systemie plikw lub
     partycji dysku.
    </para>
    <para>
     <example>
      <title><function>disk_free_space</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$df = disk_free_space("/"); // $df zawiera ilo wolnego (w bajtach) miejsca
                          // w "/"
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.diskfreespace">
   <refnamediv>
    <refname>diskfreespace</refname>
    <refpurpose>Alias do <function>disk_free_space</function></refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>float</type><methodname>diskfreespace</methodname>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para>
     To jest odradzany alias do
     <function>disk_free_space</function>.
     Uyj tej funkcji zamiast niego.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-total-space">
   <refnamediv>
    <refname>disk_total_space</refname>
    <refpurpose>Zwraca cakowity rozmiar katalogu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_total_space</methodname>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para>
     Podajc acuch zawierajcy katalog, funkcja ta zwrci
     cakowity rozmiar (w bajtach) w odpowiadajcym mu systemie plikw
     lub partycji dysku.
    </para>
    <para>
     <example>
      <title><function>disk_total_space</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$df = disk_total_space("/"); // $df zawiera cakowit liczb bajtw
                             // dostpn w "/"
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fclose">
   <refnamediv>
    <refname>fclose</refname>
    <refpurpose>Zamyka otwarty wskanik pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>fclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Wskanik pliku <parameter>fp</parameter> jest zamykany.
    </para>
    <para>
     &return.success;
    </para>
    <para>
     Wskanik pliku musi by poprawny i musi wskazywa na plik
     poprawnie otwarty przez <function>fopen</function> lub
     <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.feof">
   <refnamediv>
    <refname>feof</refname>
    <refpurpose>Sprawdza czy wskanik pliku jest na kocu pliku (EOF)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>feof</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca &true; jeli wskanik pliku jest na EOF lub gdy zdarzy si bd;
     w przeciwnym wypadku zwraca &false;.
    </para>
    <para>
     Wskanik pliku musi by poprawny i musi wskazywa na plik
     poprawnie otwarty przez <function>fopen</function>,
     <function>popen</function> lub <function>fsockopen</function>.
   </para>
   </refsect1>
  </refentry>

  <refentry id="function.fflush">
   <refnamediv>
    <refname>fflush</refname>
    <refpurpose>Flushes the output to a file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>fflush</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     This function forces a write of all buffered output to the
     to the resource pointed to by the file handle
     <parameter>fp</parameter>. Returns &true; if succesful, &false;
     otherwise.
    </para>
    <para>
     The file pointer must be valid, and must point to a file
     successfully opened by <function>fopen</function>,
     <function>popen</function>, or <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetc">
   <refnamediv>
    <refname>fgetc</refname>
    <refpurpose>Pobiera znak ze wskanika pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetc</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca acuch zawierajcy pojedynczy znak odczytany z
     pliku wskazanego przez fp.
     Zwraca &false; gdy EOF (koniec pliku).
    </para>
    <para>
     Wskanik pliku musi by poprawny i musi wskazywa na plik
     poprawnie otwarty przez <function>fopen</function> lub
     <function>fsockopen</function>.
   </para>
    <para>
     Patrz take <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fsockopen</function> i
     <function>fgets</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetcsv">
   <refnamediv>
    <refname>fgetcsv</refname>
    <refpurpose>
     Pobiera lini ze wskanika pliku i przetwarza na pola CSV
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>fgetcsv</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>dugo</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        delimiter
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Dziaa podobnie do <function>fgets</function> tylko, e
     <function>fgetcsv</function> przetwarza odczytan lini na pola
     w formacie <acronym>CSV</acronym> i zwraca tablic zawierajc
     odczytane pola.  Delimiterem pl jest przecinek, chyba e
     okrelisz inny delimiter w opcjonalnym 3 parametrze.
    </simpara>
    <simpara>
     <parameter>Fp</parameter> musi by poprawnym wskanikiem do pliku
     poprawnie otworzonym przez <function>fopen</function> lub
     <function>fsockopen</function>.
    </simpara>
    <simpara>
     Dugo musi by wiksza ni najdusza linia znajdujca si
     w pliku CSV (wliczajc w to znaki koca linii).
    </simpara>
    <simpara>
     <function>fgetcsv</function> zwraca &false; gdy wystpi bd, wczajc
     w to koniec pliku.
    </simpara>
    <simpara>
     Nota bene. Pusta linia w pliku CSV zostanie zwrcona jako tablica
     skadajca si z pojedynczego pola &null; i nie zostanie potraktowana
     jako bd.
    </simpara>
    <example>
     <title>
      <function>fgetcsv</function> przykad - Odczyt i wywietlenie caej
      zawartoci pliku CSV
     </title>
     <programlisting role="php">
<![CDATA[
$row = 1;
$fp = fopen ("test.csv","r");
while ($data = fgetcsv ($fp, 1000, ",")) {
    $num = count ($data);
    print "<p> $num pola w linii $row: <br>";
    $row++;
    for ($c=0; $c < $num; $c++) {
        print $data[$c] . "<br>";
    }
}
fclose ($fp);
]]>
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.fgets">
   <refnamediv>
    <refname>fgets</refname>
    <refpurpose>Pobiera lini ze wskanika pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgets</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>dugo</parameter></methodparam>
      </methodsynopsis>
    <para>
     Zwraca acuch o dugoci - 1 bajtw odczytany z pliku wskazanego
     przez fp. Czytanie koczy si kiedy przeczytano dugo - 1 bajtw
     lub gdy wystpi znak nowej linii (jest on doczany do zwracanego
     wyniku) lub gdy wystpi znak koca pliku EOF (ktrykolwiek
     przypadek zdarzy si pierwszy). Jeli nie zostaa okrelona dugo,
     domylnie przyjmuje 1k (1024 bajty).
    </para>
    <para>
     W przypadku bdu, zwraca &false;.
    </para>
    <para>
     Gwna puapka:
    </para>
    <simpara>
     Osoby uywajce semantyki 'C' z fgets powinni zauway rnic
     w sposobie zwracania EOF.
    </simpara>
    <simpara>
     Wskanik pliku musi by poprawny i musi wskazywa na plik
     poprawnie otwarty przez <function>fopen</function>,
     <function>popen</function> lub
     <function>fsockopen</function>.
   </simpara>
    <para>
     Prosty przykad:
     <example>
      <title>Czytanie pliku linia po linii</title>
      <programlisting role="php">
<![CDATA[
$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fgetc</function>,
     <function>fsockopen</function> i
     <function>socket_set_timeout</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetss">
   <refnamediv>
    <refname>fgetss</refname>
    <refpurpose>
     Pobiera lini ze wskanika pliku i usuwa tagi HTML
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetss</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>dugo</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        dozwolone_tagi
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Dziaa identycznie jak <function>fgets</function>, tylko e fgetss
     dokonuje usunicia wszystkich tagw HTML i PHP z tektu, ktry
     przeczyta.
    </para>
    <para>
     Moesz okreli opcjonalny 3 parametr aby wyszczeglni tagi, ktre
     nie powinny zosta usunite.
     <note>
      <para>
       <parameter>dozwolone_tagi</parameter> zosta dodany w PHP 3.0.13,
       PHP4B3.
      </para>
     </note>
    </para>
    <para>
     Patrz take <function>fgets</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function> i
     <function>strip_tags</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.file">
   <refnamediv>
    <refname>file</refname>
    <refpurpose>Czyta ca zawarto pliku do tablicy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>file</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>uyj_include_path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dziaa identycznie jak <function>readfile</function>, tylko e
     <function>file</function> zwraca plik w tablicy. Kady
     element tablicy odpowiada linii w pliku. Elementy tablicy zawieraj
     znak nowej linii.
    </para>
    <note>
     <para>
     Kada linia w wynikowej tabeli zawiera znak nowej lini, jeli chcesz
     si ich pozby to musisz uy <function>trim</function>.
     </para>
    </note>
    <para>
     Moesz uy opcjonalnego 2 parametru i ustawi go na "1", jeli
     chcesz szuka pliku take w
     <link linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
<?php
// pobiera stron WWW do tablicy i wywietla j
$fcontents = file ('http://www.php.net/');
while (list ($line_num, $line) = each ($fcontents)) {
    echo "<b>Linia $line_num:</b>; ", htmlspecialchars ($line), "<br>\n";
}

// pobiera stron WWW i zapisuje do acucha
$fcontents = join ('', file ('http://www.php.net/'));
?>
]]>
      </programlisting>
     </informalexample>
    </para>
    &note.not-bin-safe;
    &tip.fopen-wrapper;
    <para>
     Patrz take <function>readfile</function>,
     <function>fopen</function>, <function>fsockopen</function> i
     <function>popen</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.file-exists">
   <refnamediv>
    <refname>file_exists</refname>
    <refpurpose>Sprawdza czy plik istnieje</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>file_exists</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Zwraca &true; jeli podany plik w parametrze
     <parameter>nazwa_pliku</parameter> istnieje; &false; w przeciwnym wypadku.
    </simpara>
    <simpara>
     Ta funkcja nie dziaa <link
     linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    <simpara>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </simpara>
   </refsect1>
  </refentry>


  <refentry id="function.fileatime">
   <refnamediv>
    <refname>fileatime</refname>
    <refpurpose>Pobiera ostatni czas dostpu do pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileatime</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Zwraca czas, kiedy nastpi ostatni dostp do pliku lub &false; w
     przypadku bdu. Czas jest zwracany w postaci unix'owego znacznika
     czasu.
     </simpara>
    <simpara>
      Wyniki tej funkcji s cachowane. Zobacz
      <function>clearstatcache</function> aby uzyska wicej szczegw.
    </simpara>
    <simpara>
     Notka: Czas dostpu do pliku przypuszczalnie zmienia si
     zawsze kiedy bloki danych pliku s odczytywane. To moe
     kosztowa utrat wydajnoci aplikacji, ktra regularnie
     korzystaj z wielu plikw lub katalogw. Niektre unix'owe
     systemy plikw mog by montowane z wyczonym uaktualnianiem
     czasu dostpu, aby podnie wydajno takich aplikacji;
     USENETowy katalog roboczy wiadomoci s powszechnym przykadem.
     Na takich systemach plikw ta funkcja bdzie bezuyteczna.
    </simpara>
    <simpara>
     Ta funkcja nie dziaa <link
     linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filectime">
   <refnamediv>
    <refname>filectime</refname>
    <refpurpose>Gets inode change time of file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>filectime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Returns the time the file was last changed, or &false; in case of
     an error. The time is returned as a Unix timestamp.
    </para>
    <para>
     The results of this function are cached. See
     <function>clearstatcache</function> for more details.
    </para>
    <para>
     Note: In most Unix filesystems, a file is considered
     changed when its inode data is changed; that is, when
     the permissions, owner, group, or other metadata
     from the inode is updated. See also
     <function>filemtime</function> (which is what you want to use
     when you want to create "Last Modified" footers on web pages) and
     <function>fileatime</function>.
    </para>
    <para>Note also that in some Unix texts the ctime of a file is
     referred to as being the creation time of the file. This is wrong.
     There is no creation time for Unix files in most Unix filesystems.
    </para>
    <simpara>
     This function will not work on <link
     linkend="features.remote-files">remote files</link>; the file to
     be examined must be accessible via the server's filesystem.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filegroup">
   <refnamediv>
    <refname>filegroup</refname>
    <refpurpose>Pobiera grup pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>filegroup</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca identyfikator grupy do ktrej naley waciciel pliku lub
     &false; w przypadku bdu. Identyfikator grupy zwracany jest
     w postaci numerycznej, uyj
     <function>posix_getgrgid</function> aby rozwin go w nazw grupy.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    &note.no-windows;
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fileinode">
   <refnamediv>
    <refname>fileinode</refname>
    <refpurpose>Pobiera i-wze pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileinode</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca numer i-wza pliku lub &false; w przypadku bdu.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.filemtime">
   <refnamediv>
    <refname>filemtime</refname>
    <refpurpose>Pobiera czas ostatniej modyfikacji pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>filemtime</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca czas, kiedy plik by ostatnio modyfikowany lub &false; w przypadku
     bdu. Czas jest zwracany w postaci unix'owego znacznika czasu.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    <para>Notka: Ta funkcja zwraca czas kiedy bloki danych pliku zostay
     zapisane, to jest, czas kiedy zawarto pliku zostaa zmieniona.
     Uyj <function>date</function> na wyniku tej funkcji aby otrzyma
     czyteln dat modyfikacji do uycia jej w stopkach stron.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fileowner">
   <refnamediv>
    <refname>fileowner</refname>
    <refpurpose>Pobiera waciciela pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileowner</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca identyfikator uytkownika, ktry jest wacicielem pliku, lub
     &false; w przypadku bdu. Identyfikator uytkownika zwracany jest
     w postaci numerycznej, uyj
     <function>posix_getpwuid</function> aby rozwin go w nazw uytkownika.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.fileperms">
   <refnamediv>
    <refname>fileperms</refname>
    <refpurpose>Pobiera prawa dostpu pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>fileperms</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca prawa dostpu pliku, lub &false; w przypadku bdu.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filesize">
   <refnamediv>
    <refname>filesize</refname>
    <refpurpose>Pobiera rozmiar pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>filesize</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca rozmiar pliku w bajtach, lub &false; w przypadku bdu.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filetype">
   <refnamediv>
    <refname>filetype</refname>
    <refpurpose>Pobiera typ pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>filetype</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca typ pliku. Moliwe wartoci to fifo, char, dir, block,
     link, file, and unknown.</para> <para> Zwraca &false;
     w przypadku bdu.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.flock">
   <refnamediv>
    <refname>flock</refname>
    <refpurpose>Portable advisory file locking</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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 supports a portable way of locking complete files in an
     advisory way (which means all accessing programs have to use the
     same way of locking or it will not work).
    </simpara>
    <simpara>
     <function>flock</function> operates on <parameter>fp</parameter>
     which must be an open file
     pointer. <parameter>operation</parameter> is one of the following
     values:
    </simpara>
    <para>
     <itemizedlist>
      <listitem>
       <simpara>
         To acquire a shared lock (reader), set
         <parameter>operation</parameter> to LOCK_SH (set to 1 prior to
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         To acquire an exclusive lock (writer), set
         <parameter>operation</parameter> to LOCK_EX (set to 2 prior to
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         To release a lock (shared or exclusive), set
         <parameter>operation</parameter> to LOCK_UN (set to 3 prior to
         PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         If you don't want <function>flock</function> to block while
         locking, add LOCK_NB (4 prior to PHP 4.0.1) to
         <parameter>operation</parameter>.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <simpara>
     <function>flock</function> allows you to perform a simple
     reader/writer model which can be used on virtually every platform
     (including most Unix derivatives and even Windows).  The optional third
     argument is set to &true; if the lock would block (EWOULDBLOCK
     errno condition)
    </simpara>
    <simpara>
     <function>flock</function> returns &true; on success and &false; on
     error (e.g. when a lock could not be acquired).
    </simpara>
    <note>
     <para>
      Because <function>flock</function> requires a file pointer, you may have
      to use a special lock file to protect access to a file that you intend
      to truncate by opening it in write mode (with a "w" or "w+" argument to
      <function>fopen</function>).
     </para>
    </note>
    <warning>
     <para>
      <function>flock</function> will not work on NFS and many other networked
      file systems. Check your operating system documentation for more
      details.
     </para>
     <para>
      On some operating systems <function>flock</function> is implemented at
      the process level. When using a multithreaded server API like ISAPI you
      may not be able to rely on <function>flock</function> to protect files
      against other PHP scripts running in parallel threads of the same server
      instance!
     </para>
    </warning>
   </refsect1>
  </refentry>

  <refentry id="function.fopen">
   <refnamediv>
    <refname>fopen</refname>
    <refpurpose>Otwiera plik lub URL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>fopen</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam><type>string</type><parameter>tryb</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        uyj_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Jeli <parameter>nazwa_pliku</parameter> zaczyna si od "http://" (nie
     jest rozrniana wielo liter), jest otwierane poczenie HTTP 1.0
     do wybranego serwera, strona jest dana uywajc metody HTTP GET
     i wskanik pliku jest ustawiany na pocztku ciaa odpowiedzi.
     Nagwek 'Host:' jest wysyany z daniem pozwalajcym
     uchwyci oparte o nazw wirtualne hosty.
    </simpara>
    <simpara>
     Zauwa, e wskanik pliku pozwala tobie wydoby tylko
     <emphasis>ciao</emphasis> odpowiedzi; Nie moesz
     dosta si do nagwka HTTP uywajc tej funkcji.
    </simpara>
    <simpara>
     Wersje przed PHP 4.0.5 nie obsuguj przekierowa HTTP. Z tego powodu
     katalogi musz zawiera koczce slashe.
    </simpara>
    <simpara>
     Jeli <parameter>nazwa_pliku</parameter> zaczyna si od "ftp://"
     (nie jest rozrniana wielko znakw), jest otwierane poczenie
     ftp do podanego serwera i zwracany jest wskanik do danego pliku.
     jeli serwer nie obsuguje trybu pasywnego ftp, ta funkcja zawiedzie.
     Moesz otwiera pliki albo do odczytu lub zapisu przez ftp (ale nie
     oba tryby rwnoczenie).
    </simpara>
    <simpara>
     Jeli <parameter>nazwa_pliku</parameter> jest jedn z moliwoci
     "php://stdin", "php://stdout" lub "php://stderr" zostanie otworzony
     odpowiedni strumie stdio.  (To zostao wprowadzone w PHP 3.0.13;
     w wczeniejszych wersjach, aby dosta si do strumienia stdio
     nazwa_pliku musi mie posta "/dev/stdin" lub "/dev/fd/0".)
    </simpara>
    <simpara>
     Jeli <parameter>nazwa_pliku</parameter> zaczyna si czymkolwiek innym
     zostanie otworzony plik z systemu plikw i zostanie zwrcony wskanik
     pliku.
    </simpara>
    <simpara>
     Jeli otwieranie zwiedzie, funkcja zwrci &false;.
    </simpara>
    <para>
     <parameter>tryb</parameter> moe by dowolny z poniszych:
     <itemizedlist>
      <listitem>
       <simpara>
        'r' - Otwrz tylko do odczytu; ustawia wskanik pliku na pocztku
        pliku.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'r+' - Otwrz do odczytu i zapisu;  ustawia wskanik pliku na pocztku
        pliku.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w' - Otwrz tylko do zapisu; ustawia wskanik pliku na pocztku
        pliku i obcina plik (zeruje) do 0 dugoci.
        Jeli plik nie istnieje to prbuje go utworzy.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w+' - Otwrz do odczytu i zapisu; ustawia wskanik pliku na pocztku
        pliku i obcina plik (zeruje) do 0 dugoci.
        Jeli plik nie istnieje to prbuje go utworzy.
      </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a' - Otwrz tylko do zapisu; ustawia wskanik pliku na kocu
        pliku. Jeli plik nie istnieje to prbuje go utworzy.
      </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a+' - Otwrz do odczytu i zapisu; ustawia wskanik pliku na kocu
        pliku. Jeli plik nie istnieje to prbuje go utworzy.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <note>
     <para>
      Parametr <parameter>tryb</parameter> moe zawiera liter
      'b'. To jest uyteczne tylko na systemach, ktre rozrniaj
      pliki pomidzy binarne i tekstowe (np. Windows. To jest
      bezuyteczne na Unixach)
      Jeli nie potrzebne zostanie zignorowane.
     </para>
    </note>
    <para>
     Moesz uy opcjonalnego 3 parametru i ustawi go na "1", jeli
     chcesz szuka pliku take w
     <link linkend="ini.include-path">include_path</link>.
    </para>
    <para>
     <example>
      <title><function>fopen</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$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>
     Jeli dowiadczasz problemw z czytaniem i zapisywaniem do plikw
     i uywasz PHP jako modu serwera, pamitaj, e pliki i katalogi
     ktre uywasz musz by osigalne dla procesu serwera.
    </simpara>
    <para>
     Na platformach Windows, uwaaj na zastosowanie znakw ucieczki
     dla wszystkich uytych w ciece do pliku backslashy, lub
     uyj slash'y.
     <informalexample>
      <programlisting role="php">
<![CDATA[
$fp = fopen ("c:\\data\\info.txt", "r");
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Patrz take <function>fclose</function>,
     <function>fsockopen</function>,
     <function>socket_set_timeout</function> i
     <function>popen</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fpassthru">
   <refnamediv>
    <refname>fpassthru</refname>
    <refpurpose>
     Output all remaining data on a file pointer
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>fpassthru</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Reads to EOF on the given file pointer from the current position and
     writes the results to standard output.
    </simpara>
    <simpara>
     If an error occurs, <function>fpassthru</function> returns
     &false;.
    </simpara>
    <simpara>
     The file pointer must be valid, and must point to a file successfully
     opened by <function>fopen</function>, <function>popen</function>, or
     <function>fsockopen</function>.  You may need to call
     <function>rewind</function> to reset the file pointer to the beginning of
     the file if you have already written data to the file.  The file is
     closed when <function>fpassthru</function> is done reading it (leaving
     <parameter>fp</parameter> useless).
    </simpara>
    <simpara>
     If you just want to dump the contents of a file to stdout you may
     want to use the <function>readfile</function>, which saves you
     the <function>fopen</function> call.
    </simpara>
    <note>
     <para>
      When using <function>fpassthru</function> on a binary file on Windows
      systems, you should make sure to open the file in binary mode by
      appending a <literal>b</literal> to the mode used in the call to
      <function>fopen</function>.
     </para>
    </note>
    <simpara>
     See also <function>readfile</function>,
     <function>fopen</function>, <function>popen</function>, and
     <function>fsockopen</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fputs">
   <refnamediv>
    <refname>fputs</refname>
    <refpurpose>Zapisuje do wskanika pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</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>
        dugo
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>fputs</function> jest aliasem do
     <function>fwrite</function>, i jest identyczna w kadym przypadku.  Zauwa,
     e parametr <parameter>dugo</parameter> jest opcjonalny i jeli
     go nie podasz to cay acuch zostanie zapisany.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fread">
   <refnamediv>
    <refname>fread</refname>
    <refpurpose>Odczyt plikw binarnie bezpieczny</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>fread</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>dugo</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fread</function> odczytuje do
     <parameter>dugo</parameter> bajtw ze wskanika pliku
     <parameter>fp</parameter>. Czytanie koczy si gdy
     odczytano ju <parameter>dugo</parameter> bajtw
     lub osignito EOF, cokolwiek nastpi pierwsze.
    </simpara>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
// pobierz zawarto pliku do acucha
$filename = "/usr/local/something.txt";
$fd = fopen ($filename, "r");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
]]>
      </programlisting>
     </informalexample>
    </para>
    <note>
     <para>
      W systemach, ktre rozrniaj pliki na binarne i tekstowe
      (np. Windows) plik musi zosta otworzony z 'b' wczonym do
      parametru tryb funkcji <function>fopen</function>.
     </para>
    </note>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
$filename = "c:\\files\\somepic.gif";
$fd = fopen ($filename, "rb");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Patrz take <function>fwrite</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>,
     <function>fgets</function>, <function>fgetss</function>,
     <function>fscanf</function>, <function>file</function> i
     <function>fpassthru</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fscanf">
   <refnamediv>
    <refname>fscanf</refname>
    <refpurpose>Przetwarza dane z pliku wedug formatu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>mixed</type><methodname>fscanf</methodname>
      <methodparam><type>int</type><parameter>uchwyt</parameter></methodparam>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>war1</parameter></methodparam>
     </methodsynopsis>
    <para>
     Funkcja <function>fscanf</function> jest podobna do
     <function>sscanf</function>, ale pobiera dane wejciowe z pliku
     skojarzonego z <parameter>uchwyt</parameter>em i interpretuje je
     zgodnie z podanych <parameter>format</parameter>em.
     Jeli tylko dwa parametry zostan podane do funkcji, przetworzone
     wartoci zostan zwrcone w tablicy.
     W przeciwnym razie, jeli opcjonalne parametry zostan podane,
     funkcja zwrci numer przypisany do wartoci. Opcjonalny parametr
     musi by podawany przez referencje.
     <example>
      <title><function>fscanf</function> Przykad</title>
      <programlisting role="php">
<![CDATA[
$fp = fopen ("users.txt","r");
while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
    list ($name, $profession, $countrycode) = $userinfo;
    //... zrb co z wartociami
}
fclose($fp);
]]>
      </programlisting>
     </example>
     <example>
      <title>users.txt</title>
      <programlisting>
<![CDATA[
javier  argonaut        pe
hiroshi sculptor        jp
robert  slacker us
luigi   florist it
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take <function>fread</function>, <function>fgets</function>,
     <function>fgetss</function>, <function>sscanf</function>,
     <function>printf</function> i <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fseek">
   <refnamediv>
    <refname>fseek</refname>
    <refpurpose>Seeks on a file pointer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Sets the file position indicator for the file referenced by
     <parameter>fp</parameter>.The new position, measured in bytes
     from the beginning of the file, is obtained by adding
     <parameter>offset</parameter> to the position specified by
     <parameter>whence</parameter>, whose values are defined as
     follows:
     <simplelist>
      <member>SEEK_SET - Set position equal to
      <parameter>offset</parameter> bytes.</member> <member>SEEK_CUR -
      Set position to current location plus
      <parameter>offset</parameter>.</member> <member>SEEK_END - Set
      position to end-of-file plus
      <parameter>offset</parameter>. (To move to a position before the
      end-of-file, you need to pass a negative value in
      <parameter>offset</parameter>.)</member>
   </simplelist>
    </para>
    <para>If <parameter>whence is not specified, it is assumed to be
    SEEK_SET.</parameter>
    </para>
    <para>
     Upon success, returns 0; otherwise, returns -1. Note that seeking
     past EOF is not considered an error.
    </para>
    <para>
     May not be used on file pointers returned by
     <function>fopen</function> if they use the "http://" or "ftp://"
     formats.
    </para>
    <note>
     <para>
      The <parameter>whence</parameter> argument was added after PHP 4.0 RC1.
     </para>
    </note>
    <para>
     See also <function>ftell</function> and
     <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fstat">
   <refnamediv>
    <refname>fstat</refname>
    <refpurpose>
     Pobiera informacje o pliku uywajc otwartego wskanika pliku
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>fstat</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zbiera statystyki otwartego pliku przez wskanik pliku fp.
     Ta funkcja jest podobna do funkcji
     <function>stat</function> z wyjtkiem tego, e operuje na otwartym
     wskaniku pliku zamiast na nazwi pliku.
    </para>
    <para>
     Zwraca tablic ze statystyk pliku z nastpujcymi elementami:
     <orderedlist>
      <listitem><simpara>urzdzenie</simpara></listitem>
      <listitem><simpara>i-wze</simpara></listitem>
      <listitem><simpara>liczba dowiza</simpara></listitem>
      <listitem><simpara>identyfikator waciciela</simpara></listitem>
      <listitem><simpara>identyfikator grupy waciciela</simpara></listitem>
      <listitem><simpara>typ urzdzenia (jeli urzdzenie inode)*</simpara></listitem>
      <listitem><simpara>rozmiar w bajtach</simpara></listitem>
      <listitem><simpara>czas ostatniego dostpu</simpara></listitem>
      <listitem><simpara>czas ostatniej modyfikacji</simpara></listitem>
      <listitem><simpara>czas ostatniej zmiany</simpara></listitem>
      <listitem><simpara>rozmiar bloku w systemie plikw I/O *</simpara></listitem>
      <listitem><simpara>liczba przydzielonych blokw</simpara></listitem>
     </orderedlist>
     * - poprawny tylko w systemach obsugujcych type st_blksize -- inne systemy
     (np. Windows) zwracaj -1</para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftell">
   <refnamediv>
    <refname>ftell</refname>
    <refpurpose>Tells file pointer read/write position</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>ftell</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Returns the position of the file pointer referenced by fp; i.e.,
     its offset into the file stream.
    </para>
    <para>
     If an error occurs, returns &false;.
    </para>
    <para>
     The file pointer must be valid, and must point to a file
     successfully opened by <function>fopen</function> or
     <function>popen</function>.
    </para>
    <para>
     See also <function>fopen</function>, <function>popen</function>,
     <function>fseek</function> and <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftruncate">
   <refnamediv>
    <refname>ftruncate</refname>
    <refpurpose>
     Przycina plik do podanej dugoci.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftruncate</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>rozmiar</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pobiera wskanik pliku, fp, i przycina plik do dugoci, rozmiar.
    </para>
    <para>
     &return.success;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fwrite">
   <refnamediv>
    <refname>fwrite</refname>
    <refpurpose>Binary-safe file write</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> writes the contents of
     <parameter>string</parameter> to the file stream pointed to by
     <parameter>fp</parameter>. If the <parameter>length</parameter>
     argument is given, writing will stop after
     <parameter>length</parameter> bytes have been written or the end
     of <parameter>string</parameter> is reached, whichever comes
     first.
    </simpara>
    <simpara>
     Note that if the <parameter>length</parameter> argument is given,
     then the <link
     linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
     configuration option will be ignored and no slashes will be
     stripped from <parameter>string</parameter>.
    </simpara>
    <note>
     <para>
      On systems which differentiate between binary and text files
      (i.e. Windows) the file must be opened with 'b' included in
      <function>fopen</function> mode parameter.
     </para>
    </note>
    <simpara>
     See also <function>fread</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>, and
     <function>fputs</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.set-file-buffer">
   <refnamediv>
    <refname>set_file_buffer</refname>
    <refpurpose>
     Sets file buffering on the given file pointer
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Output using <function>fwrite</function> is normally buffered at
     8K.  This means that if there are two processess wanting to write
     to the same output stream (a file), each is paused after 8K of
     data to allow the other to write.  <function>set_file_buffer</function>
     sets the buffering for write operations on the given filepointer
     <parameter>fp</parameter> to <parameter>buffer</parameter> bytes.
     If <parameter>buffer</parameter> is 0 then write operations are
     unbuffered.  This ensures that all writes with
     <function>fwrite</function> are completed before other processes
     are allowed to write to that output stream.
    </simpara>
    <simpara>
     The function returns 0 on success, or EOF if the request cannot
     be honored.
    </simpara>
    <para>
     The following example demonstrates how to use
     <function>set_file_buffer</function> to create an unbuffered stream.
     <example>
      <title><function>set_file_buffer</function> example</title>
      <programlisting role="php">
<![CDATA[
$fp=fopen($file, "w");
if($fp){
  set_file_buffer($fp, 0);
  fputs($fp, $output);
  fclose($fp);
}
]]>
      </programlisting>
     </example>
    </para>

    <simpara>
     See also <function>fopen</function>, <function>fwrite</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.is-dir">
   <refnamediv>
    <refname>is_dir</refname>
    <refpurpose>Mwi czy nazwa_pliku jest katalogiem</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_dir</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca &true; jeli nazwa_pliku istnieje i jest katalogiem.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    <para>
     Patrz take <function>is_file</function> i
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-executable">
   <refnamediv>
    <refname>is_executable</refname>
    <refpurpose>Mwi czy plik jest wykonywalny</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_executable</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca &true; jeli plik istnieje i jest wykonywalny.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
    <para>
     Patrz take <function>is_file</function> i
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-file">
   <refnamediv>
    <refname>is_file</refname>
    <refpurpose>
     Mwi czy nazwa_pliku jest zwykym plikiem
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_file</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca &true; jesli nazwa_pliku istnieje i jest zwykym plikiem.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <para>
     Patrz take <function>is_dir</function> i
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-link">
   <refnamediv>
    <refname>is_link</refname>
    <refpurpose>
     Mwi czy nazwa_pliku jest dowizaniem symbolicznym
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_link</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca &true; jeli nazwa_pliku istnieje i jest dowizaniem symbolicznym.
    </para>
    <para>
     Wyniki tej funkcji s cachowane. Zobacz
     <function>clearstatcache</function> aby uzyska wicej szczegw.
    </para>
    <para>
     Patrz take <function>is_dir</function>,
     <function>is_file</function> i <function>readlink</function>.
    </para>
    <simpara>
     Ta funkcja nie dziaa
     <link linkend="features.remote-files">na zdalnych plikach</link>; sprawdzany
     plik musi by dostpny przez system plikw serwera.
    </simpara>
   &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.is-readable">
   <refnamediv>
    <refname>is_readable</refname>
    <refpurpose>
     Tells whether the filename is readable
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_readable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Returns &true; if the filename exists and is readable.
    </para>
    <para>
     Keep in mind that PHP may be accessing the file as the user
     id that the web server runs as (often 'nobody'). Safe mode
     limitations are not taken into account.
    </para>
    <para>
     The results of this function are cached. See
     <function>clearstatcache</function> for more details.
    </para>
    <simpara>
     This function will not work on <link
     linkend="features.remote-files">remote files</link>; the file to
     be examined must be accessible via the server's filesystem.
    </simpara>
    <para>
     See also <function>is_writable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writable">
   <refnamediv>
    <refname>is_writable</refname>
    <refpurpose>Tells whether the filename is writable</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Returns &true; if the filename exists and is writable.  The
     filename argument may be a directory name allowing you to check
     if a directory is writeable.
    </para>
    <para>
     Keep in mind that PHP may be accessing the file as the user id
     that the web server runs as (often 'nobody'). Safe mode
     limitations are not taken into account.
    </para>
    <para>
     The results of this function are cached. See
     <function>clearstatcache</function> for more details.
    </para>
    <simpara>
     This function will not work on <link
     linkend="features.remote-files">remote files</link>; the file to
     be examined must be accessible via the server's filesystem.
    </simpara>
    <para>
     See also <function>is_readable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writeable">
   <refnamediv>
    <refname>is_writeable</refname>
    <refpurpose>Tells whether the filename is writable</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writeable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     This is an alias for <function>is_writable</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-uploaded-file">
   <refnamediv>
    <refname>is_uploaded_file</refname>
    <refpurpose>Mwi czy plik zosta przysany przez HTTP POST.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>

    <para>
     Ta funkcja jest dostpna tylko w wersjach PHP 3 pniejszych od
     3.0.16 i w wersjach PHP 4 pniejszych od 4.0.2.
    </para>

    <para>
     Zwraca &true; jeli plik o nazwie <varname>nazwa_pliku</varname>
     zosta przysany (upload) przez HTTP POST. To pomaga upewni si,
     czy zoliwy uytkownik nie prbuje oszuka skryptu pracujcego
     na plikach, tak aby dziaa on na plikach na ktrych nie powinien
     -- na przykad
     <filename>/etc/passwd</filename>.
    </para>

    <para>
     Ten rodzaj testw jest szczeglnie wany jeli istnieje szansa, e
     cokolwiek robimy z przysanymi plikami moe zdradzi ich
     tre uytkownikowi lub nawet innym uytkownikom tego samego
     systemu.
    </para>

    <para>
     Patrz take <function>move_uploaded_file</function> i sekcj
     <link linkend="features.file-upload">Handling file uploads</link>
     aby zobaczy przykadowe skrypty.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.link">
   <refnamediv>
    <refname>link</refname>
    <refpurpose>Create a hard link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> creates a hard link.</para>
    <para>
     See also the <function>symlink</function> to create soft links,
     and <function>readlink</function> along with
     <function>linkinfo</function>.
    </para>
     &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.linkinfo">
   <refnamediv>
    <refname>linkinfo</refname>
    <refpurpose>Gets information about a link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>linkinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>linkinfo</function> returns the st_dev field of the
     UNIX C stat structure returned by the lstat system call.  This
     function is used to verify if a link (pointed to by
     <parameter>path</parameter>) really exists (using the same method
     as the S_ISLNK macro defined in stat.h).  Returns 0 or &false; in
     case of error.
    </para>
    <para>
     See also <function>symlink</function>, <function>link</function>,
     and <function>readlink</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.mkdir">
   <refnamediv>
    <refname>mkdir</refname>
    <refpurpose>Makes directory</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Attempts to create the directory specified by pathname.
    </para>
    <para>
     Note that you probably want to specify the mode as an
     octal number, which means it should have a leading zero.
     The mode is also modified by the current umask, which you
     can change using <function>umask</function>.
     <informalexample>
      <programlisting role="php">
<![CDATA[
mkdir ("/path/to/my/dir", 0700);
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Returns &true; on success and &false; on failure.
    </para>
    <para>
     See also <function>rmdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.move-uploaded-file">
   <refnamediv>
    <refname>move_uploaded_file</refname>
    <refpurpose>Moves an uploaded file to a new location.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     This function checks to ensure that the file designated by
     <parameter>filename</parameter> is a valid upload file (meaning
     that it was uploaded via PHP's HTTP POST upload mechanism). If
     the file is valid, it will be moved to the filename given by
     <parameter>destination</parameter>.
    </para>

    <para>
     If <parameter>filename</parameter> is not a valid upload file,
     then no action will occur, and
     <function>move_uploaded_file</function> will return
     &false;. 
    </para>

    <para>
     If <parameter>filename</parameter> is a valid upload file, but
     cannot be moved for some reason, no action will occur, and
     <function>move_uploaded_file</function> will return
     &false;. Additionally, a warning will be issued.
    </para>

    <para>
     This sort of check is especially important if there is any chance
     that anything done with uploaded files could reveal their
     contents to the user, or even to other users on the same
     system.
    </para>

    &note.sm.uidcheck;

    <warning>
     <para>
      If the destination file already exists, it will be overwritten.
     </para>
    </warning>

    <para>
     See also <function>is_uploaded_file</function>, and the section
     <link linkend="features.file-upload">Handling file uploads</link>
     for a simple usage example.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.parse-ini-file">
   <refnamediv>
    <refname>parse_ini_file</refname>
    <refpurpose>Parse a configuration file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_ini_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>
        process_sections
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>parse_ini_file</function> loads in the
     ini file specified in <parameter>filename</parameter>,
     and returns the settings in it in an associative array.
     By setting the last <parameter>process_sections</parameter>
     parameter to &true;, you get a multidimensional array, with
     the section names and settings included. The default
     for <parameter>process_sections</parameter> is &false;
    </para>
    <note>
     <para>
      This function has nothing to do with the
      <filename>php.ini</filename> file. It is already processed,
      the time you run your script. This function can be used to
      read in your own application's configuration files.
     </para>
    </note>
    <para>
     The structure of the ini file is similar to that of
     the <filename>php.ini</filename>'s.
    </para>
    <para>
     <example>
      <title>Contents of sample.ini</title>
      <programlisting>
<![CDATA[
; This is a sample configuration file
; Comments start with ';', as in php.ini

[first_section]
one = 1
five = 5

[second_section]
path = /usr/local/bin
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title><function>parse_ini_file</function> example</title>
      <programlisting>
<![CDATA[
<?php

// Parse without sections
$ini_array = parse_ini_file("sample.ini");
print_r($ini_array);

// Parse with sections
$ini_array = parse_ini_file("sample.ini", TRUE);
print_r($ini_array);

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Would produce:
     <informalexample>
      <programlisting>
<![CDATA[
Array
(
    [one] => 1
    [five] => 5
    [path] => /usr/local/bin
)
Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
        )

    [second_section] => Array
        (
            [path] => /usr/local/bin
        )

)
]]>
      </programlisting>
     </informalexample>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pathinfo">
   <refnamediv>
    <refname>pathinfo</refname>
    <refpurpose>Returns information about a file path</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>pathinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>pathinfo</function> returns an associative array
     containing information about <parameter>path</parameter>.  The
     following array elements are returned:
     <parameter>dirname</parameter>, <parameter>basename</parameter>
     and <parameter>extension</parameter>.
    </para>
    <para>
     <example>
      <title><function>pathinfo</function> Example</title>
      <programlisting role="php">
<![CDATA[
<?php

$path_parts = pathinfo("/www/htdocs/index.html");

echo $path_parts["dirname"] . "\n";
echo $path_parts["basename"] . "\n";
echo $path_parts["extension"] . "\n";

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Would produce:
     <informalexample>
      <programlisting>
<![CDATA[
/www/htdocs
index.html
html
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     See also <function>dirname</function>,
     <function>basename</function>, <function>parse_url</function>
     and <function>realpath</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pclose">
   <refnamediv>
    <refname>pclose</refname>
    <refpurpose>Closes process file pointer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>pclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Closes a file pointer to a pipe opened by
     <function>popen</function>.
    </para>
    <para>
     The file pointer must be valid, and must have been returned by a
     successful call to <function>popen</function>.
    </para>
    <para>
     Returns the termination status of the process that was
     run.
    </para>
    <para>
     See also <function>popen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.popen">
   <refnamediv>
    <refname>popen</refname>
    <refpurpose>Opens process file pointer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Opens a pipe to a process executed by forking the command given
     by command.
    </para>
    <para>
     Returns a file pointer identical to that returned by
     <function>fopen</function>, except that it is unidirectional (may
     only be used for reading or writing) and must be closed with
     <function>pclose</function>. This pointer may be used with
     <function>fgets</function>, <function>fgetss</function>, and
     <function>fputs</function>.
    </para>
    <para>
     If an error occurs, returns &false;.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
$fp = popen ("/bin/ls", "r");
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     See also <function>pclose</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readfile">
   <refnamediv>
    <refname>readfile</refname>
    <refpurpose>Outputs a file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Reads a file and writes it to standard output.
    </para>
    <para>
     Returns the number of bytes read from the file. If an error
     occurs, &false; is returned and unless the function was called as
     @readfile, an error message is printed.
    </para>
    <para>
     If <parameter>filename</parameter> begins with "http://"
     (not case sensitive), an HTTP 1.0 connection is opened to the
     specified server and the text of the response is written to
     standard output.
    </para>
    <para>
     Versions prior to PHP 4.0.5 do not handle HTTP redirects. Because
     of this, directories must include trailing slashes.
    </para>
    <para>
     If <parameter>filename</parameter> begins with "ftp://"
     (not case sensitive), an ftp connection to the specified server is
     opened and the requested file is written to standard output. If the server
     does not support passive mode ftp, this will fail.
    </para>
    <para>
     If <parameter>filename</parameter> begins with neither
     of these strings, the file will be opened from the filesystem and
     its contents written to standard output.
    </para>
    <para>
     You can use the optional second parameter and set it to "1", if
     you want to search for the file in the <link
     linkend="ini.include-path">include_path</link>, too.
    </para>
    <para>
     See also <function>fpassthru</function>,
     <function>file</function>, <function>fopen</function>,
     <function>include</function>, <function>require</function>, and
     <function>virtual</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readlink">
   <refnamediv>
    <refname>readlink</refname>
    <refpurpose>Returns the target of a symbolic link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>readlink</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>readlink</function> does the same as the readlink C
    function and returns the contents of the symbolic link path or 0
    in case of error.
    </para>
    <para>
     See also <function>is_link</function>,
     <function>symlink</function> and
     <function>linkinfo</function>.
    </para>
     &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.rename">
   <refnamediv>
    <refname>rename</refname>
    <refpurpose>Renames a file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Attempts to rename <parameter>oldname</parameter> to
     <parameter>newname</parameter>.
    </para>
    <para>
     Returns &true; on success and &false; on failure.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rewind">
   <refnamediv>
    <refname>rewind</refname>
    <refpurpose>Rewind the position of a file pointer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>rewind</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Sets the file position indicator for fp to the beginning of the
     file stream.</para> <para> If an error occurs, returns 0.</para>
     <para> The file pointer must be valid, and must point to a file
     successfully opened by <function>fopen</function>.
    </para>
     <note>
     <para>
      If you have opened the file in append ("a") mode, any data you write
      to the file will always be appended, regardless of the file position.
     </para>
    </note>
    <para>
     See also <function>fseek</function> and
     <function>ftell</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.rmdir">
   <refnamediv>
    <refname>rmdir</refname>
    <refpurpose>Removes directory</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>rmdir</methodname>
      <methodparam><type>string</type><parameter>dirname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Attempts to remove the directory named by pathname. The directory
     must be empty, and the relevant permissions must permit.
     this.
    </para>
    <para>
     If an error occurs, returns 0.
    </para>
    <para>
     See also <function>mkdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stat">
   <refnamediv>
    <refname>stat</refname>
    <refpurpose>Gives information about a file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>stat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gathers the statistics of the file named by filename.
    </para>
    <para>
     Returns an array with the statistics of the file with the
     following elements:
     <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>
     * - only valid on systems supporting the st_blksize type--other
     systems (i.e. Windows) return -1.
    </para>
    <para>
     Returns &false; in case of error.
    </para>
    <para>
     <function>stat</function> doesn't handle URL as does <function>fopen</function>.
    </para>
    <para>
     The results of this function are cached. See
     <function>clearstatcache</function> for more details.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.lstat">
   <refnamediv>
    <refname>lstat</refname>
    <refpurpose>
     Gives information about a file or symbolic link
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>array</type><methodname>lstat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gathers the statistics of the file or symbolic link named by
     filename.  This function is identical to the
     <function>stat</function> function except that if the
     <parameter>filename</parameter> parameter is a symbolic link, the
     status of the symbolic link is returned, not the status of the
     file pointed to by the symbolic link.
    </para>
    <para>
     Returns an array with the statistics of the file with the
     following elements:
     <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>
     * - only valid on systems supporting the st_blksize type--other
     systems (i.e. Windows) return -1</para>
    <para>
     The results of this function are cached. See
     <function>clearstatcache</function> for more details.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.realpath">
   <refnamediv>
    <refname>realpath</refname>
    <refpurpose>Returns canonicalized absolute pathname</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>string</type><methodname>realpath</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>realpath</function> expands all symbolic links and
     resolves references to '/./', '/../' and extra '/' characters in
     the input <parameter>path</parameter> and return the canonicalized
     absolute pathname.  The resulting path will have no symbolic link,
     '/./' or '/../' components.
    </para>
    <para>
     <example>
      <title><function>realpath</function> example</title>
      <programlisting role="php">
<![CDATA[
$real_path = realpath ("../../index.php");
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.symlink">
   <refnamediv>
    <refname>symlink</refname>
    <refpurpose>Creates a symbolic link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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> creates a symbolic link
     from the existing <parameter>target</parameter> with
     the specified name <parameter>link</parameter>.
    </para>
    <para>
     See also <function>link</function> to create hard links,
     and <function>readlink</function> along with
     <function>linkinfo</function>.
    </para>
   &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.tempnam">
   <refnamediv>
    <refname>tempnam</refname>
   <refpurpose>Create file with unique file name</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</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>
     Creates a file with a unique filename in the specified directory.
     If the directory does not exist, <function>tempnam</function> may
     generate a file in the system's temporary directory, and return
     the name of that.
    </para>
    <para>
     Prior to PHP 4.0.6, the behaviour of the
     <function>tempnam</function> function was system dependent. On
     Windows the TMP environment variable will override the
     <parameter>dir</parameter> parameter, on Linux the TMPDIR
     environment variable has precedence, while SVR4 will always use
     your <parameter>dir</parameter> parameter if the directory it
     points to exists. Consult your system documentation on the
     tempnam(3) function if in doubt.
    </para>
    <para>
     Returns the new temporary filename, or the &false; string on
     failure.
     <example>
      <title><function>tempnam</function> example</title>
      <programlisting role="php">
<![CDATA[
$tmpfname = tempnam ("/tmp", "FOO");

$fp = fopen($tmpfname, "w");
fwrite($fp, "writing to tempfile");
fclose($fp);

// do here something

unlink($tmpfname);
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      This function's behavior changed in 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. Note, that you need
      to remove the file in case you need it no more, it is not done
      automatically.
     </simpara>
    </note>
    <para>
     See also <function>tmpfile</function>, <function>unlink</function>.
    </para>
   </refsect1>
  </refentry>

   <refentry id="function.tmpfile">
   <refnamediv>
    <refname>tmpfile</refname>
    <refpurpose>Tworzy plik tymczasowy</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>tmpfile</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Tworzy plik tymczasowy o unikalnej nazwie i otwiera go 
     w trybie d zapisu, zwraca uchwyt pliku, podobnie jak
     <function>fopen</function>.
     Plik jest automatycznie kasowany przy zamykaniu (po uyciu
     <function>fclose</function>), lub gdy skrypt si zakoczy.
    </para>
    <para>
     Jeli chcesz uzyska wicej szczegw, zajrzyj do dokumentacji
     twojego systemu dotyczcej funkcji <literal>tmpfile(3)</literal>, 
     albo do pliku nagwkowego <filename>stdio.h</filename>.
    </para>
    <para>
     <example>
      <title><function>tmpfile</function> przykad</title>
      <programlisting role="php">
<![CDATA[
$temp = tmpfile();
fwrite($temp, "zapisywanie do pliku tymczasowego");
fclose($temp); // to kasuje plik
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Patrz take <function>tempnam</function>.
    </para>
   </refsect1>
  </refentry>

 <refentry id="function.touch">
   <refnamediv>
    <refname>touch</refname>
    <refpurpose>Ustawia czas modyfikacji pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>touch</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
         czas
        </parameter></methodparam>
     </methodsynopsis>
    <para>
     Prbuje ustawi czas modyfikacji pliku o nazwie nazwa_pliku
     na warto podan przez czas. Jeli opcja czas nie jest
     podana, uywa czasu biecego.
    </para>
    <para>
     Jeli plik nie istnieje, to zostanie utworzony.
    </para>
    <para>
     Zwraca &true; gdy sukces i &false; w przeciwnym wypadku.
     <example>
      <title><function>touch</function> przykad</title>
      <programlisting role="php">
<![CDATA[
if (touch ($FileName)) {
    print "$FileName czas modyfikacji zosta
           zmieniony na obecn date i czas";
} else {
    print "Przykro mi ale Nie Mog zmieni czasu modyfikacji pliku $FileName";
}
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.umask">
   <refnamediv>
    <refname>umask</refname>
    <refpurpose>Changes the current umask</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>umask</methodname>
      <methodparam><type>int</type><parameter>mask</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>umask</function> sets PHP's umask to mask &amp; 0777 and
     returns the old umask. When PHP is being used as a server module,
     the umask is restored when each request is finished.
    </para>
    <para>
     <function>umask</function> without arguments simply returns the
     current umask.
    </para>
     &note.no-windows;
   </refsect1>
  </refentry>

<refentry id="function.unlink">
   <refnamediv>
    <refname>unlink</refname>
    <refpurpose>Kasowanie pliku</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>unlink</methodname>
      <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam>
     </methodsynopsis>
    <para>
     Kasuje <parameter>nazwa_pliku</parameter>. Podobnie do funkcji unlink() 
     z Unix'owego C.
    </para>
    <para>
     &return.success;
    </para>
    <para>
     Patrz take <function>rmdir</function> do kasowania katalogw.
    </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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->