Site Tools


fsize
no way to compare when less than two revisions

Differences

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


fsize [2007/03/02 02:32] (current) – created - external edit 127.0.0.1
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 by 127.0.0.1