rarruda Sun Jan 13 07:06:27 2002 EDT
Modified files:
/phpdoc/pt_BR/functions dir.xml
Log:
initial translation
Index: phpdoc/pt_BR/functions/dir.xml
diff -u /dev/null phpdoc/pt_BR/functions/dir.xml:1.3
--- /dev/null Sun Jan 13 07:06:27 2002
+++ phpdoc/pt_BR/functions/dir.xml Sun Jan 13 07:06:27 2002
@@ -0,0 +1,305 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.3 $ -->
+ <reference id="ref.dir">
+ <title>Fun��es de diret�rio</title>
+ <titleabbrev>Diret�rios</titleabbrev>
+
+ <partintro>
+
+ <simpara>
+ Para fun��es relacionadas como <function>dirname</function>,
+ <function>is_dir</function>, <function>mkdir</function>, and
+ <function>rmdir</function>, veja a se��o
+ <link linkend="ref.filesystem">Filesystem</link>.
+ </simpara>
+
+ </partintro>
+
+ <refentry id="function.chroot">
+ <refnamediv>
+ <refname>chroot</refname>
+ <refpurpose>mudar o diret�rio raiz (root)</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>chroot</function></funcdef>
+ <paramdef>string <parameter>diretorio</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Muda o diret�rio raiz (root) do processo atual para o
+ <parameter>diretorio</parameter>. Retorna &false; se n�o for
+ poss�vel mudar o diret�rio raiz, retorna &true; caso contr�rio.
+ </para>
+ <note>
+ <para>
+ N�o � sensato usar esta fun��o quando rodando em um ambiente
+ de um webserver, porque n�o � poss�vel reiniciar o diret�rio
+ raiz (root) para / novamente no fim do pedido (request). Esta
+ fun��o ir� somente funcionar corretamente quando rodando como
+ CGI desta forma.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.chdir">
+ <refnamediv>
+ <refname>chdir</refname>
+ <refpurpose>mudar de diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>chdir</function></funcdef>
+ <paramdef>string <parameter>diretorio</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Muda o diret�rio atual do PHP para <parameter>diretorio</parameter>.
+ Retorna &false; se n�o for poss�vel mudar de diret�rio, retorna &true
+ caso contr�rio.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="class.dir">
+ <refnamediv>
+ <refname>dir</refname>
+ <refpurpose>classe diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>objeto <function>dir</function></funcdef>
+ <paramdef>string <parameter>diretorio</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Um mecanismo pseudo-orientado a objeto para ler um diret�rio.
+ O parametro dado <parameter>diretorio</parameter> � aberto.
+ Duas propriedades s�o dispon�veis uma vez que o diret�rio foi aberto.
+ A propriedade sin�nima pode ser usada com outras fun��es de diret�rio
+ como <function>readdir</function>, <function>rewinddir</function> e
+ <function>closedir</function>. A propriedade path � configurada
+ para o path que o diret�rio foi aberto. Tr�s metodos s�o
+ disponibilizados: read, rewind e close.
+ <example>
+ <title><function>dir</function> example</title>
+ <programlisting role="php">
+<![CDATA[
+$d = dir("/etc");
+echo "Handle: ".$d->handle."<br>\n";
+echo "Path: ".$d->path."<br>\n";
+while (false !== ($entry = $d->read())) {
+ echo $entry."<br>\n";
+}
+$d->close();
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <note>
+ <para>
+ A ordem em que os diret�rios s�o retornadas pelo metodo � dependente do
+ sistema.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.closedir">
+ <refnamediv>
+ <refname>closedir</refname>
+ <refpurpose>fechar o handle do diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>closedir</function></funcdef>
+ <paramdef>resource <parameter>dir_handle</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Fecha o stream do diret�rio indicado por
+ <parameter>dir_handle</parameter>. O stream deve ter sido previamente
+ aberto por <function>opendir</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.getcwd">
+ <refnamediv>
+ <refname>getcwd</refname>
+ <refpurpose>obter o diret�rio atual</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>getcwd</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Retorna o diret�rio atual.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.opendir">
+ <refnamediv>
+ <refname>opendir</refname>
+ <refpurpose>abrir o handle do diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>resource <function>opendir</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Retorna um handle de diret�rio para ser usado em chamadas
+ subsequentes a <function>closedir</function>,
+ <function>readdir</function>, e <function>rewinddir</function>.
+ </para>
+ <para>
+ Se o <parameter>path</parameter> n�o � um diret�rio v�lido ou
+ o diret�rio n�o pode ser aberto devido a restri��es das permiss�es
+ ou erros no filesystem, <function>opendir</function> retorna
+ &false; e gera um erro do PHP. Voc� pode suprimir o erro na
+ sa�da de <function>opendir</function> no seu script ao se
+ inserir `@' na frente do nome da fun��o.
+ </para>
+ <para>
+ <example>
+ <title>exemplo de <function>opendir</function></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+if ($dir = @opendir("/tmp")) {
+ while (($file = readdir($dir)) !== false) {
+ echo "$file\n";
+ }
+ closedir($dir);
+}
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.readdir">
+ <refnamediv>
+ <refname>readdir</refname>
+ <refpurpose>ler os campos do handle do diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>readdir</function></funcdef>
+ <paramdef>resource <parameter>dir_handle</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Retorna o nomedoarquivo do pr�cimo arquivo do diret�rio. Os
+ nomedoarquivos n�o ser�o retornados em alguma ordem particular.
+ <example>
+ <title>Lista todos os arquivos do diret�rio atual</title>
+ <programlisting role="php">
+<![CDATA[
+// Note que !== n�o existia at� o PHP 4.0.0-RC2
+<?php
+$handle=opendir('.');
+echo "Handle do diret�rio: $handle\n";
+echo "Arquivos:\n";
+while (false !== ($file = readdir($handle))) {
+ echo "$file\n";
+}
+closedir($handle);
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Note que <function>readdir</function> ir� retornar o <literal>.</literal>
+ e <literal>..</literal> . Se voc� n�o quer estes simplesmente os retire:
+ <example>
+ <title>
+ Listar todos os arquivo no diret�rio atual e retirar <literal>.</literal>
+ e <literal>..</literal>
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$handle = opendir('.');
+while (false !== ($file = readdir($handle))) {
+ if ($file != "." && $file != "..") {
+ echo "$file\n";
+ }
+}
+closedir($handle);
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.rewinddir">
+ <refnamediv>
+ <refname>rewinddir</refname>
+ <refpurpose>voltar (rewind) o handle de diret�rio</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descri��o</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>rewinddir</function></funcdef>
+ <paramdef>resource <parameter>dir_handle</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Reinicia o stream do diret�rio indicado por
+ <parameter>dir_handle</parameter> para o in�cio do diret�rio.
+ </para>
+
+ </refsect1>
+ </refentry>
+
+ </reference>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
