FGETS( )-Funktion

Gibt eine bestimmte Anzahl von Bytes aus einer mit einer Dateifunktion auf systemnaher Ebene geöffneten Datei bzw. einem DFÜ-Anschluss zurück, bis die Funktion auf einen Wagenrücklauf (CR) trifft.

FGETS(nFileHandle [, nBytes])

Rückgabewerte

Zeichen

Parameter

• nFileHandle
  Gibt das Dateihandle der Datei oder des DFÜ-Anschlusses an, aus der bzw. von dem FGETS( ) Daten zurückgibt.

• nByte
  Gibt die Anzahl der von FGETS( ) gelieferten Bytes an. FGETS( ) gibt nBytes zurück, es sei denn, die Funktion trifft vorher auf einen Wagenrücklauf (CR). FGETS( ) liefert die Daten zwischen der Position des Dateizeigers und dem Wagenrücklauf, sofern sich dieser innerhalb des Bereichs von nByte hinter dem Dateizeiger befindet.

  FGETS( ) gibt maximal 8192 Bytes zurück. Wird nByte nicht angeben, gibt FGETS( ) standardmäßig 254 Bytes zurück.

Hinweise

Sie können eine Datei zeilenweise lesen, indem Sie die FGETS( )-Funktion wiederholt aufrufen.

FGETS( ) gibt eine bestimmte Anzahl von Bytes als Zeichenfolge zurück. Die Funktion liefert die Zeichen hinter dem aktuellen Dateizeiger bis zu einem gegebenenfalls vorhandenen Wagenrücklauf. Der Dateizeiger wird danach auf das Byte gesetzt, das unmittelbar auf den Wagenrücklauf folgt. Der Wagenrücklauf wird nicht als Teil der Zeichenfolge ausgegeben; Zeilenvorschübe werden ignoriert.

Beispiel

** TEST.TXT must exist ** STORE FOPEN('test.txt') TO gnFileHandle && Open the file STORE FSEEK(gnFileHandle, 0, 2) TO gnEnd && Move pointer to EOF STORE FSEEK(gnFileHandle, 0) TO gnTop && Move pointer to BOF IF gnEnd <= 0 && Is file empty? WAIT WINDOW 'This file is empty!' NOWAIT ELSE && If not gcString = FGETS(gnFileHandle, gnEnd) && Store contents ? gcString ENDIF = FCLOSE(gnFileHandle) && Close the file

Siehe auch

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