User Tools

Site Tools


fsize

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

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)