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. | ||