cvs: phpdoc-fr /reference/filesystem/functions stat.xml
| From: | Mehdi Achour | Date: | Fri, 09 May 2003 23:26:43 +0000 |
| Subject: | cvs: phpdoc-fr /reference/filesystem/functions stat.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-364@lists.php.net to get a copy of this message | ||
didou Fri May 9 19:26:43 2003 EDT
Modified files:
/phpdoc-fr/reference/filesystem/functions stat.xml
Log:
applying Andrew's correction
Index: phpdoc-fr/reference/filesystem/functions/stat.xml
diff -u phpdoc-fr/reference/filesystem/functions/stat.xml:1.2
phpdoc-fr/reference/filesystem/functions/stat.xml:1.3
--- phpdoc-fr/reference/filesystem/functions/stat.xml:1.2 Sat May 3 18:36:53 2003
+++ phpdoc-fr/reference/filesystem/functions/stat.xml Fri May 9 19:26:43 2003
@@ -14,36 +14,99 @@
</methodsynopsis>
<para>
<function>stat</function> renvoie les informations à propos du
- fichier filename.
- </para>
- <para>
- <function>stat</function> retourne un tableau avec les
éléments suivants :
- <itemizedlist>
- <listitem><simpara>0 : volume </simpara></listitem>
- <listitem><simpara>1 : inode</simpara></listitem>
- <listitem>
- <simpara>
- 2 : droits d'accès au fichier (mode de protection du inode).
- A convertir en octal. Voir aussi <function>fileperms</function>.
- </simpara>
- </listitem>
- <listitem><simpara>3 : nombre de liens </simpara></listitem>
- <listitem><simpara>4 : id de l'utilisateur propriétaire
</simpara></listitem>
- <listitem><simpara>5 : id du groupe
propriétaire</simpara></listitem>
- <listitem><simpara>6 : type du volume de l'inode *
</simpara></listitem>
- <listitem><simpara>7 : taille en octets </simpara></listitem>
- <listitem><simpara>8 : date du dernier accès
</simpara></listitem>
- <listitem><simpara>9 : date de la dernière modification
</simpara></listitem>
- <listitem><simpara>10 : date du dernier changement
</simpara></listitem>
- <listitem><simpara>11 : taille de bloc du système pour les
entrées/sorties * </simpara></listitem>
- <listitem><simpara>12 : nombre de blocs
alloués</simpara></listitem>
- </itemizedlist>
+ fichier <parameter>filename</parameter>. Si
<parameter>filename</parameter>
+ est un lien symbolique, les informations proviennent du fichier lui-même,
+ et non du lien symbolique. <function>lstat</function> est identique à
+ <function>stat</function> sauf que les informations seront alors basées
+ sur le lien symbolique.
+ </para>
+ <para>
+ En cas d'erreurs, <function>stat</function> retourne &false;. Elle
+ générera aussi un avertissement.
+ </para>
+ <para>
+ Retourne un tableau avec des informations sur le fichier avec les
+ éléments suivants. Ce tableau commence à zéro.
+ En plus de retourner ces attributs dans un tableau indéxé,
+ ils peuvent être accédés par leurs clefs, comme
+ mentionné à côté de chaque paramètre;
ceci est
+ disponible depuis &php; 4.0.6 :
+ <orderedlist>
+ <listitem>
+ <simpara>
+ 0 : volume (ou encore <literal>dev</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 1 : inode (ou encore <literal>ino</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 2 : droits d'accès au fichier (mode de protection du inode).
+ A convertir en octal. Voir aussi <function>fileperms</function>.
+ (ou encore <literal>mode</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 3 : nombre de liens (ou encore <literal>nlink</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 4 : id de l'utilisateur propriétaire (ou encore
+ <literal>uid</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 5 : id du groupe propriétaire (ou encore <literal>gid</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 6 : type du volume de l'inode * (ou encore <literal>rdev
+ </literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 7 : taille en octets (ou encore <literal>size</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 8 : date du dernier accès (ou encore <literal>atime</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 9 : date de la dernière modification (ou encore <literal>
+ mtime</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 10 : date du dernier changement (ou encore <literal>ctime</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 11 : taille de bloc du système pour les entrées/sorties
+ * (ou encore <literal>blksize</literal>)
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ 12 : nombre de blocs alloués (ou encore <literal>blocks</literal>)
+ </simpara>
+ </listitem>
+ </orderedlist>
* - uniquement sur les systèmes qui supportent le type st_blksize.
Les autres systèmes (i.e. Windows) retournent -1.
</para>
- <para>
- <function>stat</function> retourne &false; en cas d'erreur.
- </para>
¬e.clearstatcache;
¬e.no-remote;
<para>
@@ -52,8 +115,8 @@
<function>filemtime</function> et
<function>filegroup</function>.
</para>
- </refsect1>
- </refentry>
+ </refsect1>
+ </refentry>
<!-- Keep this comment at the end of the file
Local variables: