DISKSPACE()
 Retorna o espaço disponível em um disco especificado
------------------------------------------------------------------------------

 Sintaxe

     DISKSPACE([<nDrive>]) --> nBytes

 Argumento

     <nDrive> é o número do drive ser questionado, onde um é o drive A,
     dois é o B, três é o C, etc.  O padrao é o drive DOS corrente caso
     <nDrive> seja omitido ou especificado como zero.

 Retorno

     DISKSPACE() retorna a quantidade de bytes vazios no drive especificado
     na forma de um valor numérico inteiro.

 Descriçao

     DISKSPACE() é uma funçao de tratamento de ambiente que determina a
     quantidade de bytes disponíveis que restam no drive especificado.  É
     útil quando se estiver utilizando os comandos COPY ou SORT de um drive
     para outro a fim de determinar se há espaço disponível suficiente antes
     de se iniciar a operaçao.  Outra aplicaçao é utilizar DISKSPACE()
     juntamente com RECSIZE() e RECCOUNT() para criar uma rotina que faça
     cópias de segurança de arquivos de banco de dados

     DISKSPACE() nao é afetado pelo comando SET DEFAULT.

 Exemplos

     Este exemplo é uma funçao definida por usuário que demonstra a
     utilizaçao de DISKSPACE() para fazer uma cópia de segurança de um
     arquivo de banco de dados para um outro drive:

     FUNCTION BackUp( cTargetFile, cTargetDrive )
        LOCAL nSpaceNeeded, nTargetDrive
        //
        nSpaceNeeded := INT((RECSIZE() * LASTREC()) + HEADER() + 1)
        nTargetDrive := ASC(UPPER(cTargetDrive)) - 64
        //
        IF DISKSPACE(nTargetDrive) < nSpaceNeeded
           RETURN .F.
        ENDIF
        COPY TO (cTargetDrive + ":" + cTargetFile)
        //
        RETURN .T.

 Arquivos:  Biblioteca EXTEND.LIB, fonte EXAMPLEC.C.
 To download this example - click here.

See Also: LASTREC() LUPDATE() RECSIZE()