System.Rewrite

Delphi-Informationen

von System.pas

	procedure Rewrite(var F: file); overload;
 
	procedure Rewrite(var F: file; RecSize: Integer); overload;

Unit: System

Typ: Prozedur

Sichtbarkeit: public

Beschreibung

Erstellt eine neue Datei und öffnet sie anschließend.

In Delphi erstellt Rewrite eine neue externe Datei mit dem in F zugewiesenen Namen.

F ist eine Variable eines beliebigen Dateityps, die zuvor mit AssignFile einer externen Datei zugewiesen wurde. RecSize ist ein optionaler Ausdruck, der nur bei untypisierten Dateien angegeben werden kann. Wenn F eine untypisierte Datei ist, gibt RecSize die Blockgröße für Datenübertragungen an. Wenn Sie RecSize nicht angeben, wird der Standardwert 128 verwendet.

Ist schon eine gleichnamige externe Datei vorhanden, wird sie gelöscht und an ihrer Stelle die neue Datei angelegt.

Ist F bereits geöffnet, wird sie zuerst geschlossen und dann erneut erstellt. Nach dem Erstellen wird der Dateizeiger an den Anfang der leeren Datei gesetzt.

Wird F ein leerer String zugewiesen (z.B. AssignFile(F, )), zeigt die Variable nach dem Aufruf von Rewrite auf die Standardausgabedatei.

Bei einer Textdatei kann in F nur geschrieben werden.

Nach dem Aufruf von Rewrite hat Eof(F) immer den Wert true.

Anmerkung: Die Compiler-Option {$I+} behandelt Laufzeitfehler mittels Exceptions. Wenn Sie {$I-} verwenden, müssen Sie mit IOResult explizit auf E/A-Fehler prüfen.