113 lines
3.7 KiB
Plaintext
113 lines
3.7 KiB
Plaintext
/*
|
|
* $Id$
|
|
*/
|
|
|
|
/*
|
|
* The following are Copyright of the individual authors.
|
|
* www - http://www.harbour-project.org
|
|
*
|
|
* Copyright 2000 Paul Tucker <ptucker@sympatico.ca>
|
|
* Documentation for: DISKSPACE() and related functions
|
|
*
|
|
* See doc/license.txt for licensing terms.
|
|
*
|
|
*/
|
|
|
|
/* $DOC$
|
|
* $FUNCNAME$
|
|
* DISKSPACE()
|
|
* $CATEGORY$
|
|
* Low Level
|
|
* $ONELINER$
|
|
* Get the amount of space available on a disk
|
|
* $SYNTAX$
|
|
* DISKSPACE( [<nDrive>] ) --> nDiskbytes
|
|
* $ARGUMENTS$
|
|
* <nDrive> The number of the drive you are requesting info on where 1 = A,
|
|
* 2 = B, etc. For 0 or no parameter, DiskSpace will operate on the current
|
|
* drive. The default is 0
|
|
* $RETURNS$
|
|
* <nDiskBytes> The number of bytes on the requested disk that match the
|
|
* requested type.
|
|
* $DESCRIPTION$
|
|
* By default, this function will return the number of bytes of
|
|
* free space on the current drive that is available to the user
|
|
* requesting the information.
|
|
*
|
|
* If information is requested on a disk that is not available, a runtime
|
|
* error 2018 will be raised.
|
|
* $EXAMPLES$
|
|
* ? "You can use : " +Str( DiskSpace() ) + " bytes " +;
|
|
* Note: See tests\tstdspac.prg for another example
|
|
* $STATUS$
|
|
* R
|
|
* $COMPLIANCE$
|
|
* This function is Ca-Clipper compliant
|
|
* $PLATFORMS$
|
|
* Dos,Win32,OS/2
|
|
* $FILES$
|
|
* Library is rtl
|
|
* Header is fileio.ch
|
|
* $END$
|
|
*/
|
|
|
|
/* $DOC$
|
|
* $FUNCNAME$
|
|
* HB_DISKSPACE()
|
|
* $CATEGORY$
|
|
* Low Level
|
|
* $ONELINER$
|
|
* Get the amount of space available on a disk
|
|
* $SYNTAX$
|
|
* HB_DISKSPACE( [<cDrive>] [, <nType>] ) --> nDiskbytes
|
|
* $ARGUMENTS$
|
|
* <cDrive> The drive letter you are requesting info on. The default
|
|
* is A:
|
|
|
|
* <nType> The type of space being requested.The default is HB_DISK_AVAIL.
|
|
* $RETURNS$
|
|
* <nDiskBytes> The number of bytes on the requested disk that match the
|
|
* requested type.
|
|
* $DESCRIPTION$
|
|
* By default, this function will return the number of bytes of
|
|
* free space on the current drive that is available to the user
|
|
* requesting the information.
|
|
*
|
|
* There are 4 types of information available:
|
|
*
|
|
* HB_FS_AVAIL The amount of space available to the user making the
|
|
* request. This value could be less than HB_FS_FREE if
|
|
* disk quotas are supported by the O/S in use at runtime,
|
|
* and disk quotas are in effect. Otherwise, the value
|
|
* will be equal to that returned for HB_FS_FREE.
|
|
|
|
* HB_FS_FREE The actual amount of free diskspace on the drive.
|
|
|
|
* HB_FS_USED The number of bytes in use on the disk.
|
|
|
|
* HB_FS_TOTAL The total amount of space allocated for the user if
|
|
* disk quotas are in effect, otherwise, the actual size
|
|
* of the drive.
|
|
*
|
|
* If information is requested on a disk that is not available, a runtime
|
|
* error 2018 will be raised.
|
|
* $EXAMPLES$
|
|
* ? "You can use : " +Str( HB_DiskSpace() ) + " bytes " +;
|
|
* "Out of a total of " + Str( HB_DiskSpace('C:',HB_FS_TOTAL) )
|
|
*
|
|
* Note: See tests\tstdspac.prg for another example
|
|
* $STATUS$
|
|
* R
|
|
* $COMPLIANCE$
|
|
* CA-Clipper will return an integer value which limits it's usefulness to
|
|
* drives less than 2 gigabytes. The Harbour version will return a
|
|
* floating point value with 0 decimals if the disk is > 2 gigabytes.
|
|
* <nType> is a Harbour extension.
|
|
* $PLATFORMS$
|
|
* Dos,Win32,OS/2,Unix
|
|
* $FILES$
|
|
* Library is rtl
|
|
* Header is fileio.ch
|
|
* $END$
|
|
*/
|