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