System.Append

Übergeordnet: System

Delphi

function Append(var F: Text): Integer;

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

Eigenschaften

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

Beschreibung

Bereitet eine vorhandene Datei auf das Hinzufügen von Text an deren Ende vor.

Mit Append stellen Sie sicher, dass eine Datei im Schreibmodus geöffnet und der Dateizeiger an das Ende der Datei gesetzt wird. F ist eine Textdateivariable, die mit AssignFile einer externen Datei zugeordnet werden muss. Ist die Datei mit dem angegebenen Namen nicht vorhanden, tritt ein Fehler auf. Wenn F bereits geöffnet ist, wird sie geschlossen und anschließend erneut geöffnet. Die aktuelle Dateiposition wird an das Dateiende gesetzt.

System.Append ist eine Standardprozedur, die entweder 0 oder den entsprechenden E/A-Fehlercode zurückgibt. Folgende Fehler sind möglich:

Ein Laufzeitfehler (oder eine Exception, wenn SysUtils in der uses-Klausel angegeben ist), wenn die E/A-Prüfung aktiviert ist ({$I+})
Ein E/A-Fehler (wie für die Funktion System.IOResult), wenn die E/A-Prüfung deaktiviert ist ({$I-})

Hinweis: Wenn im letzten 128-Byte-Block der Datei das Zeichen Strg+Z (ASCII 26) vorhanden ist, wird die aktuelle Dateiposition so gesetzt, dass das nächste zu der Datei hinzugefügte Zeichen das erste Strg+Z des Blocks überschreibt. Auf diese Weise kann Text an eine Datei angehängt werden, die mit Strg+Z endet.

Wurde F kein Name zugewiesen, verweist F nach dem Aufruf von Append auf die Standardausgabe.