<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
 <reference id="ref.filesystem">
  <title>Funes do Filesystem</title>
  <titleabbrev>Filesystem</titleabbrev>

  <refentry id="function.basename">
   <refnamediv>
    <refname>basename</refname>
    <refpurpose>
     Retorna a parte do nome do arquivo do path
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>basename</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>sufixo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dado uma string contendo um path para um arquivo, essa funo ir
     retornar o nome base do arquivo.
     Se o nome do arquivo  terminado em um <parameter>sufixo</parameter>
     este tambm ser retirado.
    </para>
    <para>
     No Windows, tanto a barra (<literal>/</literal>) quanto a
     barra invertida (<literal>\</literal>) so usadas como caracter de
     separacao do path. Em outros ambientes, somente a barra
     (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title>exemplo do <function>basename</function></title>
      <programlisting role="php">
$path = "/home/httpd/html/index.php";
$arquivo = basename ($path);        // $arquivo conter "index.php"
$arquivo = basename ($path,".php"); // $arquivo conter "index"
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      O parametro <parameter>sufixo</parameter> foi adicionado no PHP 4.1.0.
     </para>
    </note>
    <para>
     Veja tambm: <function>dirname</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chgrp">
   <refnamediv>
    <refname>chgrp</refname>
    <refpurpose>Modifica o grupo do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>chgrp</methodname>
      <methodparam><type>string</type><parameter>arquivo</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>grupo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tenta modificar o grupo do
     <parameter>arquivo</parameter> para o
     <parameter>grupo</parameter>. Somente o superusurio pode mudar
     o grupo de um arquivo arbitrrio; outros usurios podem somente
     mudar o grupo de um arquivo para qual o usurio pertence.
    </para>
    <para>
     Retorna &true; se obtiver sucesso; caso contrrio retorna
     &false;.
    </para>
    <para>
     Veja tambm <function>chown</function> e
     <function>chmod</function>.
    </para>
    <note>
     <simpara>
      Esta funo no funciona em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.chmod">
   <refnamediv>
    <refname>chmod</refname>
    <refpurpose>Modifica as permisses do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>chmod</methodname>
      <methodparam><type>string</type><parameter>arquivo</parameter></methodparam>
      <methodparam><type>int</type><parameter>modo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tenta mudar as permisses do arquivo especificado por
     <parameter>arquivo</parameter> para o dado em
     <parameter>modo</parameter>.
    </para>
    <para>
     Note que <parameter>mode</parameter> no  assumido ser um numero
     octal, ento strings (como "g+w") no funcionaro. Para garantir
     que a operao seja bem sucedide  necessrio o prefixo zero (0)
     em <parameter>mode</parameter>:
     <informalexample>
      <programlisting role="php">
chmod ("/algumdir/algumarquivo", 755);   // decimal; provavelmente incorreto
chmod ("/algumdir/algumarquivo", "u+rwx,go+rx"); // string; incorreto
chmod ("/algumdir/algumarquivo", 0755);  // octal; correto valor da permisso
      </programlisting>
     </informalexample>
    </para>
    <para>
     Retorna &true; se obtiver sucesso e caso contrrio &false;.
    </para>
    <para>
     Veja tambm <function>chown</function> e
     <function>chgrp</function>.
    </para>
    <note>
     <simpara>
      Esta funo no funciona em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.chown">
   <refnamediv>
    <refname>chown</refname>
    <refpurpose>Modifica o dono do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>chown</methodname>
      <methodparam><type>string</type><parameter>arquivo</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>usurio</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tenta modificar o dono do arquivo "arquivo" para o usurio
     "usurio". Somente o superusurio pode modificar o dono de
     um arquivo.
    </para>
    <para>
     Retorna &true; se obtiver sucesso e caso contrrio &false;.
    </para>
    <para>
     Veja tambm <function>chown</function> e
     <function>chmod</function>.
    </para>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.clearstatcache">
   <refnamediv>
    <refname>clearstatcache</refname>
    <refpurpose>Limpa o  cache do file stat</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>void</type><methodname>clearstatcache</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Invocando a funo do sistema (system call)
     <systemitem>stat</systemitem> ou <systemitem>lstat</systemitem>
     na maior parte do sistema  bem caro. Ento, o resultado da ultima
     chamada para qualquer chamada para as funes de status (listadas
     abaixo)  guardada para a ultilizao nas possiveis procimas
     chamadas utilizando o mesmo nome de arquivo. Se voce deseja forcar
     um check no status, por exemplo se o arquivo  for checado muitas
     vezes e pode mudar ou disaparecer, use esta funo para limpar os
     resultados da ultima chamada da memria.
    </para>
    <para>
     Este valor somente reside no cache pelo tempo de somente um pedido.
    </para>
    <para>
     As funes afetadas so <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>, e
     <function>fileperms</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.copy">
   <refnamediv>
    <refname>copy</refname>
    <refpurpose>Copia arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>copy</methodname>
      <methodparam><type>string</type><parameter>origem</parameter></methodparam>
      <methodparam><type>string</type><parameter>destino</parameter></methodparam>
     </methodsynopsis>
    <para>
     Faz uma cpia de um arquivo. Retorna &true; se a copia 
     obtida com sucesso, caso contrrio &false;.
     <example>
      <title>exemplo do <function>copy</function></title>
      <programlisting role="php">
if (!copy($arquivo, $arquivo.'.bak')) {
    print ("erro ao copiar $arquivo...&lt;br>\n");
}
      </programlisting>
     </example>
    </para>
    <para>
     Veja tambm: <function>rename</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.delete">
   <refnamediv>
    <refname>delete</refname>
    <refpurpose>Uma seo dipensvel do manual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>void</type><methodname>delete</methodname>
      <methodparam><type>string</type><parameter>file</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta  uma seo dispensvel do manual criada para satisfazer
     as pessoas que esto procurando por <function>unlink</function>
     ou <function>unset</function> no lugar errado.
    </para>
    <para>
     Veja tambm: <function>unlink</function> para deletar arquivos,
     <function>unset</function> para apagar vriaveis.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dirname">
   <refnamediv>
    <refname>dirname</refname>
    <refpurpose>Retorna o nome do diretrio componente do path</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>dirname</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dada uma string contendo um path para um arquivo, esta funo
     ir retornar o nome do diretrio.
    </para>
    <para>
     No Windows, tanto barra (<literal>/</literal>) quanto a
     barra invertida (<literal>\</literal>) so usadas como caracter
     separador no path. Em outros ambientes  utilizado a barra
     (<literal>/</literal>).</para>
    <para>
     <example>
      <title>exemplo do <function>dirname</function></title>
      <programlisting role="php">
$path = "/etc/passwd";
$file = dirname ($path); // $file is set to "/etc"
      </programlisting>
     </example>
    </para>
    <para>
     Veja tambm: <function>basename</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-free-space">
   <refnamediv>
    <refname>disk_free_space</refname>
    <refpurpose>Retorna o espao disponivel no diretrio.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_free_space</methodname>
      <methodparam><type>string</type><parameter>diretrio</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dado uma string contendo um diretrio, esta funo retornar o
     numero de bytes disponveis no correspondente filesystem ou
     partio de disco.
    </para>
    <para>
     <example>
      <title>exemplo de <function>disk_free_space</function></title>
      <programlisting role="php">
$df = disk_free_space("/"); // $df contm o nmero de bytes.
                          // disponvel em "/"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.diskfreespace">
   <refnamediv>
    <refname>diskfreespace</refname>
    <refpurpose>Sinnimo de <function>disk_free_space</function></refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>float</type><methodname>diskfreespace</methodname>
      <methodparam><type>string</type><parameter>diretrio</parameter></methodparam>
     </methodsynopsis>
    <para>
     Este  um sinnimo obsoleto para a funo
     <function>disk_free_space</function>.
     Ultilize aquela funo ao invez.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-total-space">
   <refnamediv>
    <refname>disk_total_space</refname>
    <refpurpose>Retorna o tamanho total do diretrio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_total_space</methodname>
      <methodparam><type>string</type><parameter>diretrio</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dado uma string contendo um diretrio, esta funo retornar o
     numero total de bytes correspondendo ao filesystem ou a partio
     de disco.
    </para>
    <para>
     <example>
      <title><function>disk_total_space</function> example</title>
      <programlisting role="php">
$df = disk_total_space("/"); // $df contm o numero total de
                             // bytes disponveis em "/"
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fclose">
   <refnamediv>
    <refname>fclose</refname>
    <refpurpose>Fecha um ponteiro de arquivo aberto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>fclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     O arquivo apontado por <parameter>fp</parameter>  fechado.
    </para>
    <para>
     Retorna &true; se obtiver sucesso e caso contrrio
     &false;.
    </para>
    <para>
     O ponteiro para o arquivo tem que ser vlido e tem que
     apontar para um arquivo aberto por <function>fopen</function>
     ou <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.feof">
   <refnamediv>
    <refname>feof</refname>
    <refpurpose> Testa por fim-de-arquivo (eof) em um ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>feof</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se obtiver o ponteiro estiver no fim do arquivo
     (eof) ou um erro ocorrer, caso contrrio retorna &false;.
    </para>
    <para>
     O ponteiro para o arquivo tem que ser vlido e tem que apontar para
     um arquivo aberto com sucesso por <function>fopen</function>,
     <function>popen</function>, ou <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fflush">
   <refnamediv>
    <refname>fflush</refname>
    <refpurpose>Fora a ida da saida para o arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fflush</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta funo forca que toda a sada que est no buffer
     para qual o arquivo est apontado pelo
     <parameter>fp</parameter> seja escrita.
     Retorna &true; se obtiver sucesso e caso contrrio
     &false;.
    </para>
    <para>
     O ponteiro de arquivo tem que ser vlido e apontar para
     um arquivo que foi aberto com sucesso por
     <function>fopen</function>, <function>popen</function>,
     ou <function>fsockopen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetc">
   <refnamediv>
    <refname>fgetc</refname>
    <refpurpose>Ler caracter do ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetc</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna uma string contendo somente um caracter lido do arquivo
     apontado por fp. Retorna &false; no fim do arquivo (eof).
    </para>
    <para>
     O ponteiro de arquivo tem que ser vlido e apontar para um
     arquivo aberto com sucesso por <function>fopen</function>,
     <function>popen</function>, ou <function>fsockopen</function>.
    </para>
    <para>
     Veja tambm <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fsockopen</function>, e
     <function>fgets</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetcsv">
   <refnamediv>
    <refname>fgetcsv</refname>
    <refpurpose>
     Ler uma linha do ponteiro de arquivos e parse por campos CSV
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>fgetcsv</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>comprimento</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        delimitador
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Similar  <function>fgets</function> exceto que
     <function>fgetcsv</function> parses a linha que l por campos
     no formato <acronym>CSV</acronym> e retorna um vetor (array)
     contendo os campos lidos. O delimitador dos campos  a virgula,
     a menos que seja especificado com o terceiro parametro que 
     opcional.
    </simpara>
    <simpara>
     <parameter>Fp</parameter> tem que ser um ponteiro de arquivo
     vlido para um arquivo aberto com sucesso por
     <function>fopen</function>, <function>popen</function>,
     ou <function>fsockopen</function>
    </simpara>
    <simpara>
     Comprimento tem que ser maior do que a maior linha a ser encontrada
     no arquivo CSV (incluindo caracteres de terminao de linha).
    </simpara>
    <simpara>
     <function>fgetcsv</function> retorna &false; ao encontrar um erro,
     incluindo fim de arquivo (eof).
    </simpara>
    <simpara>
     N.B. Uma linha em branco em um arquivo CSV ser retornada como um
     vetor contendo um nico campo nulo (&null;), e no ser tratado
     como um erro.
    </simpara>
    <example>
     <title>
      exemplo de <function>fgetcsv</function> - Ler e imprimir os contedos
      inteiros de um arquivo CSV.
     </title>
     <programlisting role="php">
$row = 1;
$fp = fopen ("test.csv","r");
while ($data = fgetcsv ($fp, 1000, ",")) {
    $num = count ($data);
    print "&lt;p&gt; $num campos na linha $row: &lt;br&gt;";
    $row++;
    for ($c=0; $c&lt;$num; $c++) {
        print $data[$c] . "&lt;br&gt;";
    }
}
fclose ($fp);
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.fgets">
   <refnamediv>
    <refname>fgets</refname>
    <refpurpose>Ler a linha de um ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>fgets</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>comprimento</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna uma string com at comprimento - 1 bytes lidos do arquivo
     apontado por fp. A leitura acaba quando comprimento - 1 bytes
     foram lidos, em uma nova linha (newline) (que  incluida no valor
     retornado), ou em um fim de arquivo (eof) (o que acontecer
     primeiro).
    </para>
    <para>
     Se um erro ocorrer, retorna &false;.
    </para>
    <para>
     Equivocos comuns:
    </para>
    <simpara>
     Pessoas acostumadas a semantica do fgets em 'C' devem notar a
     diferenca em como o fim do arquivo (eof)  retornado.
    </simpara>
    <simpara>
     O ponteiro para o arquivo deve ser vlido e deve apontar para um
     arquivo aberto com sucesso por <function>fopen</function>,
     <function>popen</function>, ou
     <function>fsockopen</function>.
    </simpara>
    <para>
     Um simples exemplo segue:
     <example>
      <title>Lendo um arquivo linha a linha</title>
      <programlisting role="php">
$fd = fopen ("/tmp/arquivodeentrada.txt", "r");
while (!feof ($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);
      </programlisting>
     </example>
    </para>
    <para>
     Veja tambm <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fgetc</function>,
     <function>fsockopen</function>, e
     <function>socket_set_timeout</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetss">
   <refnamediv>
    <refname>fgetss</refname>
    <refpurpose>
     Ler uma linha de um ponteiro de arquivo e retira as tags HTML
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetss</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>comprimento</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        tags_permitidas
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Identico a <function>fgets</function>, exceto que fgetss
     tenta retirar qualquer tag HTML ou PHP do texto que ele l.
    </para>
    <para>
     Voc pode retirar o terceiro parametro opcional para especificar
     quais tags no devem ser retiradas. 
     <note>
      <para>
       <parameter>tags_permitidas</parameter> foi adicionada no PHP 3.0.13,
       PHP4B3.
      </para> 
     </note>
    </para>
    <para>
     Veja tambm <function>fgets</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>, e
     <function>strip_tags</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.file">
   <refnamediv>
    <refname>file</refname> 
    <refpurpose>Ler um arquivo inteiro para um array</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>file</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Identico a <function>readfile</function>, exceto que 
     <function>file</function> returna o arquivo no array. Cada
     elemento do array corresponde a uma linha no arquivo, inclusive 
     com o caracter de nova linha.
    </para>
    <para>
     Voc pode usar o segundo parametro opcional como "1", se voce
     deseja procurar o arquivo no  <link
     linkend="ini.include-path">include_path</link> tambm.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
&lt;?php
// ler uma webpage para um array e o imprimir
$fcontents = file ('http://www.php.net');
while (list ($line_num, $line) = each ($fcontents)) {
    echo "&lt;b&gt;Linha $line_num:&lt;/b&gt; " . htmlspecialchars ($line) . "&lt;br&gt;\n";
}

// ler uma web paga para uma string
$fcontents = join ('', file ('http://www.php.net'));
?&gt;
      </programlisting>
     </informalexample>
    </para>
    <para>
     Veja tambm <function>readfile</function>,
     <function>fopen</function>, <function>fsockopen</function>, e
     <function>popen</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.file-exists">
   <refnamediv>
    <refname>file_exists</refname>
    <refpurpose>Checar se um arquivo existe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>file_exists</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Retorna &true; se o arquivo expecificado por 
     <parameter>nomedoarquivo</parameter> existe; &false; caso contrrio.
    </simpara>
    <simpara>
     Esta funo no ir funcionar em  <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     para ser examinado tem que ser accessivel pelo filesystem do servidor.
    </simpara>
    <simpara>
     Os resultados desta funo so guardados no cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </simpara>
   </refsect1>
  </refentry>


  <refentry id="function.fileatime">
   <refnamediv>
    <refname>fileatime</refname>
    <refpurpose>Obtm o ltimo tempo de acesso do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fileatime</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <simpara> 
     Retorna o tempo que o arquivo foi acessado por ltimo, ou &false; 
     em caso de erro. O tempo que  retornado  um timestamp UNIX.
     Returns the time the file was last accessed, or &false; in case of
     an error. The time is returned as a Unix timestamp.
    </simpara>
    <simpara>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </simpara>
    <simpara>
     Nota: O atime do arquivo deve mudar para quando os blocos
     de informao  do arquivo so lidos. Isto pode ser caro
     em termos de performance quando uma aplicao frequentemente
     acessa um numero muito grande de arquivos ou diretrios.
     Alguns filesystems Unix podem ser montados com updates dos
     atimes desabilitados para aumentar a performance destas 
     aplicaes; USENET news spools  um exemplo comum. Nestes
     filesystems esta funo  intil.
    </simpara>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessvel pelo filesystem do servidor.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filectime">
   <refnamediv>
    <refname>filectime</refname>
    <refpurpose>Ler o tempo de modificao do inode do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>filectime</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna o tempo em que o arquivo foi modificado pela ltima vez,
     ou &false; em caso de erro. O tempo  retornado como um timestamp
     Unix.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <para>
     Nota: Na maior parte dos filesystems Unix, um arquivo 
     considerado modificado quando a informao do inode 
     modificada; isto , quando as permisses, dono (owner),
     grupo (group), ou outra metadata do inode  modificada.
     Veja tambm <function>filemtime</function> (o que  o que
     voc deseja usar quando criando rodaps com informaes 
     sobre ltima vez que o arquivo foi modificado em web pages)
     e <function>fileatime</function>.
    </para>
    <para>Note tambm que em alguns textos Unix o ctime do arquivo
      referido como sendo o tempo de criao do tempo do arquivo.
     Isto  errado. No h tempo de criao de arquivos Unix na
     maior parte dos filesystems Unix.
    </para>
    <simpara>
     Esta funo no ir funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filegroup">
   <refnamediv>
    <refname>filegroup</refname>
    <refpurpose>Ler o grupo do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>filegroup</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna o group ID do dono do arquivo, ou &false; no caso de um
     erro. O group ID  retornado em um formato numrico, use
     <function>posix_getgrgid</function> para resolver para o nome do
     grupo.
    </para>
    <para>
     O resultado desta funo so guardados em cache. Veja
      <function>clearstatcache</function> para mais detalhes.
    </para>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    <simpara>
     Esta funo no ir funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o
     arquivo a ser examinado tem que ser acessivel atravez do 
     filesystem do servidor.
    </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.fileinode">
   <refnamediv>
    <refname>fileinode</refname>
    <refpurpose>Ler o inode do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fileinode</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Retorna o numero do inode do arquivo, ou &false; em caso de erro.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja 
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o
     arquivo a ser examinado tem que ser acessivel pelo filesystem
     do servidor.
    </simpara>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.filemtime">
   <refnamediv>
    <refname>filemtime</refname>
    <refpurpose>Ler o tempo de modificao do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>filemtime</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna o tempo em que o arquivo foi modificado pela ltima vez, ou
     &false; em caso de erro. O tempo  retornado como um timestamp Unix.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o
     arquivo a ser examinado tem que ser acessivel pelo filesystem
     do servidor.
    </simpara>
    <para>Nota: Esta funo retorna o tempo quando os blocos de
     informao do arquivo so escritos, isto , o tempo quando o
     contedo do arquivo foi mudado. Para obter uma data de
     modificao para utilizar em rodaps use a funo
     <function>date</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fileowner">
   <refnamediv>
    <refname>fileowner</refname>
    <refpurpose>Ler o dono(owner) do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fileowner</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna o ID do usurio(user ID) do dono(owner) do arquivo, ou &false;
     caso um erro ocorra. O ID do usurio  retornado no formato numrico,
     use <function>posix_getpwuid</function> para obter o username do
     usurio.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.fileperms">
   <refnamediv>
    <refname>fileperms</refname>
    <refpurpose>Ler as permisses do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fileperms</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna as permisses do arquivo, ou &false; em caso de erro.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filesize">
   <refnamediv>
    <refname>filesize</refname>
    <refpurpose>Ler o tamanho do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>filesize</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Retorna o tamanho do arquivo, ou &false; em caso de erro.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes. 
    </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.filetype">
   <refnamediv>
    <refname>filetype</refname>
    <refpurpose>Ler o tipo de arquivo (file type)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>filetype</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna o tipo do arquivo(file type). Valores possiveis so
     fifo, char, block, link, file e unknown(desconhecido).</para>
     <para> Retorna &false; se um erro ocorrer.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.flock">
   <refnamediv>
    <refname>flock</refname>
    <refpurpose>Portable advisory file locking</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>flock</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>operacao</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        wouldblock
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     PHP suporta uma maneira portvel de lock arquivos completos
     em uma advisory way (que significa que todos os programas acessando
     tem que usar a mesma maneira de locking ou no ir funcionar).
    </simpara>
    <simpara>
     <function>flock</function> opera em <parameter>fp</parameter>,
     que tem que ser um ponteiro de arquivo aberto com sucesso.
     <parameter>operacao</parameter>  um dos seguintes valores:
    </simpara>
    <para>
     <itemizedlist>
      <listitem>
       <simpara>
         Para obter uma lock compartilhada (leitura), use
         <parameter>operacao</parameter> como LOCK_SH (use 1 se a verso
         do PHP for anterior a 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         Para obter uma lock exclusiva (gravao), use
         <parameter>operacao</parameter> como LOCK_EX (use 2 se a verso
         do PHP for anterior a 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         Para retirar uma lock (compartilhada ou exclusiva), use
         <parameter>operacao</parameter> como LOCK_UN (use 3 se a verso
         do PHP for anterior a 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
         Se voc no quer usar  <function>flock</function> para
         bloquear enquanto locking, addicione LOCK_NB (3 se a verso
         do PHP for anterior a 4.0.1) a <parameter>operacao</parameter>.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <simpara>
     <function>flock</function> permite que voc possa fazer um simples
     modelo leitura/gravao (reader/writer) que pode ser usado em 
     virtualmente todas as plataformas (incluindo a maior parte dos
     Unixes e at mesmo Windows). O terceiro argumento opcional  usado
     como &true; se a lock iria bloquear (EWOULDBLOCK errno condition)
    </simpara>
    <simpara>
     <function>flock</function> retorna &true; em caso de sucesso e 
     &false; em caso de erro (por exemplo quando uma lock no pode
     ser obtida).
    </simpara>
    <warning>
     <para>
      Na maior parte dos sistemas operacionais <function>flock</function>
       implementada no nvel do processo. Quando usando um servidor 
      com um multithreaded API como ISAPI voc no pode confiar no
      <function>flock</function> para proteger os arquivos contra outros
      scripts PHP rodando em threads paralelos do mesmo servidor.
     </para>
    </warning>
   </refsect1>
  </refentry>

  <refentry id="function.fopen">
   <refnamediv>
    <refname>fopen</refname>
    <refpurpose>Abrir um arquivo ou uma URL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fopen</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Se <parameter>nomedoarquivo</parameter> comea com "http://"
     (no diferencia entre caracteres maiusculas e minusculas),
     uma conexo HTTP 1.0  aberta para o servidor especificado, a
     pgina  requisitada usando o mtodo HTTP GET, e um ponteiro
     de arquivo  retornado no comeo do corpo da resposta. O 
     cabealho 'Host:'  enviado com o pedido para que virtual
     hosts baseados em nomes sejam suportados.
    </simpara>
    <simpara>
     Note que o ponteiro de arquivo deixa voc retirar somente o
     corpo(<emphasis>body</emphasis>) da resposta; voc no pode
     acessar o cabealho de resposta HTTP usando esta funo.
    </simpara>
    <simpara>
     Verses anteriores a PHP 4.0.5 no suportam redirecionamentos HTTP.
     Por causa disso, diretrios devem incluir a barra no final.
    </simpara>
    <simpara>
     Se <parameter>nomedoarquivo</parameter> comea com "ftp://" (no
     diferencia entre caracteres maiusculas e minusculas tambm), uma
     conexo para o servidor especificado  aberta e um ponteiro para o
     arquivo perdido  retornado. Se o servidor no suporta modo passivo,
     isto ir falhar. Voc pode abrir arquivos tanto para leitura quanto
     para gravao via ftp (mas no para ambos simultneamente).
    </simpara>
    <simpara>
     Se <parameter>nomedoarquivo</parameter>  ou "php://stdin",
     ou "php://stdout", ou "php://stderr", o correspondente stream
     stdio ser aberto. (Isto foi introduziso no PHP 3.0.13; em
     verses anteriores, um nome de arquivo como "/dev/stdin" ou
     "/dev/fd/0" deve ser usado para acessar os streams stdio.)
    </simpara>
    <simpara>
     Se <parameter>nomedoarquivo</parameter> comea com qualquer outra
     coisa, o arquivo ser aberto no filesystem e um ponteiro para o
     arquivo ser retornado.
    </simpara>
    <simpara>
     Se a abertura falhar, a funo retornar &false;.
    </simpara>
    <para>
     <parameter>mode</parameter> pode ser qualquer um dos seguintes:
     <itemizedlist>
      <listitem>
       <simpara>
        'r' - Abrir somente para leitura; coloca o ponteiro de arquivo
        no comeo do arquivo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'r+' - Abrir para leitura e gravao; colocar o ponteiro de
        arquivo no comeo do arquivo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w' - Abrir somente para gravao; colocar o ponteiro de
        arquivo no comeo do arquivo e truncar o arquivo para tamanho
        zero. Se o arquivo no existir, tentar cria-lo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'w+' - Abrir para leitura e escrita; colocar o ponteiro de
        arquivo no incio do arquivo e truncar o arquivo para tamanho
        zero. Se o arquivo no existir, tentar cria-lo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a' - Abrir o arquivo somente para escrita; colocar o ponteiro
        de arquivo no fim do arquivo.  Se o arquivo no existe, tentar
        cria-lo.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        'a+' - Abrir o arquivo para leitura e gravao; colocar o
        ponteiro no fim do arquivo. Se o arquivo no existe, tentar
        cria-lo.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <note>
     <para>
      O <parameter>mode</parameter> pode conter a letra 'b'. Isto 
      til somente em sistemas que diferenciam entre arquivos
      binrios e texto (por exemplo Windows.  intil em Unix).
      Se no nescessrio, ser ignorado.
     </para>
    </note>
    <para>
     Voc pode usar o terceiro parametro opctional como "1", se voc
     quer procurar pelo arquivo no <link
     linkend="ini.include-path">include_path</link>, tambm.
    </para>
    <para>
     <example>
      <title>exemplo do <function>fopen</function></title>
      <programlisting role="php">
$fp = fopen ("/home/rasmus/arquivo.txt", "r");
$fp = fopen ("/home/rasmus/arquivo.gif", "wb");
$fp = fopen ("http://www.php.net/", "r");
$fp = fopen ("ftp://usuario:senha@exemplo.com.br/", "w");
      </programlisting>
     </example>
    </para>
    <simpara>
     Se voc est tendo problemas com a leitura e gravao para
     arquivos e voc est usando a verso de modulo de servidor do
     PHP, lembre-se de ter certeza que os arquivos e diretrios que
     voc est usando precisam ser acessveis ao processo do servidor
     de HTTP.
    </simpara>
    <para>
     Na plataforma Windows, tenha cuidado para usar uma segunda
     barra invertida (escape) usada no path de um arquivo, ou usar
     a barra normal.
     <informalexample>
      <programlisting role="php"> 
$fp = fopen ("c:\\data\\info.txt", "r");
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Veja tambm <function>fclose</function>,
     <function>fsockopen</function>,
     <function>socket_set_timeout</function>, e
     <function>popen</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fpassthru">
   <refnamediv>
    <refname>fpassthru</refname> 
    <refpurpose>
     Imprime todo o restante de um ponteiro de arquivo
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>fpassthru</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     L at o fim do arquivo (EOF) do ponteiro de arquivo dado e 
     imprime os resultados para a sada normal (standard output).
    </simpara>
    <simpara>
     Se um error ocorrer, a funo <function>fpassthru</function>
     retorna &false;.
    </simpara>
    <simpara>
     O ponteiro de arquivo tem que ser vlido e apontar para um
     arquivo aberto com sucesso por <function>fopen</function>,
     <function>popen</function>, ou <function>fsockopen</function>.
     O arquivo  fechado quando <function>fpassthru</function>
     acaba de ler (deixando <parameter>fp</parameter> sem utilidade).
    </simpara>
    <simpara>
     Se voc quiser somente jogar o contedo do arquivo para stout voc
     pode querer usar a funo <function>readfile</function>, que vai
     salvar a voc a chamada a funo <function>fopen</function>.
    </simpara>
    <simpara>
     Veja tambm <function>readfile</function>,
     <function>fopen</function>, <function>popen</function>, e
     <function>fsockopen</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fputs">
   <refnamediv>
    <refname>fputs</refname>
    <refpurpose>Escrever para um ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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>
        comprimento
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>fputs</function>  uma funo sinnima (alias) para 
     <function>fwrite</function>, e  identica em todas as maneiras.
     Note que o parametro <parameter>comprimento</parameter>  opcional
     e se no for especificado a string inteira ser escrita.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fread">
   <refnamediv>
    <refname>fread</refname>
    <refpurpose>Leitura binary-safe de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>fread</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>comprimento</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fread</function> l at 
     <parameter>comprimento</parameter> bytes. A leitura  
     interrompida quando <parameter>comprimento</parameter>
     bytes foram lidos ou o fim do arquivo (eof) foi alcanado,
     o que ocorrer primeiro.
    </simpara> 
    <para>
     <informalexample>
      <programlisting role="php">
// ler o contedo do arquivo para uma string
$nomedoarquivo = "/usr/local/algo.txt";
$fd = fopen ($nomedoarquivo, "r");
$conteudo = fread ($fd, filesize ($nomedoarquivo));
fclose ($fd);
      </programlisting>
     </informalexample>
    </para>
    <note>
     <para>
      Em sistemas que diferenciam entre arquivos binrios e texto
      (por exemplo Windows) o arquivo tem que ser aberto com 'b'
      includo como parametro na funo <function>fopen</function>.
     </para>
    </note>
    <para>
     <informalexample>
      <programlisting role="php">
$nomedoarquivo = "c:\\arquivos\\algumaimg.gif";
$fd = fopen ($nomedoarquivo, "rb");
$conteudo = fread ($fd, filesize ($nomedoarquivo));
fclose ($fd);
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Veja tambm <function>fwrite</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>,
     <function>fgets</function>, <function>fgetss</function>,
     <function>fscanf</function>, <function>file</function>, e
     <function>fpassthru</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fscanf">
   <refnamediv>
    <refname>fscanf</refname>
    <refpurpose>Parses a entrada de um arquivo de acordo com um formato</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>mixed</type><methodname>fscanf</methodname>
      <methodparam><type>int</type><parameter>handle</parameter></methodparam>
      <methodparam><type>string</type><parameter>formato</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
     A funo <function>fscanf</function>  semelhante a
     <function>sscanf</function>, mas usa como entrada um arquivo
     associado com <parameter>handle</parameter> e interpreta a
     entrada de acordo com o <parameter>formato</parameter>
     especificado. Se somente dois parametros forem passados a esta
     funo, os valores parsed sero retornados como um array.
     De outro modo, se parametros opcionais so passados a funo
     ir retornar o nmero de valores utilizados. Os parametros opcionais
     tem que ser passados por referncia.
     <example>
      <title>Exemplo do <function>fscanf</function></title>
      <programlisting role="php">
$fp = fopen ("users.txt","r");
while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
    list ($name, $profission, $countrycode) = $userinfo;
    //... fazer algo com os valores
}
fclose($fp);
      </programlisting>
     </example>
     <example>
      <title>users.txt</title>
      <programlisting>
javier  argonauta        pe
hiroshi escultor         jp
robert  tradutor         us
luigi   florista         it
      </programlisting>
     </example>
    </para>
    <para>
     Veja tambm <function>fread</function>, <function>fgets</function>,
     <function>fgetss</function>, <function>sscanf</function>,
     <function>printf</function>, e <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fseek">
   <refnamediv>
    <refname>fseek</refname>
    <refpurpose>Procura (seeks) em um ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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>
     Modifica o indicador de posio do arquivo referenciado por
     <parameter>fp</parameter>. A nova posio  obtida, medindo em
     bytes do incio do arquivo,  obtida ao adicionar
     <parameter>offset</parameter> a posio especificada por
     <parameter>whence</parameter>, cujo valor  definido como
     se segue:
     <simplelist>
      <member>SEEK_SET - Use a posio igual  <parameter>offset</parameter>
      bytes. </member> <member>SEEK_CUR - Use a posio para a 
      localizao atual mais <parameter>offset</parameter>.</member>
      <member>SEEK_END - Use a posio para o fim do arquivo (eof)
      mais <parameter>offset</parameter>.</member>
     </simplelist>
    </para>
    <para>Se <parameter>whence</parameter> no  especificado 
     presumido ser SEEK_SET.
    </para>
    <para>
     Em caso de sucesso, retorna 0; caso contrrio, retorna -1. Note
     que fazer um seek depois do fim do arquivo (eof)  considerado 
     um erro.
    </para>
    <para>
     No pode ser usado em ponteiros de arquivo retornados por 
     <function>fopen</function> se for usado o formato "http://"
     ou "ftp://".
    </para>
    <note>
     <para>
      O argumento <parameter>whence</parameter> foi adicionado depois do
      PHP 4.0 RC1.
     </para>
    </note>
    <para>
     Veja tambm <function>ftell</function> e
     <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fstat">
   <refnamediv>
    <refname>fstat</refname>
    <refpurpose>
     Ler a informao sobre um arquivo usando um ponteiro de arquivo aberto
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>fstat</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Mantm estatsticas do arquivo aberto pelo ponteiro de
     arquivos fp. Esta funo  similar a funo
     <function>stat</function> exceto que ela opera em um
     ponteiro de arquivo aberto ao invz de um nome de arquivo.
    </para>
    <para>
     Retorna um array com as estatsticas do arquico com os seguintes
     elementos:
     <orderedlist>
      <listitem><simpara>device</simpara></listitem>
      <listitem><simpara>inode</simpara></listitem>
      <listitem><simpara>nmero de links</simpara></listitem>
      <listitem><simpara>user id do dono (owner)</simpara></listitem>
      <listitem><simpara>group id (owner)</simpara></listitem>
      <listitem><simpara>tipo de device se inode device *</simpara></listitem>
      <listitem><simpara>tamanho em bytes</simpara></listitem>
      <listitem><simpara>tempo do ltimo acesso</simpara></listitem>
      <listitem><simpara>tempo da ltima modificao(modification)</simpara></listitem>
      <listitem><simpara>tempo da ltima mudana(change)</simpara></listitem>
      <listitem><simpara>tamanho do bloco para o filesystem I/O *</simpara></listitem>
      <listitem><simpara>nmero de blocos alocados</simpara></listitem>
     </orderedlist>
     * - somente vlido em sistemas suportando o tipo st_blksize--outros
     sistemas (por exemplo Windows) retornam -1</para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes. 
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftell">
   <refnamediv>
    <refname>ftell</refname>
    <refpurpose>Diz ao ponteiro de arquivo a posio de leitura/gravao</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>ftell</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna a posio do ponteiro de arquivo referenciado por fp; por
     exemplo o seu offset no file stream.
    </para>
    <para>
     Se um error ocorrer, retorna &false;.
    </para>
    <para>
     O ponteiro de arquivo tem que ser vlidoe apontar para um 
     arquivo aberto com sucesso por <function>fopen</function> ou
     <function>popen</function>.
    </para>
    <para> 
     Veja tambm <function>fopen</function>, <function>popen</function>,
     <function>fseek</function> e <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftruncate">
   <refnamediv>
    <refname>ftruncate</refname>
    <refpurpose>
     Corta um arquivo para um tamanho especificado.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>ftruncate</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>comprimento</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pega o ponteiro de arquivo, fp, e corta o arquivo no comprimento
     especificado. O arquivo final ter os 
     <parameter>comprimento</parameter> bytes iniciais idnticos ao
     arquivo original.
     Esta funo retorna &true; em caso de sucesso e &false; em caso
     de falha.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fwrite">
   <refnamediv>
    <refname>fwrite</refname>
    <refpurpose>Gravao em arquivos binary-safe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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>
        comprimento
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fwrite</function> grava os contedos de
     <parameter>string</parameter> para o stream de arquivo apontado
     por <parameter>fp</parameter>. Se o argumento
     <parameter>comprimento</parameter>  dado, a gravao ir parar
     depois de que <parameter>comprimento</parameter> bytes foram
     escritos ou o fim da <parameter>string</parameter>  alcanada,
     o que ocorrer primeiro.
    </simpara>
    <simpara>
     Note que se o argumento <parameter>comprimento</parameter>  dado,
     ento a opo de configurao <link
     linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
     ser ignorada e nenhuma barra ser retirada do
     <parameter>string</parameter>.
    </simpara>
    <note>
     <para>
      Em sistemas que diferenciam entre arquivos binrios e texto
      (por exemplo Windows) o arquivo tem que ser aberto com 'b'
      includo no parametro mode do <function>fopen</function>.
     </para>
    </note>
    <simpara>
     Veja tambm <function>fread</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function> e
     <function>fputs</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.set-file-buffer">
   <refnamediv>
    <refname>set_file_buffer</refname>
    <refpurpose>
     Configura o buffer de um ponteiro de arquivo
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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>
     A sada usando <function>fwrite</function>  normalmente 
     guardada em um buffer de 8K. Isto significa que se se tem 
     dois processos querendo gravar no mesmo stream de sada (output)
     (um arquivo), cada um  pausado depois de 8K de informaes para
     deixar o outro processo escrever. <function>set_file_buffer</function>
     configura o buffer para operaes de escrita no dado ponteiro de
     arquivo <parameter>fp</parameter> para o <parameter>buffer</parameter>
     em bytes. Se <parameter>buffer</parameter>  0 ento as operaes
     de escrita no utilizaro o buffer. Isso garante que todas
     as gravaes com <function>fwrite</function> so completadas
     antes que outros processos so possibilitados de escreverem
     para este stream de sada.
    </simpara>
    <simpara>
     Esta funo retorna 0 em caso de sucesso, ou fim do arquivo (eof)
     se o pedido no puder ser honrado.
    </simpara>
    <para>
     O seguinte exemplo demonstra como usar 
     <function>set_file_buffer</function> para criar um stream
     sem usar o buffer.
     <example>
      <title>exemplo de <function>set_file_buffer</function></title>
      <programlisting role="php">
$fp=fopen($arquivo, "w");
if($fp){
  set_file_buffer($fp, 0);
  fputs($fp, $saida);
  fclose($fp);
}
      </programlisting>
     </example>
    </para>

    <simpara>
     Veja tambm <function>fopen</function> e <function>fwrite</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.is-dir">
   <refnamediv>
    <refname>is_dir</refname>
    <refpurpose>Diz se o arquivo  um diretrio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_dir</methodname>
      <methodparam><type>string</type><parameter>nomedorarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se o nomedoarquivo existe e  um diretrio.
    </para>
    <para>
     Os resultados desta funo so guardados em cache.
     Veja <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessvel pelo filesystem do servidor.
    </simpara>
    <para>
     Veja tambm <function>is_file</function> e
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-executable">
   <refnamediv>
    <refname>is_executable</refname>
    <refpurpose>Diz se um arquivo  executvel</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_executable</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se no nomedoarquivo existe e  executvel.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes. 
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
    <para>
     Veja tambm <function>is_file</function> e
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-file">
   <refnamediv>
    <refname>is_file</refname>
    <refpurpose>
     Diz se o arquivo  um arquivo comum
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_file</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se o nome do nomedoarquivo existe e  um arquivo comum.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <para>
     Veja tambm <function>is_dir</function> e
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-link">
   <refnamediv>
    <refname>is_link</refname>
    <refpurpose>
     Diz se o arquivo  um link simblico (symbolic link)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_link</methodname>
      <methodparam><type>string</type><parameter>arquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se o nomedoarquivo existe e  um link simblico
     (symbolic link).
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes. 
    </para>
    <para>
     Veja tambm <function>is_dir</function> e
     <function>is_file</function>.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.is-readable">
   <refnamediv>
    <refname>is_readable</refname>
    <refpurpose>
     Diz se o arquivo  legivel (readable)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_readable</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se o nomedoraquivo existe e  legvel (readable).
    </para>
    <para>
     Lembre-se que o PHP deve estar acessando o arquivo como o mesmo
     usurio que o servidor de web roda (frequentemente 'nobody').
     Limitaes do safemode no so levadas em considerao.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes. 
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessivel pelo filesystem do servidor.
    </simpara>
    <para>
     Veja tambm <function>is_writable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writable">
   <refnamediv>
    <refname>is_writable</refname>
    <refpurpose>Diz se pode-se escrever para o arquivo(writable)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writable</methodname>
      <methodparam><type>string</type><parameter>arquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Retorna &true; se o nomedoarquivo existe e pode ser escrito para.
     O argumento nomedoarquivo pode ser um nome de diretrio, deixando
     voc saber se o diretrio pode ser escrito para (writeable).
    </para>
    <para>
     Lembre-se que o PHP deve estar acessando o arquivo como o mesmo
     usurio que o servidor de web roda (frequentemente 'nobody').
     Limitaes do safemode no so levadas em considerao.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
    <simpara>
     Esta funo no funcionar em <link
     linkend="features.remote-files">arquivos remotos</link>; o arquivo
     a ser examinado tem que ser acessvel pelo filesystem do servidor.
    </simpara>
    <para>
     Veja tambm <function>is_readable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writeable">
   <refnamediv>
    <refname>is_writeable</refname>
    <refpurpose>Diz se pode-se escrever para o arquivo(writable)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writeable</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Esta  uma funo sinnima (alias) para 
     <function>is_writable</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-uploaded-file">
   <refnamediv>
    <refname>is_uploaded_file</refname>
    <refpurpose>Diz se o arquivo foi uploaded via HTTP POST</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>

    <para>
     Esta funo  somente disponvel em verses do PHP3 depois de
     3.0.16, e em verses do PHP 4 depois de 4.0.2.
    </para>

    <para>
     Retorna &true; se o arquivo com o nome <varname>nomedoarquivo</varname>
     foi uploaded via HTTP POST. Isto  til para ter certeza que um
     usurio malicioso, no est tentando confundir o script em trabalhar
     em arquivos que no deve estar trabalhando--por exemplo,
     <filename>/etc/passwd</filename>.
    </para>

    <para>
     Este tipo de confirmao  importante principalmente se existe
     alguma chance que qualquer coisa feita com os arquivos uploadeados
     poderiam revelar o seu contedo para o usurio, ou mesmo
     para outros usurios no mesmo sistema.
    </para>

    <para>
     Veja tambm <function>move_uploaded_file</function>, e a seo
     <link linkend="features.file-upload">Handling file uploads</link>
     para um simples exemplo de utilizao desta funo.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.link">
   <refnamediv>
    <refname>link</refname>
    <refpurpose>Criando um hard link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>link</methodname>
      <methodparam><type>string</type><parameter>alvo</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>link</function> cria um hard link.</para>
    <para>
     Veja tambm <function>symlink</function> para criar soft links,
     e <function>readlink</function> assim como
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.linkinfo">
   <refnamediv>
    <refname>linkinfo</refname>
    <refpurpose>Ler informaes sobre um link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>linkinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>linkinfo</function> retorna o campo st_dev da 
     structure em C do UNIX retornado pela chamada do sistema 
     (system call) lstat. Esta funo  usada para verificar
     se um link (apontado por <parameter>path</parameter>)
     realmente existe (usando o mesmo metodo que a macro S_ISLNK
     definida em stat.h). Retorna 0 ou &false; em caso de erro.
    </para>
    <para>
     Veja tambm <function>symlink</function>, <function>link</function>,
     e <function>readlink</function>.
    </para>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.mkdir">
   <refnamediv>
    <refname>mkdir</refname>
    <refpurpose>Criar um diretrio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>mkdir</methodname>
      <methodparam><type>string</type><parameter>nomedopath</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Tenta criar o diretrio especificado por 
     <parameter>nomedopath</parameter>.
    </para>
    <para>
     Note que voc provavelmente quer especificar o mode como
     um nmero octal, o que significa que ele deve ter o zero
     inicial. O mode  tambm modificado pela umaks atual,
     o que voc pode mudar usando <function>umask</function>.
     <informalexample>
      <programlisting role="php">
mkdir ("/path/para/o/meu/dir", 0700);
      </programlisting>
     </informalexample>
    </para>
    <para>
     Retorna &true; em sucesso e &false; em caso de falha.
    </para>
    <para>
     Veja tambm <function>rmdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.move-uploaded-file">
   <refnamediv>
    <refname>move_uploaded_file</refname>
    <refpurpose>Move um arquivo uploadeado para uma nova localizao</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>bool</type><methodname>move_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam><type>string</type><parameter>destino</parameter></methodparam>
     </methodsynopsis>

    <para>
     Esta funo est disponvel somente em verses do PHP 3 depois
     da 3.0.16, e em verses do PHP 4 depois da 4.0.2.
    </para>

    <para>
     Esta funo checa para ter certeza que o arquivo designado por
     <parameter>nomedoarquivo</parameter>  um arquivo vlido 
     uploadeado (significando que ele foi uploadeado pelo mecanismo
     do PHP de HTTP POST). Se o arquivo  vlido, ele ser movido
     para o nomedoarquivo dado pelo <parameter>destino</parameter>.
    </para>

    <para>
     Se <parameter>nomedoarquivo</parameter> no  um arquivo
     uploadeado vlido, ento no haver nenhuma ao e 
     <function>move_uploaded_file</function> ir retornar &false;.
     &false;. 
    </para>

    <para>
     Se <parameter>nomedoarquivo</parameter>  um arquivo uploadeado
     vlido e no pode ser movido por alguma razo, nenhuma ao
     ir ocorrer, e <function>move_uploaded_file</function> ir 
     retornar &false;. Adicionalmente, um aviso ser transmitido.
    </para>

    <para>
     Este tipo de confirmao  importante principalmente se existe
     alguma chance que qualquer coisa feita com os arquivos uploadeados
     poderiam revelar o seu contedo para o usurio, ou mesmo
     para outros usurios no mesmo sistema.
    </para>

    &note.sm.uidcheck;

    <para>
     Veja tambm <function>is_uploaded_file</function>, e a seo
     <link linkend="features.file-upload">Handling file uploads</link>
     para um simples exemplo de utilizao desta funo.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.parse-ini-file">
   <refnamediv>
    <refname>parse_ini_file</refname>
    <refpurpose>Parse um arquivo de configurao</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_ini_file</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>
        processar_secoes
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>parse_ini_file</function> carrega no
     arquivo ini especificado no 
     <parameter>nomedoarquivo</parameter>, e retorna as 
     configuraes dele em um array associativo.
     Ao usar <parameter>processar_secoes</parameter> como
     &true;, voc receber um array multidimensional, com
     os nomes das sees e os parametros incluidos. O
     padro (default) para 
     <parameter>processar_secoes</parameter>  &false;.
    </para>
    <note>
     <para>
      Esta funo no tem nada a ver com o arquivo
      <filename>php.ini</filename>. Este j  processado na hora
      que voc executa o script. Esta funo pode ser usada para ler
      os arquivos de configurao de sua prpria aplicao.
     </para>
    </note>
    <para>
     A estrutura do arquivo ini  similar a do 
     <filename>php.ini</filename>.
    </para>
    <para>
     <example>
      <title>Contedo de exemplo.ini</title>
      <programlisting>
; Este  um arquivo de configurao de exemplo
; Comentrio comeam com ';', como no php.ini

[primeira_secao]
um = 1
cinco = 5

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

// Parse sem as sees
$ini_array = parse_ini_file("exemplo.ini");
print_r($ini_array);

// Parse com as sees
$ini_array = parse_ini_file("exemplo.ini", TRUE);
print_r($ini_array);

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Would produce:
     <informalexample>
      <programlisting>
Array
(
    [um] => 1
    [cinco] => 5
    [path] => /usr/local/bin
)
Array
(
    [primeira_secao] => Array
        (
            [um] => 1
            [cinco] => 5
        )

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

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

  <refentry id="function.pathinfo">
   <refnamediv>
    <refname>pathinfo</refname>
    <refpurpose>Retorna informao sobre o path de um arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>pathinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>pathinfo</function> retorna um array associatico
     contendo informaes sobre o <parameter>path</parameter>. O
     seguinte elementos do array so retornados:
     <parameter>dirname</parameter>, <parameter>basename</parameter>
     e <parameter>extension</parameter>.
    </para>
    <para>
     <example>
      <title>Exemplo de <function>pathinfo</function></title>
      <programlisting role="php">
&lt;?php

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

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

?&gt;
      </programlisting>
     </example>
    </para>
    <para>
     Produziria:
     <informalexample>
      <programlisting>
/www/htdocs
index.html
html
      </programlisting>
     </informalexample>
    </para>
    <para>
     Veja tambm <function>dirname</function>,
     <function>basename</function>, <function>parse_url</function>
     e <function>realpath</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pclose">
   <refnamediv>
    <refname>pclose</refname>
    <refpurpose>Fechar um processo de um ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>pclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Fecha um ponteiro de arquivo a uma pipe aberta por
     <function>popen</function>.
    </para> 
    <para>
     O ponteiro de arquivo tem que ser vlido e tem que ser retornado
     por uma chamada bem sucedida a funo <function>popen</function>.
    </para> 
    <para>
     Retorna o status da terminao do processo que rodava.
    </para>
    <para>
     Veja tambm <function>popen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.popen">
   <refnamediv>
    <refname>popen</refname>
    <refpurpose>Abrir um processo de ponteiro de arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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> 
     Abre uma pipe para um processo executado ao se dar um fork
     para o comando dado por command.
    </para>
    <para>
     Retorna um ponteiro de arquivo identico ao retornado por 
     <function>fopen</function>, exceto que ele  unidirecional
     (somente pode ser usado para leitura ou gravao) e tem que ser
     fechado com pclose. Este ponteiro pode ser usado com
     <function>fgets</function>, <function>fgetss</function> e
     <function>fputs</function>.
    </para>
    <para>
     Caso um erro ocorra retorna &false;.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
$fp = popen ("/bin/ls", "r");
      </programlisting>
     </informalexample>
    </para>
    <para>
     Veja tambm <function>pclose</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readfile">
   <refnamediv>
    <refname>readfile</refname>
    <refpurpose>Ler o contedo de um arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>readfile</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     L um arquivo e escreve o seu contedo para a sada padro
     (standard output).
    </para>
    <para>
     Retorna o nmero de bytes lido do arquivo. Se um error ocorrer,
     retorna &false; e ao menos que a funo seja chamada como
     @readfile, uma mensagem de erro ser impressa.
    </para>
    <para>
     Se <parameter>nomedoarquivo</parameter> comeca com "http://"
     (no diferencia entre maisculas e mnusculas), uma conexo
     HTTP 1.0 ser aberta para o servidor especficado e o texto
     da resposta ser escrito para a sada padro (standard output).
    </para>
    <para>
     Verses anteriores a PHP 4.0.5 no comportam redirecionamento de
     HTTP. Por causa disto, diretrios tem que incluir a barra ao fim.
    </para>
    <para>
     Se <parameter>nomedoarquivo</parameter> comea com "ftp://"
     (no diferencia entre maisculas e mnusculas), uma conexo
     para o servidor especificado  aberta e o arquivo requisitado 
     escrito e o arquivo requisitado  escrito para a sada padro
     (standard output). Se o servidor no suporta modo passivo, ista
     conexo ir falhar.
    </para>
    <para>
     Se o <parameter>nomedoarquivo</parameter> no comear com nenhuma
     das duas strings acima, o arquivo ser aberto do filesystem e
     o seu contedo escrito para a sada padro (standard output).
    </para>
    <para>
     Voc pode usar o segundo parametro opcional e o setar para "1",
     se voc quiser procurar o arquivo no  <link
     linkend="ini.include-path">include_path</link>, tambm.
     <link linkend="ini.include-path">include_path</link>, too.
    </para>
    <para>
     Veja tambm <function>fpassthru</function>,
     <function>file</function>, <function>fopen</function>,
     <function>include</function>, <function>require</function> e
     <function>virtual</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readlink">
   <refnamediv>
    <refname>readlink</refname>
    <refpurpose>Retornar o alvo de um link simblico</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>readlink</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
    <function>readlink</function> faz o mesmo que a funo do C
    readlink e retorna os contedos do path do link simblico ou
    0 em caso de erro.
    </para>
    <para>
     Veja tambm <function>symlink</function>,
     <function>readlink</function> e
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
     Esta funo no funciona em sistemas Windows
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.rename">
   <refnamediv>
    <refname>rename</refname>
    <refpurpose>Renomear um arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>rename</methodname>
      <methodparam><type>string</type><parameter>nomeantigo</parameter></methodparam>
      <methodparam><type>string</type><parameter>novonome</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Tenta renomear <parameter>nomeantigo</parameter> para
     <parameter>novonome</parameter>.
    </para> 
    <para>
     Retorna &true; em caso de sucesso, &false; caso contrrio.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rewind">
   <refnamediv>
    <refname>rewind</refname>
    <refpurpose>Reinicializa a posio do ponteiro de arquivos para o incio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>rewind</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>   
     Muda o indicador de ponteiro de arquivo fp para o incio do
     stream do arquivo.</para> <para> Se um erro ocorrer, 
     retornar 0.</para> <para> O ponteiro de arquivo tem que ser
     vlido e tem que apontar para um arquivo que foi aberto com
     sucesso por <function>fopen</function>.
    </para>
    <para>
     Veja tambm <function>fseek</function> e
     <function>ftell</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.rmdir">
   <refnamediv>
    <refname>rmdir</refname>
    <refpurpose>Remover um diretrio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>rmdir</methodname>
      <methodparam><type>string</type><parameter>nomedodir</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Tenta remover o diretrio com o nome de nomedodir. O diretrio
     tem que estar vazio e as permisses relevantes permitam a 
     esta operao.
    </para> 
    <para> 
     Em caso de erro, retorna 0.
    </para>
    <para>
     Veja tambm <function>mkdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stat">
   <refnamediv>
    <refname>stat</refname>
    <refpurpose>Dar informao sobre um arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>stat</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pegar estatsticas sobre o arquivo com o nome de nomedoarquivo.
    </para>
    <para>
     Retorna um array com as estatsticas do arquivo com os seguintes
     elementos:
     <orderedlist>
      <listitem><simpara>device</simpara></listitem>
      <listitem><simpara>inode</simpara></listitem>
      <listitem><simpara>inode protection mode</simpara></listitem>
      <listitem><simpara>nmero de links</simpara></listitem>
      <listitem><simpara>user id owner</simpara></listitem>
      <listitem><simpara>group id owner</simpara></listitem>
      <listitem><simpara>device type if inode device *</simpara></listitem>
      <listitem><simpara>tamanho em 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>
     * - somente vlido em sistemas supportando o tipo st_blksize--outros
     sistemas (por exemplo Windows) retornam -1.
    </para>
    <para>
     Retorna &false; em caso de erro.
    </para>
    <para>
     <function>stat</function> no suporta URL ao contrrio de
     <function>fopen</function>.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.lstat">
   <refnamediv>
    <refname>lstat</refname>
    <refpurpose>Dar informaes sobre um arquivo ou link simblico
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>array</type><methodname>lstat</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Pega as estatsticas do arquivo ou link simblico com o nome de
     nomedoarquivo. Esta funo  identica a <function>stat</function>
     exceto que se o parametro <parameter>nomedoarquivo</parameter>
      um link simblico o status do link simblico  retornado e no
     o status do arquivo apontando pelo link simblico.
    </para>
    <para>
     Retorna um array com as estatsticas do arquivo com os seguintes
     elementos:
     <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>
     * - somente vlido em sistemas supportando o tipo st_blksize--outros
     sistemas (por exemplo Windows) retornam -1.
    </para>
    <para>
     Os resultados desta funo so guardados em cache. Veja
     <function>clearstatcache</function> para mais detalhes.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.realpath">
   <refnamediv>
    <refname>realpath</refname>
    <refpurpose>Retorna o path absoluto canonicalizado</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>string</type><methodname>realpath</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>realpath</function> expande todos os links simblicos
     e resolve referencias para '/./', '/../' e extra caracteres '/'
     na entrada pelo <parameter>path</parameter> e retorna o path
     absoluto canonicalizado . O path resultante no conter nenhum
     link simblico ou componentes '/./' e '/../'.
    </para>
    <para>
     <example>
      <title>exemplo de <function>realpath</function></title>
      <programlisting role="php">
$real_path = realpath ("../../index.php");
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.symlink">
   <refnamediv>
    <refname>symlink</refname>
    <refpurpose>Criar um link simblico</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>symlink</methodname>
      <methodparam><type>string</type><parameter>alvo</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>symlink</function> cria um link simblico
     do <parameter>alvo</parameter> existente com o nome
     especificado em <parameter>link</parameter>.
    </para>
    <para>
     Veja tambm <function>link</function> para criar hard links,
     e <function>readlink</function> junto com
     <function>linkinfo</function>.
    </para>
    <note>
     <simpara>
      Esta funo no funciona em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.tempnam">
   <refnamediv>
    <refname>tempnam</refname>
    <refpurpose>Criar um nome de arquivo nico</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</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>
     Cria um nome de arquivo temporrio nico no diretrio especificado.
     Se o diretrio no existe, <function>tempnam</function> pode
     gerar o nome de arquivo no diretrio temporrio do sistema.
    </para>
    <para>
     Antes do PHP 4.0.6 o comportamento da funo
     <function>tempnam</function> era dependente do sistema.
     No Windows a vriavel de ambiente do sistema TMP ir
     sobresair o parametro <parameter>dir</parameter>, em
     Linux a vriavel de ambiente TMPDIR tem precedencia, 
     enquanto SVR4 ir sempre usar o parametro 
     <parameter>dir</parameter> se o diretrio para o qual
     ele aponta existe. Consulte a documentao do seu sistema
     para a funo tempnam(3) se em dvida.
    </para>
    <para>
     Retorna o nome temporrio do arquivo ou a string &null; em
     caso de falha.
     <example>
      <title>exemplo de <function>tempnam</function></title>
      <programlisting role="php">
$tmpfname = tempnam ("/tmp", "FOO");
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      O comportamento desta funo mudou na verso 4.0.3. O arquivo 
      temporrio  tambm criado para evitar uma condio de corrida (race)
      onde o arquivo pode aparecer no filesystem entre o tempo que a string
      foi gerada e antes que o script tem tempo para criar o arquivo.
     </simpara>
    </note>
    <para>
      Veja tambm <function>tmpfile</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.tmpfile">
   <refnamediv>
    <refname>tmpfile</refname>
    <refpurpose>Criar um arquivo temporrio</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>arqtmp</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Cria um arquivo temporrop com um nome nico em modo de
     gravao, retornando o handle do arquivo em modo similar ao
     retornado por <function>fopen</function>.
     O arquivo  automticamente apagado quando fechado (usando
     <function>fclose</function>), ou quando o script acaba.
    </para>
    <para>
     Para detalhes consulte a documentao do seu sistem
     na funo <literal>tmpfile(3)</literal>, assim como o
     header <filename>stdio.h</filename>.
    </para>
    <para>
     Veja tambm <function>tempnam</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.touch">
   <refnamediv>
    <refname>touch</refname>
    <refpurpose>Mudar o tempo de modificao do arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>touch</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
         tempo
        </parameter></methodparam>
     </methodsynopsis>
    <para>
     Tenta mudar o tempo de modificao do arquivo com o nome de
     nomedoarquivo para o valor dado por tempo. Se a opo de tempo
     no  dada, o tempo atual ser usado.
    </para>
    <para>
     Se o arquivo no existe, ele  criado.
    </para>
    <para>
     Retorna &true; em caso de sucesso e &false; caso contrrio.
     <example>
      <title>exemplo da funo <function>touch</function></title>
      <programlisting role="php">
if (touch ($nomedoarquivo)) {
    print "o tempo do $nomedoarquivo foi modificado
           para o dia e hora de agora";
} else {
    print "Desculpe, no foi possivel modificar o tempo de $nomedoarquivo";
}
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.umask">
   <refnamediv>
    <refname>umask</refname>
    <refpurpose>Modificar a umask atual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>umask</methodname>
      <methodparam><type>int</type><parameter>mask</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>umask</function> modifica o umask do PHP para o mask 
     &amp; 0777 e retorna o umask antigo. Quando o PHP est sendo 
     usado como um mdulo do servidor o umask  restaurado quando 
     o pedido acaba.
    </para>
    <para>
     <function>umask</function> sem argumentos simplesmente retorna
     o umask atual.
    </para>
    <note>
     <simpara>
      Esta funo pode no funcionar em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.unlink">
   <refnamediv>
    <refname>unlink</refname>
    <refpurpose>Deleta um arquivo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrio</title>
     <methodsynopsis>
      <type>int</type><methodname>unlink</methodname>
      <methodparam><type>string</type><parameter>nomedoarquivo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Deleta <parameter>nomedoarquivo</parameter>. Similar a funo
     C no Unix unlink().
    </para>
    <para>
     Retorna 0 ou &false; em caso de erro.
    </para>
    <para>
     Veja tambm <function>rmdir</function> para remover diretrios.
    </para>
    <note>
     <simpara>
      Esta funo pode no funcionar em sistemas Windows.
     </simpara>
    </note>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->