FCHSIZE( )-Funktion

  • Artikel

Ändert die Größe einer Datei, die mit einer Dateifunktion auf systemnaher Ebene geöffnet wurde.

FCHSIZE(nFileHandle, nNewFileSize)

Rückgabewerte

Numerisch

Parameter

  • nFileHandle
    Gibt das Dateihandle der Datei an, deren Größe geändert werden soll. Das Dateihandle erhalten Sie entweder mit der FOPEN( )-Funktion, wenn Sie die Datei öffnen, oder mit der FCREATE( )-Funktion, wenn Sie die Datei neu erstellen. Wenn eine Datei mit FOPEN( ) geöffnet wird, müssen Sie Schreib- oder Lese-/Schreibzugriff besitzen, um die Größe der Datei ändern zu können.
  • nNewFileSize
    Gibt die neue Größe der Datei in Bytes an. Wenn der Wert für nNewFileSize kleiner als die ursprüngliche Größe der Datei ist, wird die Datei abgeschnitten. Wenn der Wert für nNewFileSize größer als die ursprüngliche Größe der Datei ist, wird die Dateigröße erhöht.

Hinweise

Mit Hilfe der FCHSIZE( )-Funktion können Sie die Größe einer Datei erhöhen oder eine Datei nach einem bestimmten Byte abschneiden.

Wenn der Dateiumfang vergrößert wird, werden der Datei auf dem Laufwerk, auf dem die Datei geöffnet wurde, weitere Sektoren zugewiesen. Da die FCHSIZE( )-Funktion den neuen Speicherplatz für die Datei nicht initialisiert, kann dieser bereits Daten enthalten. Der neue Speicherplatz muss daher unbedingt verwaltet werden.

Die Funktion gibt die endgültige Größe in Bytes zurück. Wenn der Wert -1 zurückgegeben wird, konnte die Größe der Datei nicht geändert werden, z. B. weil das angegebene Dateihandle wegen mangelndem Speicherplatz ungültig ist oder weil die Datei schreibgeschützt ist.

Tipp   Diese Funktion kann auch dazu verwendet werden, um eine Datei auf die Länge 0 zu setzen.

Siehe auch

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