fsize
Differences
This shows you the differences between two versions of the page.
| — |
fsize [2007/03/02 02:32] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | # $EPIC: fsize.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $ | ||
| + | ======Synopsis:====== | ||
| + | $__fsize__(%%<file>%%) | ||
| + | $__fsize__("" %%<file>%%) | ||
| + | |||
| + | ======Technical:====== | ||
| + | * The %%<file>%% argument is a [[what is a word|dword]] which is different fr | ||
| + | om most function arguments. | ||
| + | * In the first case, %%<file>%% is a single extended word (you may surround it with double quotes if it contains spaces). Any further arguments are ignored. | ||
| + | * In the second case, the first argument is an empty string, and the rest of the arguments are taken as a filename literally. Do not backslash or double quote anything in %%<file>%%. | ||
| + | * Tile-expansion is supported in both forms. | ||
| + | * If %%<file>%% exists, the file's size is returned. If %%<file>%% is a symbolic link, the size of the file %%<file>%% points to is returned. | ||
| + | * If %%<file>%% does not exist, or it is a symbolic link and the file it links to does not exist, -1 is returned. | ||
| + | |||
| + | ======Practical:====== | ||
| + | This function returns the size of %%<file>%%. This can be useful for seeing | ||
| + | if a file exists, but has a zero length. | ||
| + | |||
| + | ======Returns:====== | ||
| + | <file> | ||
| + | -1 file does not exists, or no read access | ||
| + | > -1 size of file | ||
| + | </file> | ||
| + | |||
| + | ======History:====== | ||
| + | This function first appeared in EPIC3pre7. | ||
fsize.txt ยท Last modified: 2007/03/02 02:32 (external edit)