<< Click to Display Table of Contents >> Navigation: 3. Script Language > Filesystem-Commands > FIL. - File-Commands > FIL. - File-Commands |
MiniRobotLanguage (MRL)
FIL.Diskfree
Returns available disk space for a specified drive
Intention
The FIL.DiskFree command is used to determine the amount of free disk space available on a specified drive.
•The command does not work with UNC paths. You must specify a drive letter.
•The command works with local drives as well as mapped network drives. However, the amount of free space for network drives may not be accurate if the drive is mapped to a network share that does not report free space accurately.
Syntax
FIL.Diskfree|P1[|P2]
FIL.free|P1[|P2]
Parameter Explanation
•P1 (Required): This is the drive letter for which you want to determine the available disk space. It should be a single character representing the drive letter (e.g., "C").
•P2 (Optional): This is the variable where the command will store the result. If provided, the command will store the amount of free disk space (in bytes) in this variable.
Example
'***********************************
'
'***********************************
Remarks
•The command will return an error if the specified drive does not exist or if it cannot determine the amount of free space for any reason.
•The command returns the amount of free space in bytes. To convert this to a more human-readable format (like MB or GB), you will need to do the conversion yourself.
Limitations:
•The command does not work with UNC paths. You must specify a drive letter.
•The command works with local drives as well as mapped network drives. However, the amount of free space for network drives may not be accurate if the drive is mapped to a network share that does not report free space accurately.
See also:
• IEF. / NEF. - If - exist - File