/*
 * $Id: diskspac.txt 9312 2008-09-05 00:08:34Z vszakats $
 */

/*
 * Las siguientes partes son derechos adquiridos de sus autores individuales.
 * www - http://www.harbour-project.org
 *
 * Copyright 2000 Alejandro de Grate <alex_degarate@hotmail.com>
 * Documentacin en Espaol de: DISKSPACE()
 *
 * Vea doc/license.txt por los trminos de la licencia.
 *
 */

/*  $DOC$
 *  $FUNCNAME$
 *      DISKSPACE()
 *  $CATEGORY$
 *      Bajo Nivel
 *  $ONELINER$
 *      Obtiene la cantidad de espacio disponible en el disco
 *  $SYNTAX$
 *      DISKSPACE( [<nDisco>] [, <nTipo>] ) --> nDiskbytes
 *  $ARGUMENTS$
 *      <nDrive> es el nmero de disco del que esta solicitando informacin
 *               donde 1 = A, 2 = B, etc, Si se especifica cero  ningn
 *               parametro DISKPACE() trabaja sobre la unidad actual de disco
 *               Por defecto es cero.
 *
 *      <nTipo> es el tipo de espacio que est siendo requerido.  Por defecto
 *              es HB_DISK_AVAIL.
 *  $RETURNS$
 *      <nDiskBytes> es el nmero de bytes en la unidad especificada que
 *                   coincide con el tipo requerido.
 *  $DESCRIPTION$
 *      Por defecto esta funcin retorna el nmero de bytes de espacio libre
 *      en el disco actual que esta disponible para el usuario que solicita
 *      la informacin.
 *
 *      Hay 4 tipos de informacin disponible:
 *
 *      HB_FS_AVAIL   La cantidad de espacio disponible para el usuario que
 *                    hace la solicitud. Este valor podra ser menor que
 *                    HB_FS_FREE si las asignaciones de espacio en disco
 *                    (quotas) son soportadas por el sistema operativo al
 *                    tiempo de ejecucin y estas quotas estn asignadas.
 *                    De otro modo el valor ser igual al retornado por
 *                    HB_FS_FREE.
 *
 *      HB_FS_FREE    La cantidad actual de espacio libre en el disco.
 *
 *      HB_FS_USED    El nmero de bytes en uso en el en el disco.
 *
 *      HB_FS_TOTAL   La cantidad total de espacio asignado para el usuario
 *                    si las quotas estan asignadas. De otro modo el tamao
 *                    actual del disco.
 *
 *      Si la informacin es requerida sobre un disco que no esta disponible
 *      un error de ejecucin 2018 ser establecido.
 *  $EXAMPLES$
 *      ? "Ud. tiene diponible: " + STR( DISKSPACE() ) + " bytes " +;
 *        "sobre un total de " + STR( DISKSPACE( 0, HB_FS_TOTAL) )
 *
 *      Note: Ver ..\tests\tstdspac.prg por otros ejemplos.
 *  $STATUS$
 *      S
 *  $COMPLIANCE$
 *      CA-Cl*pper retorna un valor entero cuya utilidad esta limitada a
 *      discos menores de 2 gigabytes. La versin de Harbour retorna un valor
 *      de punto flotante con 0 decimales si el disco es > 2 gigabytes.
 *      <nTipo> es una extensin de Harbour.
 *  $PLATFORMS$
 *      Dos, Win32, OS/2, Unix
 *  $FILES$
 *      El cdigo fuente est en diskspac.c
 *      La librera asociada es rtl
 *      El archivo de cabecera es fileio.ch
 *  $END$
 */


