stat
Gives information about a file
&reftitle.description;
arraystat
stringfilename
Gathers the statistics of the file named by
filename. If filename is a
symbolic link, statistics are from the file itself, not the symlink.
lstat is identical to stat
except it would instead be based off the symlinks status.
&reftitle.parameters;
filename
Path to the file.
&reftitle.returnvalues;
<function>stat</function> and <function>fstat</function> result
format
Numeric
Associative
Description
0
dev
device number
1
ino
inode number *
2
mode
inode protection mode
3
nlink
number of links
4
uid
userid of owner *
5
gid
groupid of owner *
6
rdev
device type, if inode device
7
size
size in bytes
8
atime
time of last access (Unix timestamp)
9
mtime
time of last modification (Unix timestamp)
10
ctime
time of last inode change (Unix timestamp)
11
blksize
blocksize of filesystem IO **
12
blocks
number of 512-byte blocks allocated **
* On Windows this will always be 0.
** Only valid on systems supporting the st_blksize type - other
systems (e.g. Windows) return -1.
In case of error, stat returns &false;.
&fs.file.32bit;
&reftitle.errors;
Upon failure, an E_WARNING is emitted.
&reftitle.examples;
<function>stat</function> example
]]>
Using <function>stat</function> information together with <function>touch</function>
]]>
&reftitle.notes;
¬e.filesystem-time-res;
¬e.clearstatcache;
&tip.fopen-wrapper.stat;
&reftitle.seealso;
lstat
fstat
filemtime
filegroup