cvs: phpdoc /it/functions dir.xml

cortesi Thu Nov 8 10:26:44 2001 EDT Modified files: /phpdoc/it/functions dir.xml Log: first translation in italian

Index: phpdoc/it/functions/dir.xml diff -u /dev/null phpdoc/it/functions/dir.xml:1.8 --- /dev/null Thu Nov 8 10:26:44 2001 +++ phpdoc/it/functions/dir.xml Thu Nov 8 10:26:44 2001 @@ -0,0 +1,291 @@ +<?xml encoding="iso-8859-1"?> +<!-- EN-Revision: 1.23 Maintainer: cortesi Status: ready --> + <reference id="ref.dir"> + <title>Funzioni per le directory</title> + <titleabbrev>Directory</titleabbrev> + + <partintro> + + <simpara> + Per funzioni correlate, quali <function>dirname</function>, + <function>is_dir</function>, <function>mkdir</function> e + <function>rmdir</function>, vedere la sezione + <link linkend="ref.filesystem">Filesystem</link>. + </simpara> + + </partintro> + + <refentry id="function.chroot"> + <refnamediv> + <refname>chroot</refname> + <refpurpose>cambia la direcory di root</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>chroot</function></funcdef> + <paramdef>string <parameter>directory</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Cambia la directory di root del processo in esecuzione in + <parameter>directory</parameter>. Restituisce &false; se non in grado + di cambiare la directory root, altrimenti &true;. + </para> + <note> + <para> + Non &egrave; intelligente usare questa funzione quando ci si trova nell'ambiente di lavoro + di un webserver, poich&eacute; non &egrave; possibile resettare la directory root + nuovamente a / alla fine della richiesta. Questa funzione + si comporta correttamente solo quando eseguita come CGI. + </para> + </note> + </refsect1> + </refentry> + + <refentry id="function.chdir"> + <refnamediv> + <refname>chdir</refname> + <refpurpose>cambia directory</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>chdir</function></funcdef> + <paramdef>string <parameter>directory</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Cambia la directory in uso da parte del PHP in + <parameter>directory</parameter>. Restituisce &false; se non in grado di + cambiare directory, &true; altrimenti. + </para> + </refsect1> + </refentry> + + <refentry id="class.dir"> + <refnamediv> + <refname>dir</refname> + <refpurpose>classe directory</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>dir</function></funcdef> + <paramdef>string <parameter>directory</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Un meccanismo pseudo orientato agli oggetti per leggere una directory. La + <parameter>directory</parameter> data &egrave; aperta. Due propriet&agrave; + sono disponibili nonappena la directory &egrave; stata aperta. La + propriet&agrave; handle pu&ograve; essere usata in congiunzione ad altre funzioni relative alle directory, quali + <function>readdir</function>, <function>rewinddir</function> e + <function>closedir</function>. La propriet&agrave; path &egrave; impostata alla + directory che &egrave; stata aperta. Sono disponibili tre metodi: + read (leggi), rewind (riavvolgi) e close (chiudi). + <example> + <title>esempio <function>dir</function></title> + <programlisting role="php"> +$d = dir("/etc"); +echo "Handle: ".$d->handle."&lt;br>\n"; +echo "Path: ".$d->path."&lt;br>\n"; +while ($entry = $d->read()) { + echo $entry."&lt;br>\n"; +} +$d->close(); + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.closedir"> + <refnamediv> + <refname>closedir</refname> + <refpurpose>chiude l'handle della directoty</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>closedir</function></funcdef> + <paramdef>resource <parameter>dir_handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Chiude il flusso directory indicato da + <parameter>dir_handle</parameter>. Il flusso deve essere stato aperto in + precedenza da <function>opendir</function>. + </para> + </refsect1> + </refentry> + + <refentry id="function.getcwd"> + <refnamediv> + <refname>getcwd</refname> + <refpurpose>restituisce la directory di lavoro in uso</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>getcwd</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + Restituisce la directory di lavoro in uso al momento. + </para> + </refsect1> + </refentry> + + <refentry id="function.opendir"> + <refnamediv> + <refname>opendir</refname> + <refpurpose>apre l'handle della directory</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>opendir</function></funcdef> + <paramdef>string <parameter>percorso</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Restituisce un handle della directory da usare nelle chiamate alle funzioni + <function>closedir</function>, <function>readdir</function> e + <function>rewinddir</function>. + </para> + <para> + Se <parameter>percorso</parameter> non &egrave; una directory valida o la + directory non pu&ograve; essere aperta a causa di restrizioni sui permessi di accesso o + a causa di errori del filesystem, <function>opendir</function> restituisce &false; e + genera un errore PHP. Si pu&ograve; sopprimere l'output dell'errore di + <function>opendir</function> anteponendo `@' davanti al nome della + funzione. + </para> + <para> + <example> + <title>esempio <function>opendir</function></title> + <programlisting role="php"> +&lt;?php + +if ($dir = @opendir("/tmp")) { + while (($file = readdir($dir)) !== false) { + echo "$file\n"; + } + closedir($dir); +} + +?&gt; + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.readdir"> + <refnamediv> + <refname>readdir</refname> + <refpurpose>legge una voce dall'handle della directory</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>readdir</function></funcdef> + <paramdef>resource <parameter>dir_handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Restituisce il nomefile del file successivo della directory. I nomi + dei file non vengono restituiti in nessun particolare ordine. + <example> + <title>Elenca tutti i file presenti nella directory in uso</title> + <programlisting role="php"> +// Nota che l'operatore !== non &egrave; esistito fino alla versione 4.0.0-RC2 +&lt;?php +$handle=opendir('.'); +echo "Handle della directory: $handle\n"; +echo "File:\n"; +while (false !== ($file = readdir($handle))) { + echo "$file\n"; +} +closedir($handle); +?&gt; + </programlisting> + </example> + </para> + <para> + Nota che <function>readdir</function> restituir&agrave; le voci <literal>.</literal> + e <literal>..</literal>. Se non si vogliono ottenere queste, si possono semplicemente + eliminare: + <example> + <title> + Elenca tutti i file della directory in uso ed elimina <literal>.</literal> + e <literal>..</literal> + </title> + <programlisting role="php"> +&lt;?php +$handle = opendir('.'); +while (false !== ($file = readdir($handle))) { + if ($file != "." &amp;&amp; $file != "..") { + echo "$file\n"; + } +} +closedir($handle); +?&gt; + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.rewinddir"> + <refnamediv> + <refname>rewinddir</refname> + <refpurpose>riavvolge l'handle della directory</refpurpose> + </refnamediv> + <refsect1> + <title>Descrizione</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>rewinddir</function></funcdef> + <paramdef>resource <parameter>dir_handle</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Reimposta il flusso della directory indicato da + <parameter>dir_handle</parameter> all'inizio della + directory. + </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 +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 +--> \ No newline at end of file