Formatierte Ausgabe einer Ziffer auf dem Display

Für die Ausgabe von Ziffern auf dem Display existiert in iCon-L kein spezieller Funktionsbaustein. Eine Ziffer wird immer über den Baustein HMI Text zur Anzeige gebracht. Um dies zu realisieren, muss der Ziffernwert entsprechend konvertiert werden. Hierzu kann der Konverter-Baustein aus der allgemeinen Adapter-Bibliothek genutzt werden oder aber der Konverter-Baustein aus der Bibliothek Dynamische Texte.

Über den Funktionsbausteine Konverter aus der Bibliothek Dynamische Texte können Zahlenwerte in einen definierten Format ausgeben werden. Zugleich können Sie die Ausgabe mit zusätzlichen Texten erweitern.

Beispiel

Floatwert mit einer Präzision von 2 Nachkommastellen, einer vorangestellte Bezeichnung und einer angehängten Einheit.

"P5 : %.2f ppm"

Bedeutung

P5 ist die vorangestellte Bezeichnung des Wertes (optional)
% mit diesem Zeichen beginnt die formatierte Ausgabe
.2 definiert, dass 2 Nachkommastellen gebildet werden sollen (optional)
f legt fest, dass der konvertierte Wert als Floatwert in dezimaler Darstellung genutzt werden soll
ppm ist der der nachgestellte Text (optional)

Formatstring

%[flags][width][.precision][length]specifier

Spezifikationssymbol [specifier] Ausgabe Beispiel
c Zeichen a
d oder i Dezimale Ganzzahl mit Vorzeichen 392
e Exponentialschreibweise (Mantisse/Exponent) mit Zeichen e 3.9265e+2
E Exponentialschreibweise (Mantisse/Exponent) mit Zeichen E 3.9265E+2
f Dezimale Fließkommazahl 392.65
g Abkürzung für %e oder %f 392.65
G Abkürzung für %E oder %f 392.65
o Oktalzahl mit Vorzeichen 610
s Zeichenkette sample
u Dezimale Ganzzahl ohne Vorzeichen 7235
x Hexadezimale Ganzzahl ohne Vorzeichen 7fa
X Hexadezimale Ganzzahl ohne Vorzeichen (Großbuchstaben) 7FA
% Durch ein %-Zeichen, das einem %-Zeichen nachgestellt wird, wird ein %-Zeichen an das Zeichen anhängen.  
Kennzeichnung [flags] Beschreibung
'-' Linksbündig im angegebenen Feld; Rechtsbündig in der Standardeinstellung (siehe Kennzeichnung Breite).
'+' Ein Plus- oder Minuszeichen wird für das Ergebnis erzwungen. Die Standardeinstellung legt nur ein Minuszeichen bei negativen Zahlenwerten fest.
(space) Wenn kein Zeichen geschrieben werden soll wird ein Leerzeichen vor den Wert gesetzt.
'#' Zusammen mit o, x oder X-Kennzeichnung wird dem Wert 0, 0x oder X vorangestellt, wenn die Werte von Null abweichen.
Zusammen mit e, E und f wird ein Dezimalzeichen im Ergebnis erzwungen, auch wenn keine Ziffern mehr folgen würden. In der Standardeinstellung wird kein Dezimalzeichen ausgegeben, wenn keine Ziffern mehr folgen. Zusammen mit g oder G werden die Ergebnisse angezeigt wie mit e oder E, nur dass nachfolgende Nullen nicht entfernt werden.
0 Füllt die Zahl links mit Nullen (0) anstatt mit Leerzeichen aus bei denen die Auffüllung festgelegt ist (siehe Unterkennzeichnung Breite).
Breite [width] Beschreibung
(Zahl) Minimale Anzahl an angezeigten Zeichen. Sollte der angezeigte Wert kürzer als diese Zahl sein, wird der restliche Platz mit Leerzeichen ausgefüllt. Der Wert wird nicht verkürzt, auch nicht wenn das Ergebnis größer ist.
'*' Die Breite ist nicht im Formatstring festgelegt, sondern als zusätzliche Ganzzahl, die dem zu formatierenden Argumentwert vorangestellt wird.
Präzision [precision] Beschreibung
.Zahl Für Ganzzahlen (d, i, o, u, x, X): Die Präzision bestimmt die minimale Anzahl der zu schreibenden Ziffern. Ist der zu schreibende Wert kürzer als diese Ziffer, wird das Ergebnis mit voranstehenden Nullen vervollständigt. Der Wert wird nicht verkürzt, auch wenn das Ergebnis länger ist. Eine Präzision von 0 bedeutet, dass keine Ziffer für den Wert 0 ausgegeben wird.
Für e, E und f-Spezifikationen: Das ist die Anzahl an Ziffern, die nach dem Dezimalzeichen angezeigt werden soll.
Für g und G-Spezifikationen: Dies ist die maximale Anzahl der bedeutenden Ziffern, die angezeigt werden sollen.
Für s: Dies ist die maximale Anzahl von Ziffern, die angezeigt werden soll. Standardmäßig werden alle Buchstaben bis zum Leerzeichen angezeigt.
Für den c-Typ: Keine Auswirkung. Wenn nicht weiter präzisiert wurde, ist 1 Standard. Wenn die Zeitspanne ohne spezifischen Wert zur Präzision festgelegt wurde, wird 0 ausgegeben.
.* Die Präzision wird nicht im Formatstring festgelegt, sondern als zusätzliche Ganzzahl, die dem zu formatierenden Argumentwert vorangestellt wird.