System.Reset

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Reset(var F: File; [ RecSize: Integer]); overload;
procedure Reset(var F: File; [ RecSize: Integer]); overload;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure public System.pas System System

Beschreibung

Öffnet eine vorhandene Datei.

In Delphi öffnet Reset die in F angegebene externe Datei in dem Modus, der in der globalen Variable FileMode festgelegt ist. Ist keine Datei mit diesem Namen vorhanden oder kann die Datei nicht im aktuellen Dateimodus geöffnet werden, tritt ein Fehler auf. Ist F bereits geöffnet, wird sie zuerst geschlossen und dann erneut geöffnet. Nach dem Öffnen wird der Dateizeiger an den Anfang der Datei gesetzt.

Warnung:  Der Standardwert von FileMode ist 2 (Lesen/Schreiben). Auch wenn die Datei nur gelesen werden soll, verursacht der Standardwert von FileMode (Schreib-/Lesezugriff), dass das Öffnen einer schreibgeschützten Datei fehlschlägt.

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. Wenn RecSize gleich oder kleiner als 0 ist, wird ein 106 E/A-Fehler ausgelöst.

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

Bei einer Textdatei ist F nach dem Öffnen schreibgeschützt.

Nach dem Aufruf von Reset hat Eof(F) den Wert true, wenn die Datei leer ist. Andernfalls ist Eof(F) false.

Wenn ein E/A-Fehler auftritt, schließt Reset die Datei. Sie müssen CloseFile nicht aufrufen.

Anmerkung:  Die Compiler-Option {$I+} behandelt Laufzeitfehler mittels Exceptions. Wird {$I-} verwendet, muss explizit mit IOResult auf E/A-Fehler geprüft werden.

Siehe auch

Codebeispiele