FREAD( )-Funktion

Gibt eine bestimmte Anzahl von Bytes aus einer Datei oder von einem DFÜ-Anschluss zurück, die bzw. der mit einer Dateifunktion auf niedriger Ebene geöffnet wurde.

FREAD(nFileHandle, nBytes)

Rückgabewerte

Zeichen

Parameter

• nFileHandle
  Gibt das Dateihandle der Datei an, aus der bzw. von dem FREAD( ) Daten zurückgibt. Sie erhalten nFileHandle als Rückgabewert der erfolgreichen FOPEN( )- oder FCREATE( )-Anweisung.
• nByte
  Gibt die Anzahl der Bytes an, die von FREAD( ) zurückgegeben werden. FREAD( ) gibt Daten ab der aktuellen Position des Dateizeigers zurück, bis die in nByte angegebene Anzahl von Bytes zurückgegeben oder das Dateiende erreicht ist.

Beispiel

Im folgenden Beispiel wird mit FREAD( ) der Inhalt einer Datei angezeigt. Wenn die Datei leer ist, wird eine Meldung angezeigt.

* TEST.TXT must exist -- you can create this file
* using Notepad.

Local gnFileHandle,nSize,cString
gnFileHandle = FOPEN("test.txt")
* Seek to end of file to determine the number of bytes in the file
nSize =  FSEEK(gnFileHandle, 0, 2)     && Move pointer to EOF
IF nSize <= 0
 * If the file is empty, display an error message
 WAIT WINDOW "This file is empty!" NOWAIT
ELSE
 * If file is not empty, the program stores its contents
 * in memory, then displays the text on the main Visual FoxPro window
 = FSEEK(gnFileHandle, 0, 0)      && Move pointer to BOF
 cString = FREAD(gnFileHandle, nSize)
 ? cString
ENDIF
= FCLOSE(gnFileHandle)         && Close the file

Siehe auch

FCHSIZE( ) | FCLOSE( ) | FCREATE( ) | FEOF( ) | FFLUSH( ) | FGETS( ) | FILETOSTR( ) | FOPEN( ) | FPUTS( ) | FSEEK( ) | FWRITE( )