1
0
mirror of https://github.com/php/doc-it.git synced 2026-03-27 09:02:09 +01:00
Files
archived-doc-it/reference/dir/functions/class.dir.xml
Simone Cortesi 3129bf5808 general update to current EN
git-svn-id: https://svn.php.net/repository/phpdoc/it/trunk@96715 c90b9560-bf6c-de11-be94-00142212c4b1
2002-09-24 14:33:02 +00:00

98 lines
3.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready -->
<!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 -->
<refentry id="class.dir">
<refnamediv>
<refname>dir</refname>
<refpurpose>classe directory</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<classsynopsis>
<ooclass><classname>dir</classname></ooclass>
<constructorsynopsis>
<methodname>dir</methodname>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</constructorsynopsis>
<fieldsynopsis>
<type>string</type><varname>path</varname>
</fieldsynopsis>
<fieldsynopsis>
<type>resource</type><varname>handle</varname>
</fieldsynopsis>
<methodsynopsis><type>string</type><methodname>read</methodname><void/></methodsynopsis>
<methodsynopsis><type>void</type><methodname>rewind</methodname><void/></methodsynopsis>
<methodsynopsis><type>void</type><methodname>close</methodname><void/></methodsynopsis>
</classsynopsis>
<para>
Un meccanismo pseudo orientato agli oggetti per leggere una directory. La
<parameter>directory</parameter> data è aperta. Due propriet&agrave;
sono disponibili nonappena la directory è stata aperta. La
propriet&agrave; handle può essere usata in congiunzione ad altre funzioni relative alle directory, quali
<function>readdir</function>, <function>rewinddir</function> e
<function>closedir</function>. La proprietà path è impostata alla
directory che è stata aperta. Sono disponibili tre metodi:
read (leggi), rewind (riavvolgi) e close (chiudi).
</para>
<para>
Fare attenzione al modo in cui il valore restituito dalla funzione <function>dir</function>
è controllato nell'esempio sotto riportato. Controlliamo esplicitamente
che il valore restituito sia identico a (uguale a e dello
stesso tipo di (fare riferimento a <link linkend="language.operators.comparison">
Comparison Operators</link> per maggiori informazioni) &false;
altrimenti, ogni risultato il cui nome non venga valutato &false; farà
interrompere il ciclo.
<example>
<title>esempio <function>dir</function></title>
<programlisting role="php">
<![CDATA[
$d = dir("/etc");
echo "Handle: ".$d->handle."<br>\n";
echo "Path: ".$d->path."<br>\n";
while ($entry = $d->read()) {
echo $entry."<br>\n";
}
$d->close();
]]>
</programlisting>
</example>
</para>
<note>
<para>
L'ordine nel quale vengono restituiti i dati dal metodo read è dipendente
dal sistema usato.
</para>
</note>
<note>
<para>
Questo definisce la classe interna
<classname>Directory</classname>, ciò significa che non sarà possibile
definire una nuova classe con lo stesso nome. Per una lista completa
delle classi predefinite presenti in PHP, fare riferimento a <link
linkend="reserved.classes">Predefined Classes</link>.
</para>
</note>
</refsect1>
</refentry>
<!-- 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
-->