User Tools

Site Tools


fsize

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

  -1   file does not exists, or no read access
> -1   size of file

History:

This function first appeared in EPIC3pre7.

fsize.txt · Last modified: 2007/03/02 02:32 (external edit)