CVS update: php3/doc/functions

Date: Sunday September 6, 1998 @ 2:50 Author: jaakko Update of /repository/php3/doc/functions In directory asf:/u2/tmp/cvs-serv14788/doc/functions Modified Files: filesystem.sgml Log Message: Added function lstat() and cleaned up the status functions. There was something inside #if APACHE conditions - I do not understand why, it was not affecting anything. Added tests for file status functions. This may break on some plattforms that do not have symbolic links, so this has to be trimmed down or modified otherwise.. Index: php3/doc/functions/filesystem.sgml diff -c php3/doc/functions/filesystem.sgml:1.25 php3/doc/functions/filesystem.sgml:1.26 *** php3/doc/functions/filesystem.sgml:1.25 Tue Aug 11 00:45:20 1998 --- php3/doc/functions/filesystem.sgml Sun Sep 6 02:50:21 1998 *************** *** 144,150 **** <void> </funcsynopsis> <para> ! Invoking the stat() system call on most systems is quite expensive. Therefore, the result of the last call to any of the status functions (listed below) is stored for use on the next such call using the same filename. If you wish to force a new --- 144,150 ---- <void> </funcsynopsis> <para> ! Invoking the stat() or lstat() system call on most systems is quite expensive. Therefore, the result of the last call to any of the status functions (listed below) is stored for use on the next such call using the same filename. If you wish to force a new *************** *** 154,162 **** --- 154,170 ---- <para> Affected functions include <function>stat</function>, + <function>lstat</function>, <function>file_exists</function>, + <function>is_writeable</function>, + <function>is_readable</function>, + <function>is_executable</function>, + <function>is_file</function>, + <function>is_dir</function>, + <function>is_link</function>, <function>filectime</function>, <function>fileatime</function>, + <function>filemtime</function>, <function>fileinode</function>, <function>filegroup</function>, <function>fileowner</function>, *************** *** 1195,1200 **** --- 1203,1249 ---- </funcsynopsis> <para> Gathers the statistics of the file named by filename. + <para> + Returns an array with the statistics of the file with the + following elements: + <orderedlist> + <listitem><simpara>device</simpara></listitem> + <listitem><simpara>inode</simpara></listitem> + <listitem><simpara>number of links</simpara></listitem> + <listitem><simpara>user id of owner</simpara></listitem> + <listitem><simpara>group id owner</simpara></listitem> + <listitem><simpara>device type if inode device *</simpara></listitem> + <listitem><simpara>size in bytes</simpara></listitem> + <listitem><simpara>time of last access</simpara></listitem> + <listitem><simpara>time of last modification</simpara></listitem> + <listitem><simpara>time of last change</simpara></listitem> + <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem> + <listitem><simpara>number of blocks allocated</simpara></listitem> + </orderedlist> + * - only valid on systems supporting the st_blksize type--other + systems (i.e. Windows) return -1 + + </refsect1> + </refentry> + + + <refentry id="function.lstat"> + <refnamediv> + <refname>lstat</refname> + <refpurpose>give information about a file or symbolic link</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>array <function>lstat</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcsynopsis> + <para> + Gathers the statistics of the file or symbolic link named by filename. + This function is identical to the <function>stat</function> function + except that if the <parameter>filename</parameter> parameter is a + symbolic link, the status of the symbolic link is returned, not + the status of the file pointed to by the symbolic link. <para> Returns an array with the statistics of the file with the following elements: -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net