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

# DiskFree

Return the amount of free diskspace

## Declaration

Source position: diskh.inc line 16

`function DiskFree(`
`drive: Byte`
`):Int64;`

## Description

DiskFree returns the free space (in bytes) on disk Drive. Drive is the number of the disk drive:

0
  for the current drive.
1
  for the first floppy drive.
2
  for the second floppy drive.
3
  for the first hard-disk partition.
4-26
  for all other drives and partitions.

Remark: | Under Linux, and Unix in general, the concept of disk is different than the dos one, since the file system is seen as one big directory tree. For this reason, the DiskFree and DiskSize functions must be mimicked using filenames that reside on the partitions. For more information, see AddDisk.

## Errors

On error, -1 is returned.

## See also

DiskSize |  | Return the total amount of diskspace.
AddDisk |  | Add a disk to the list of known disks (Unix only)

## Example

    Program Example27;

    { This program demonstrates the DiskFree function }

    Uses sysutils;

    Begin
      Write ('Size of current disk       : ',DiskSize(0));
      Writeln (' (= ',DiskSize(0) div 1024,'k)');
      Write ('Free space of current disk : ',Diskfree(0));
      Writeln (' (= ',Diskfree(0) div 1024,'k)');
    End.