System.Rewrite
Contents |
Delphi Information
From System.pas
procedure Rewrite(var F: file); overload; procedure Rewrite(var F: file; RecSize: Integer); overload;
Unit: System
Type: procedure
Visibility: public
Description
Creates a new file and opens it.
In Delphi code, Rewrite creates a new external file with the name assigned to F.
F is a variable of any file type associated with an external file using AssignFile. RecSize is an optional expression that can be specified only if F is an untyped file. If F is an untyped file, RecSize specifies the record size to be used in data transfers. If RecSize is omitted, a default record size of 128 bytes is assumed.
If an external file with the same name already exists, it is deleted and a new empty file is created in its place.
If F is already open, it is first closed and then re-created. The current file position is set to the beginning of the empty file.
If F was assigned an empty name such as AssignFile(F,), then after the call to Rewrite, F refers to the standard output file.
If F is a text file, F becomes write-only.
After calling Rewrite, Eof(F) is always True.
Note: {$I+} handles run-time errors using exceptions. When using {$I-}, use IOResult to check for I/O errors.
See Also
Code Samples