Please enable JavaScript to view this site.

A-Shell Consolidated Reference

Updated December 2015; see History

xcall SIZE, fspec, count {,flags}

SIZE returns the size of the specified file in bytes.

Parameters

fspec  (String)  [in]

is specification of the file (in AMOS or native format).

count  (Signed Num)  [out]

returns the number of bytes. If the file does not exist, -1 is returned. A return value of 0 indicates that the file exists but contains no data.

flags  (Num)  [in]

specifies what to return in the count parameter:

Value

Data Returned

0 (default)

Number of bytes in file

1

Number of lines in (text) file

2

Number of non-blank lines in (text) file

 

History

2015 December, A-Shell 6.3.1501:  Add flags. Prior to this update, the routine only returned the number of bytes in the file, as if flags=0.

2015 January, A-Shell 6.1.1400:  Routine now supports files larger than 2GB when the returned parameter is any F type. Previously, it only avoided the 2GB limit for F,6.