DISKSPACE( ) Function

Example   See Also

Returns the number of bytes available on the default or specified disk drive or volume.

Syntax

DISKSPACE([cVolumeName])

Returns

Numeric

Arguments

cVolumeName

Specifies the name of the disk drive or volume for which the available space is returned. If cVolumeName is omitted, the available space is returned for the default disk drive or volume.

Remarks

This function is useful for determining whether sufficient space is available to back up files or to execute commands such as SORT that require additional disk space for temporary work files.

The default disk drive or volume is specified with SET DEFAULT.

DISKSPACE( ) returns –1 if there is an error reading the disk drive or volume. On some networks, the value returned by DISKSPACE( ) may not be accurate for large network drives.