archived-doc-it/reference/filesystem/functions/stat.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 -->
<!-- EN-Revision: n/a Maintainer: fernando Status: working -->
<!-- CREDITS: cortesi -->
<refentry xml:id="function.stat" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>stat</refname>
    <refpurpose>Da informazioni su un file</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>stat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Restituisce una serie di informazioni a riguardo del file <parameter>filename</parameter>.
     Se il parametro <parameter>filename</parameter> è un link simbolico, le informazioni riguardano il file stesso,
     e non il file puntato dal link. La funzione <function>lstat</function> è identica a<function>
     stat</function> tranne che dovrebbe restituire il file puntato dal link.
    </para>
    <para>
     In caso di errore <function>stat</function> restituisce &false;. Inoltre
     genera un warning.
    </para>
    <para>
    La funzione restituisce un vettore con le informazioni sul file contenente i
     seguenti elementi. Il vettore parte dall'indice zero. Oltre agli indici numerici
     il vettore contiene indici
     associativi, come sarà indicato per ciascun parametro; questo è disponibile
     dal PHP versione 4.0.6.
    </para>
    <para>
     <table>
      <title>Formato del vettore restituito da <function>stat</function>
       e <function>fstat</function></title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Indice numerico</entry>
         <entry>Associativo (da PHP 4.0.6)</entry>
         <entry>Descrizione</entry>
        </row>
       </thead>
       <tbody>
        <row>
         <entry>0</entry>
         <entry>dev</entry>
         <entry>device</entry>
        </row>
        <row>
         <entry>1</entry>
         <entry>ino</entry>
         <entry>inode</entry>
        </row>
        <row>
         <entry>2</entry>
         <entry>mode</entry>
         <entry>modalità di protezione dell'inode</entry>
        </row>
        <row>
         <entry>3</entry>
         <entry>nlink</entry>
         <entry>numero di link</entry>
        </row>
        <row>
         <entry>4</entry>
         <entry>uid</entry>
         <entry>ID utente del proprietario</entry>
        </row>
        <row>
         <entry>5</entry>
         <entry>gid</entry>
         <entry>ID del gruppo del proprietario</entry>
        </row>
        <row>
         <entry>6</entry>
         <entry>rdev</entry>
         <entry>tipo di device con l'inode device *</entry>
        </row>
        <row>
         <entry>7</entry>
         <entry>size</entry>
         <entry>dimensione in byte</entry>
        </row>
        <row>
         <entry>8</entry>
         <entry>atime</entry>
         <entry>ora dell'ultimo accesso (Unix timestamp)</entry>
        </row>
        <row>
         <entry>9</entry>
         <entry>mtime</entry>
         <entry>ora del'ultima modifica (Unix timestamp)</entry>
        </row>
        <row>
         <entry>10</entry>
         <entry>ctime</entry>
         <entry>ora dell'ultimo cambiamento di inode(Unix timestamp)</entry>
        </row>
        <row>
         <entry>11</entry>
         <entry>blksize</entry>
         <entry>dimensione del blocco per l'I/O di filesystem *</entry>
        </row>
        <row>
         <entry>12</entry>
         <entry>blocks</entry>
         <entry>numero dei blocchi allocati</entry>
        </row>

       </tbody>
      </tgroup>
     </table>
     * - valida solo su sistemi che supportano il tipo st_blksize--altri sistemi
     (ad esempio Windows) restituiscono -1.

    &note.clearstatcache;

    &tip.fopen-wrapper.stat;
    </para>
    <para>
     Vedere anche <function>lstat</function>,
     <function>fstat</function>,
     <function>filemtime</function> e
     <function>filegroup</function>.
    </para>
   </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:"~/.phpdoc/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
-->