DISKSPACE( )-Funktion
Gibt den auf dem Standardlaufwerk oder -datenträger oder dem angegebenen Laufwerk oder Datenträger (Volume ) verfügbaren Speicherplatz in Bytes an.
DISKSPACE([cVolumeName [, nType]])
Rückgabewerte
Numerisch
Parameter
- cVolumeName
Gibt den Namen für das Laufwerk oder den Datenträger an, für das oder den der verfügbare Speicherplatz zurückgegeben wird. Wird cVolumeName nicht angegeben, wird der verfügbare Speicherplatz für das Standardlaufwerk oder den Standarddatenträger zurückgegeben. - nType
Gibt den Speicherplatztyp an, der entsprechend der folgenden Tabelle abgerufen werden soll:Value Beschreibung 1 Gesamter Speicherplatz auf dem Datenträger. 2 (Standardeinstellung) Gesamter verfügbarer Speicherplatz auf dem Datenträger. 3 Gesamter freier Speicherplatz, der für den Benutzer, der mit dem aufrufenden Thread verknüpft ist, verfügbar ist.
Hinweise
Diese Funktion ist nützlich zur Feststellung, ob der Speicherplatz ausreichend ist zum Sichern von Dateien oder für das Ausführen von Befehlen wie z. B. SORT, die zusätzlichen Speicherplatz für temporäre Dateien benötigen.
Das Standardlaufwerk oder der Standarddatenträger wird mit SET DEFAULT festgelegt.
DISKSPACE( ) gibt den Wert -1 zurück, wenn ein Fehler beim Lesen des Laufwerks oder Datenträgers auftritt. Bei einigen Netzwerken ist der von DISKSPACE( ) zurückgegebene Wert für große Netzlaufwerke möglicherweise nicht sehr genau.
Beispiel
Das folgende Beispiel verwendet DISKSPACE( ) zur Feststellung, ob der verfügbare Speicherplatz für das Durchführen eines Sortiervorgangs ausreicht.
** Check DISKSPACE before sort ** CLOSE DATABASES OPEN DATABASE (HOME(2) + 'Data\testdata') USE customer && Opens Customer table
** Get size of table header ** gnTableHead = HEADER( )
** Calculate size of table ** gnFileSize = gnTableHead + (RECSIZE( ) * RECCOUNT( ) + 1) IF DISKSPACE( ) > (gnFileSize * 3) WAIT WINDOW 'Sufficient diskspace to sort.' ELSE WAIT WINDOW 'Insufficient diskspace. Sort cannot be done.' ENDIF