4.2.1.2 Formatierung für Programme mit Druckausgabe
String = EKA_Formatprt (dZahl, lPrint, P1, P2 bNull, dRZ, lRc [, Fehlernr, Fehlerparameter]);
Die formatierte Zahl wird in den „String“ abgestellt. Eine Fehlermeldung kann im Fehlerfall ausgegeben werden.
Die Eingangs Parameter sind:
-
dZahl: die zu formatierende Zahl (DOUBLE), kann auch ein Ausdruck sein. LONG-Variablen sind auch zulässig.
-
lPrint: LONG-Variable für die Steuerung der Fehlerausgabe abhängig vom Druck - „0“ = Fehlermeldung ausgeben, „1“ = keine Meldung ausgeben. In allgemeinen „gvlPrint“. Kann auch Konstante sein.
-
P1: Dateinummer des zu formatierenden Feldes (LONG) oder Feldformat (String). Kann auch eine Konstante sein.
-
P2: Feldnummer des zu formatierenden Feldes (LONG) oder, wenn P1 = Feldformat ist, dann die Feldlänge (LONG). Kann auch eine Konstante sein.
-
bNull: BOOL-Variable - „TRUE“ = falls dZahl gleich 0 ist, so wird als Ergebnis „SPACE“ in der entsprechenden Länge geliefert, „FALSE“ = auch formatierte 0 wird geliefert. Kann auch Konstante sein.
-
dRZ: der gerundete Wert zu der dZahl.
-
lRc: Fehlercode, die die Zahlenformatierung liefert (0 = ohne Fehler).
-
Fehlernr: Optional ein String mit dem kompletten Schlüssel für die Fehlermeldung, z.B. "F732023“. Falls ein leerer String eingegeben wird "“, wird die Meldung "F000020“ verwendet. Kann auch eine Konstante sein.
-
Fehlerparameter: muss angegeben werden, wenn Fehlernr angegeben ist. Wird in einer Fehlermeldung mit „@“ eingesetzt. Wird ein leerer String eingegeben, so wird der Parameter aus P1 und P2 (nur wenn Dateinummer und Feldnummer angegeben sind) gebildet (DnummmerFnummer, z.B. „D23F24“). Kann auch eine Konstante sein.