FORMAT [(rep)]
parameter
|
Dieses Dokument behandelt folgende Themen:
Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.
Verwandte Statements: AT END OF PAGE | AT TOP OF PAGE | CLOSE PRINTER | DEFINE PRINTER | DISPLAY | EJECT | NEWPAGE | PRINT | SKIP | SUSPEND IDENTICAL SUPPRESS | WRITE | WRITE TITLE | WRITE TRAILER
Gehört zur Funktionsgruppe: Erstellen von Ausgabe-Reports
Das Statement FORMAT dient dazu, Werte für Eingabe- und
Ausgabeparameter festzusetzen.
Die Gültigkeit der mit einem FORMAT-Statement festgesetzten
Werte hat zur Kompilierungszeit Vorrang vor den auf Session-Ebene mit einem
GLOBALS-Kommando, SET GLOBALS-Statement oder vom Natural-Administrator gesetzten Parameterwerten.
Die mit dem FORMAT-Statement festgesetzten Werte können
ihrerseits auf Statement- oder Elementebene (Feldebene) von den mit den
Statements DISPLAY,
INPUT,
PRINT,
WRITE,
WRITE TITLE oder
WRITE TRAILER gesetzten
Parameterwerten überschrieben werden.
Die Einstellungen gelten Sie bis zum Ende des betreffenden Programms,
oder bis sie mit einem weiteren FORMAT-Statement geändert
werden.
Das FORMAT-Statement generiert keinen ausführbaren Code im
Natural-Programm. Seine Ausführung hängt nicht vom logischen Ablauf des
Programms ab. Es wird während der Kompilierung ausgewertet, um die Parameter
für die Kompilierung der betroffenen DISPLAY-,
WRITE-, PRINT- und INPUT-Statements zu
setzen. Das FORMAT-Statement wirkt sich auf alle nachfolgenden
DISPLAY-, WRITE-, PRINT- und
INPUT-Statements aus.
| (rep) |
Report-Spezifikation:
Mit der Notation
Es kann ein Wert von 0 bis 31 oder ein logischer Name, der mit einem DEFINE PRINTER-Statement zugewiesen wurde, angegeben werden. Falls nichts anderes angegeben wird, bezieht sich das
Informationen zum Steuern des Formats eines mit Natural erzeugten Ausgabe-Reports siehe Steuerung der Ausgabe von Daten im Leitfaden zur Programmierung. |
|---|---|
| parameter |
Parameter:
Die Parameter können in beliebiger Reihenfolge angegeben werden und müssen jeweils durch ein oder mehr Leerzeichen voneinander getrennt werden. Der Eintrag für einen Parameter darf nicht über das Ende einer Sourcecode-Zeile hinausgehen. Die hier gültigen feldsensitiven Parameter-Einstellungen kommen nur
für Variablenfelder in Betracht, die in einem Beispiel: DEFINE DATA LOCAL 1 VARI (A4) INIT <'1234'> /* Output END-DEFINE /* Produced FORMAT AD=U /* --------- WRITE 'Text' VARI /* Text 1234 WRITE 'Text' (AD=U) VARI /* Text 1234 END Siehe auch Parameter weiter unten. |
Die Beschreibungen der Parameter, die Sie beim
FORMAT-Statement verwenden können, finden Sie in der
Parameter-Referenz.
| Parameter | Beschreibung |
|---|---|
| AD | Attribute Definition |
| AL | Alphanumeric Length for Output |
| BX | Box Definition |
| CD | Color Definition |
| DF | Date Format |
| DL | Display Length for Output |
| EM | Edit Mask |
| ES | Empty Line Suppression |
| FC | Filler Character |
| FL | Floating Point Mantissa Length |
| GC | Filler Character for Group Heading |
| HC | Header Centering |
| HW | Heading Width |
| IC | Insertion Character |
| IP | Input Prompting Text |
| IS | Identical Suppress |
| KD | Key Definition |
| LC | Leading Characters |
| LS | Line Size |
| MC | Multiple-Value Field Count (Kann nur im Reporting Mode verwendet werden.) |
| MP | Maximum Number of Pages of a Report |
| MS | Manual Skip |
| NL | Numeric Length for Output |
| PC | Periodic Group Count (Kann nur im Reporting Mode verwendet werden.) |
| PM | Print Mode |
| PS | Page Size |
| SF | Spacing Factor |
| SG | Sign Position |
| TC | Trailing Characters |
| UC | Underlining Character |
| ZP | Zero Printing |
Siehe auch Unterstreichungszeichen für Überschriften − der UC-Parameter im Leitfaden zur Programmierung.
** Example 'FMTEX1': FORMAT
************************************************************************
DEFINE DATA LOCAL
1 EMPLOY-VIEW VIEW OF EMPLOYEES
2 NAME
2 CITY
2 POST-CODE
2 COUNTRY
END-DEFINE
*
FORMAT AL=7 /* Alpha-numeric field output length
FC=+ /* Filler character for field header
GC=* /* Filler character for group header
HC=L /* Header left justified
IC=<< /* Insert characters
IS=ON /* Identical suppress on
TC=>> /* Trailing character
UC== /* Underline character
ZP=OFF /* Zero print off
*
LIMIT 5
READ EMPLOY-VIEW BY NAME
DISPLAY NOTITLE
NAME 3X CITY 3X POST-CODE 3X COUNTRY
END-READ
*
END
Ausgabe des Programms FMTEX1:
NAME+++++++ CITY+++++++ POSTAL+++++ COUNTRY++++
ADDRESS++++
=========== =========== =========== ===========
<<ABELLAN>> <<MADRID >> <<28014 >> <<E >>
<<ACHIESO>> <<DERBY >> <<DE3 4TR>> <<UK >>
<<ADAM >> <<JOIGNY >> <<89300 >> <<F >>
<<ADKINSO>> <<BROOKLY>> <<11201 >> <<USA>>
<<BEVERLE>> <<90211 >>