[Overview][Constants][Types][Procedures and functions][Variables][Index] Reference for unit 'Dos' (#rtl)

DiskFree

Get free size on Disk.

Declaration

Source position: dosh.inc line 107

function DiskFree(

  drive: Byte

):Int64;

Description

DiskFree returns the number of free bytes on a disk. The parameter Drive indicates which disk should be checked. This parameter is 1 for floppy a:, 2 for floppy b:, etc. A value of 0 returns the free space on the current drive.

Remark: For Unices: The diskfree and disksize functions need a file on the specified drive, since this is required for the statfs system call. These filenames are set in the initialization of the dos unit, and have been preset to :

There is room for 1-26 drives. You can add a drive with the AddDisk procedure. These settings can be coded in dos.pp, in the initialization part.

Errors

-1 when a failure occurs, or an invalid drive number is given.

See also

DiskSize

  

Get total size of disk.

AddDisk

  

Add disk definition to list if drives (Unix only)

Example

Program Example6;
uses Dos;

{ Program to demonstrate the DiskSize and DiskFree function. }

begin
  WriteLn('This partition size has ',DiskSize(0),' bytes');
  WriteLn('Currently ',DiskFree(0),' bytes are free');
end.
The latest version of this document can be found at lazarus-ccr.sourceforge.net.