System.Append
Delphi
function Append(var F: Text): Integer;
Inhaltsverzeichnis
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 ersteStrg+Z
des Blocks überschreibt. Auf diese Weise kann Text an eine Datei angehängt werden, die mitStrg+Z
endet.
Wurde F kein Name zugewiesen, verweist F nach dem Aufruf von Append auf die Standardausgabe.