System.Write
Delphi
procedure Write([var F: File]; P1; [ ..., PN]); overload; procedure Write([var F: File]; P1; [ ..., PN]); overload;
Inhaltsverzeichnis |
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| procedure | public | System.pas | System | System |
Beschreibung
Schreibt in eine typisierte oder eine Textdatei.
Die hier gezeigte Syntax für die Prozedur Write ist ein Beispiel, das illustriert, dass Write eine variable Anzahl von Argumenten übernehmen kann.
Prozedur Write für typisierte Dateien:
Im Delphi-Quelltext schreibt Write eine Datei in eine Dateikomponente. F ist eine Dateivariable, und jedes V ist eine Variable desselben Typs wie der Komponententyp von F. Für jede geschriebene Variable wird die aktuelle Dateiposition auf die nächste Komponente vorgesetzt. Wenn die aktuelle Dateiposition das Dateiende ist (d.h. wenn Eof(F) true ist), wird die Datei erweitert.
Prozedur Write für Textdateien:
Im Delphi-Quelltext schreibt Write einen oder mehrere Werte in eine Textdatei. F ist eine Textdateivariable. Fehlt der Parameter F, wird die Standard-Dateivariable Output verwendet. Jedes P ist ein Schreibparameter. Jeder Schreibparameter enthält einen Ausgabeausdruck, dessen Wert in die Datei geschrieben werden soll. Ein Schreibparameter kann auch die Angabe der Feldbreite und der Anzahl von Dezimalstellen enthalten. Jeder Ausgabeausdruck muss ein Char-Typ, ein Integer-Typ (Byte, Shortint, Word, Longint, Cardinal), ein Gleitkommatyp (Single, Real, Double, Extended, Currency), ein String-Typ (PChar, AnsiString, ShortString), ein gepackter String oder ein Boolean-Typ (Boolean, Bool) sein.
Ein Schreibparameter hat die folgende Form:
AusgabeAusdr [: MinBreite [: DezStellen ] ]
AusgabeAusdr ist ein Ausgabeausdruck. MinBreite und DezStellen sind Integer-Ausdrücke.
MinBreite gibt die minimale Feldbreite an, die größer als 0 sein muss. Genau MinBreite Zeichen werden geschrieben (mit führenden Leerzeichen, falls erforderlich) es sei denn, AusgabeAusdr hat einen Wert, der in mehr als MinBreite Zeichen dargestellt werden muss. In diesem Fall werden die für AusgabeAusdr erforderlichen Zeichen geschrieben. Ebenso wird, wenn MinBreite weggelassen wird, die für die Darstellung des Wertes von AusgabeAusdr erforderliche Zeichenanzahl geschrieben.
DezStellen legt die Anzahl der Dezimalstellen in einer Festkomma-Darstellung von einem der Real-Typen fest. DezStellen kann nur angegeben werden, wenn AusgabeAusdr ein Real-Typ ist, und MinBreite ebenfalls angegeben ist. Wenn MinBreite angegeben ist, muss es größer oder gleich 0 sein.
Write mit einem Zeichentypwert: Wenn MinBreite weggelassen wird, wird der Zeichenwert von AusgabeAusdr in die Datei geschrieben. Ansonsten werden MinBreite - 1 Leerzeichen gefolgt von dem Zeichenwert von AusgabeAusdr geschrieben.
Write mit einem der Integer-Typwerte: Wenn MinBreite weggelassen wird, wird die dezimale Repräsentation von AusgabeAusdr ohne führende Leerzeichen in die Datei geschrieben. Wenn MinBreite angegeben ist, und dieser Wert größer als die Länge des Dezimalstrings ist, werden so viele Leerzeichen vor dem Dezimalstring eingefügt bis das Feld die Breite MinBreite hat.
Write mit einem der Real-Typwerte: Wenn AusgabeAusdr einen der Real-Typwerte hat, wird die dezimale Repräsentation davon in die Datei geschrieben. Das Format der Repräsentation hängt vom Vorhandensein von DezStellen ab. Wenn DezStellen weggelassen wird (oder wenn es vorhanden ist, aber einen negativen Wert hat), wird ein Gleitkomma-Dezimalstring geschrieben. Wenn MinBreite auch weggelassen wird, wird eine Standard-MinBreite von 17 angenommen. Wenn MinBreite kleiner als 8 ist, wird 8 angenommen. Das Format des Gleitkommastrings lautet:
[ | - ] <Ziffer> . <Dezimalstellen> E [ + | - ] <Exponent>
Die folgende Tabelle enthält die Komponenten des Ausgabestrings.
| Komponente | Bedeutung |
|---|---|
|
[ | — ] |
" “ oder “-”l, entsprechend dem Vorzeichen von AusgabeAusdr |
|
<Ziffer> |
Einzelne Ziffer, “0” nur wenn AusgabeAusdr 0 ist |
|
<Dezimalstellen> |
Ziffernstring mit MinBreite-7 (aber höchstens 10) Ziffern |
|
E |
Zeichen [E] als Großbuchstabe |
|
[ + | — ] |
Entsprechend dem Vorzeichen des Exponenten |
|
<Exponent> |
Zweiziffriger Dezimalexponent |
Wenn DezStellen vorhanden ist, wird ein Festkomma-Dezimalstring geschrieben. Wenn DezStellen größer als 11 ist, wird 11 angenommen. Das Format des Festkommastrings lautet:
[<Leerzeichen>] [ - ] <Ziffern> [.<Dezimalstellen>]
Die folgende Tabelle enthält die Komponenten des Festkommastrings.
| Komponente | Bedeutung |
|---|---|
|
<Leerzeichen> |
Leerzeichen bis MinBreite erreicht ist |
|
[-] |
Wenn AusgabeAusdr negativ ist |
|
<Ziffern> |
Mindestens eine Ziffer, aber keine führenden Nullen |
|
[.<Dezimalstellen>] |
Dezimalstellen, wenn DezStellen > 0 |
Write mit einem der String-Typwerte: Wenn MinBreite weggelassen wird, wird der Stringwert von AusgabeAusdr ohne führende Leerzeichen in die Datei geschrieben. Wenn MinBreite angegeben ist, und dieser Wert größer als die Länge des AusgabeAusdr ist, werden so viele Leerzeichen vor dem Dezimalstring eingefügt bis das Feld die Breite MinBreite hat.
Write mit einem gepackten String-Typwert: Wenn AusgabeAusdr ein gepackter Stringtyp ist, wird ein String geschrieben, dessen Länge der Anzahl der Elemente in dem gepackten Stringtyp entspricht.
Write mit einem der Boolean-Typwerte: Wenn AusgabeAusdr ein Boolean-Typ ist, wird - abhängig vom Wert von AusgabeAusdr - true oder false geschrieben.
Anmerkung: Für die Verwendung von Write muss die Datei für die Ausgabe geöffnet sein.
Siehe auch
Codebeispiele