Formatbezeichner können für Format-Strings, zum Konvertieren einer Zahl in einen String und zur Anzeige nicht darstellbarer Zeichen in Strings verwendet werden.

Funktionen, die einen String ausgeben (z. B. In String formatieren und Array nach Tabellen-String), arbeiten bei der Formatangabe mit den nachfolgend beschriebenen Syntaxelementen. Optionale Elemente sind durch doppelte Klammern ([]) gekennzeichnet.

%[$][-][+][#][^][0][Breite][.Genauigkeit||_Signifikante Stellen][{Einheit}][<Eingeschlossene Informationen>]Konvertierungscode

Die Breite muss größer als null sein und die .Genauigkeit und die _Signifikanten Stellen müssen größer oder gleich null sein.

Bei Funktionen, die mit Strings arbeiten (z. B. In String suchen und Tabellen-String nach Array), werden Formatierungen mit folgenden vereinfachten Syntaxelementen angegeben.

%[Breite]Konvertierungscode

Bei Funktionen wie In String formatieren, In Datei formatieren, In String suchen und In Datei suchen können im Format-String mehrere Formatbezeichner enthalten sein, und zwar jeweils einer für die Ein- und für die Ausgabe der erweiterbaren Funktion.

Syntaxelemente für Formatbezeichner

Die folgende Tabelle enthält die Syntaxelemente für Formatbezeichner. Weitere Informationen finden Sie im Abschnitt Beispiele für Formatbezeichner.

Tabelle 1.
Syntaxelement Beschreibung
% Gibt den Beginn des Formatbezeichners an.
$ (optional) Bei Formatierungsfunktionen legt dieser Bezeichner die Reihenfolge fest, in der die Variablen angezeigt werden sollen. Fügen Sie die Zahl, die die Variablenreihenfolge angibt, direkt vor diesem Bezeichner ein.
- (optional) Wenn Sie mit einer Formatierungsfunktion arbeiten, formatiert dieser Bezeichner den Parameter innerhalb seiner Breite links- statt rechtsbündig.
+ (optional) Wenn Sie mit einer Formatierungsfunktion arbeiten, wird der Zahl mit diesem Bezeichner ein Vorzeichen vorangestellt, auch wenn die Zahl positiv ist.
^ (optional) Wenn Sie mit einer Formatierungsfunktion und dem Konvertierungscode „e“ oder „g“ arbeiten, wird die Zahl mit diesem Bezeichner in technischer Schreibweise angezeigt, das heißt, der Exponent der Zahl ist ein Vielfaches von 3.
# (optional) Wenn Sie mit einer Formatierungsfunktion arbeiten, werden mit diesem Bezeichner die abschließenden Nullen aus den Kommastellen entfernt. Wenn die Zahl keine Dezimalstellen hat, werden die Stellen vor dem Komma entfernt.
0 (optional) Verwenden Sie diesen Bezeichner ohne den Bezeichner „-“, wenn Sie eine Formatierungsfunktion verwenden, um die Stellen vor dem Wert mit Nullen zu füllen, sodass die vorgegebene Mindestanzahl an Stellen eingehalten wird.
Breite (optional) Wenn Sie mit einer Suchfunktion arbeiten, wie zum Beispiel „In String suchen“, dann legt das Element Breite die maximale Anzahl aufeinander folgender Zeichen fest, nach denen gesucht werden soll. In LabVIEW wird bei der Verarbeitung des Parameters nach der maximalen Anzahl der Zeichen gesucht. Bei Formatierungsfunktionen gibt das Element Breite die minimale Zeichenfeldbreite für die Ausgabe an. Dieser Parameter beschreibt nicht die maximale Breite. LabVIEW verwendet immer so viele Zeichen, wie für die Formatierung des Parameters notwendig sind, ohne diesen abzuschneiden. Das Feld wird je nach Ausrichtung links oder rechts vom Parameter mit Leerzeichen ausgefüllt. Wenn der Parameter Breite fehlt oder den Wert 0 hat, ist der Ausgabewert nur so lang, wie es für den konvertierten Eingabeparameter erforderlich ist.
.Genauigkeit oder _Signifikante Stellen (optional) Bei Formatierungsfunktionen wird die Anzahl der angezeigten Stellen durch „.“ oder „_“ bestimmt. Bei „.“ verwendet LabVIEW die nachfolgende Zahl als Maßstab, wie viele Stellen nach dem Dezimalzeichen darzustellen sind. Bei _ verwendet LabVIEW die gleiche Anzahl signifikanter Stellen wie mit der nachfolgenden Zahl angegeben.

.Genauigkeit – Bei Fließkommazahlen legt dieses Element die Anzahl der Stelle rechts neben dem Dezimalzeichen fest. Fehlt der Punkt (.), verwendet LabVIEW exakt sechs Stellen. Ist „.“ gleich „0“, wird in LabVIEW die Anzahl der Kommastellen nicht angegeben. Wenn Sie mit String-Parametern arbeiten, gibt .Genauigkeit die maximale Breite des Suchfelds an. Längere Strings werden vom Programm abgeschnitten.

_Signifikante Stellen – Stellt die Werte auf die von Ihnen festgelegte Stellenanzahl gerundet dar. LabVIEW rundet die Daten nur zu Anzeigezwecken, was sich nicht auf die ursprünglichen Daten auswirkt. .Genauigkeit wirkt sich nur auf die Stellen rechts neben dem Dezimalzeichen aus, und _Signifikante Stellen umfasst alle Stellen ohne Leerzeichen. Beispiel:
  • 3,457 hat 4 signifikante Stellen
  • 0,0012 hat 2 signifikante Stellen
  • 123000 hat 3 signifikante Stellen
Hinweis Genauigkeit und signifikante Stellen können nicht zusammen in einem Formatbezeichner verwendet werden.

NI empfiehlt für Fließkommazahlen mit einfacher Genauigkeit die Verwendung der Werte 1 bis 6 für _Signifikante Stellen. NI empfiehlt für Fließkommazahlen mit doppelter und erweiterter Genauigkeit einen Wert zwischen 1 und 13 für _Signifikante Stellen.
{Einheit} (optional) Überschreibt die ursprüngliche Einheit eines VIs, wenn Sie mit Hilfe einer Funktion eine physikalische Größe umwandeln. Sie müssen eine passende Einheit verwenden. Dieses Syntaxelement gilt nur für die Funktion „In String formatieren“.
<Embedded Time Format> (optional) Enthält einen zeitabhängigen Format-String für die Umwandlungscodes „T“ (absolute Zeit) und „t“ (relative Zeit). Weitere Informationen zu gültigen Format-Strings finden Sie unter Formatcodes für die Datums- und Zeitanzeige. Für relative Zeitangaben gelten nur %W, %D, %H, %M, %S und %u.
Konvertierungscodes Zeichen, die angeben, wie Parameter gesucht oder formatiert werden sollen.
Nutzen Sie folgende Konvertierungscodes für Integer und Festkommawerte:
  • x – Hexadezimaler Integer (zum Beispiel B8).
  • o—Oktaler Integer (zum Beispiel 701).
  • b—Binärer Integer (zum Beispiel 1011).
  • d—Vorzeichenbehafteter dezimaler Integer.
  • u—Vorzeichenloser dezimaler Integer.
Nutzen Sie folgende Konvertierungscodes für Fließ- und Festkommawerte:
  • f—Fließkommazahl in Dezimalschreibweise (zum Beispiel 12,345)
  • e—Fließkommazahl in wissenschaftlicher Darstellung (zum Beispiel 1,234E1)
  • g—Je nach Exponent der Zahl wird f oder e verwendet. f wird dann eingesetzt, wenn der Exponent größer als –4 oder kleiner als die angegebene Genauigkeit ist. „e“ wird verwendet, wenn der Exponent kleiner als -4 oder größer als die angegebene Genauigkeit ist.
  • p – Fließkommazahl in SI-Schreibweise
Nutzen Sie folgende Konvertierungscodes für Strings:
  • s—String (zum Beispiel abc). Beim Suchen nach einem String kann „s“ nur bis zum nächsten nicht darstellbaren Zeichen verglichen werden. Ein Leerzeichen wird als mindestens ein nicht darstellbares Zeichen interpretiert Um einen String zu durchsuchen, der nicht darstellbare Zeichen enthalten kann, verwenden Sie die Konvertierungscodes für die Suche nach bestimmten Zeichen. Geben Sie alle Zeichen, die der String enthalten könnte (einschließlich der Leer- und Steuerzeichen), in Klammern an.
  • [ ] – Zeichensatz. [ ] sucht nach Strings, die nur die Zeichen innerhalb der Klammern enthalten. Bei Buchstabenvergleichen wird die Groß-/Kleinschreibung berücksichtigt. Der [ ]-Konvertierungscode ist nur von Nutzen, wenn Strings untersucht werden. Das Exponentialzeichen (^) wird nur gefunden, wenn es nicht das erste Symbol nach der Klammer ist. Nachfolgend ein Beispiel für die Verwendung der Konvertierungscodes zur Suche nach bestimmten Zeichen:
    • %[aeiou]—Sucht nur nach Strings mit klein geschriebenen Vokalen.
    • %[0-9a-zA-Z ] – Sucht einen String mit Zahlen, Buchstaben oder Leerzeichen. Zur Angabe eines Bereichs werden Bindestriche verwendet.
    • %[^,;]—Sucht nach allen Zeichen bis zum ersten Komma oder Semikolon.
    Um einen Bindestrich zu finden, muss dieser als erstes oder letztes Zeichen in der Aufzählung erscheinen.
Arbeiten Sie bei Zeitangaben mit folgenden Konvertierungscodes:
  • T—Absolute Zeit. Verwenden Sie T in den Anzeigeformateigenschaften von numerischen oder Zeitstempel-Elementen, Anzeigeelementen, Konstanten sowie mit den Funktionen „In String formatieren“, „In Datei formatieren“, „In String suchen“ und „In Datei suchen“. Beispiele für die Verwendung der absoluten Zeitangabe finden Sie in der Tabelle „Beispiele für Formatbezeichner“. T kann nicht mit den Funktionen "Array nach Tabellen-String", "Tabellen-String nach Array", "Wert formatieren" und "Nach Wert durchsuchen" verwendet werden. Zeitstempel dürfen kein anderes Format als das Zeitformat haben.
  • t—Relative Zeit. Verwenden Sie t in den Anzeigeformateigenschaften von numerischen- oder Zeitstempel-Elementen, Anzeigeelementen, Konstanten sowie mit den Funktionen „In String formatieren“, „In Datei formatieren“, „In String suchen“ und „In Datei suchen“. Beispiele für die Verwendung der relativen Zeitangabe finden Sie in der Tabelle „Beispiele für Formatbezeichner“. „t“ kann nicht mit den Funktionen „Array nach Tabellen-String“, „Tabellen-String nach Array“, „Wert formatieren“ und „Nach Wert durchsuchen“ verwendet werden. Zeitstempel dürfen kein anderes Format als das Zeitformat haben.
Formatcodes für andere Ländereinstellungen Zeichen, die bestimmen, ob LabVIEW als Dezimaltrennzeichen einen Punkt oder ein Komma verwendet. Diese Codes beziehen sich lediglich auf das Dezimalzeichen. Sie verursachen keine Ein- oder Ausgabe. Die Darstellung wird bis zum nächsten gefundenen %; beibehalten.
  • %,; – Dezimalkomma.
  • %.; – Dezimalpunkt.
  • %; – Standarddezimalzeichen des Systems. Wenn Sie kein Trennzeichen bestimmen, verwendet LabVIEW das Standarddezimalzeichen des Systems.
Escape-Sequenzen Zeichen, die Hexadezimalwerte, Abstände, Rückschritte und andere Formatierungsoptionen bestimmen.

Beispiele für Formatbezeichner

Die folgende Tabelle enthält die Syntaxelemente für Formatbezeichner.

Typ Argument(e) Format-String Ausgabe-String Kommentare
Automatisch formatieren (%g) 12,00 %#g 12 Mit # werden Nullen am Ende entfernt. Bei g wird je nach zu formatierender Zahl zwischen Exponential- oder Fließkommaschreibweise gewählt.
12000000 %#g 1,2E+7
Dezimal (%d) 12,67 Wertung= %d%% Wertung= 13% Wenn Sie %d festlegen, werden in LabVIEW Integer im Dezimalformat, also zur Basis 10, angezeigt.
  • Bei vorzeichenbehafteten oder vorzeichenlosen Integern mit verschiedenen Bit-Größen zeigt LabVIEW den nicht modifizierten Integer an.
  • LabVIEW rundet Fließkommawerte in vorzeichenbehaftete 64-Bit-Integer. NaN und Werte größer als der maximale Wert eines vorzeichenbehafteten 64-Bit-Integers werden auf den Maximalwert eines vorzeichenbehafteten 64-Bit-Integers aufgerundet, welcher 9223372036854775807 beträgt. Zum Aufzeichnen von Werten größer als der Maximalwert eines vorzeichenbehafteten 64-Bit-Integers müssen Sie die Werte speziell mit Hilfe der Funktion Nach vorzeichenlosen Quad-Integer in vorzeichenlose 64-Bit-Integer umwandeln.
Fließkomma (%f) 12,67 Temp: %5,1f Temp: 12,7 Die 5 im Format-String steht für eine Breite von 5 Zeichen und die 1 für die Anzahl der Kommastellen.
12,67 N %5.3f 12,670 N Einheiten sind nur zulässig, wenn Sie mit der Funktion In String formatieren arbeiten. Nebenstehend sehen Sie Beispiele mit physikalischen Größen. Im zweiten Beispiel wird die Umwandlung von Einheiten gezeigt. Das Fragezeichen zeigt an, wenn die Einheit im angegebenen Format nicht mit der eingegebenen Einheit vereinbar ist.
12,67 N %5,3{mN}f 12670,000 mN
12,67 N %5,3{kg}f 12,670 ?kg
Wissenschaftliche Darstellung (%e) 12,67 %.3e 1,267E+1 Mit einem ^ wird zur technischen Darstellung gewechselt. Der Exponent ist dann immer ein Vielfaches von 3.
12,67 %^.3e 12,670E+0
SI-Schreibweise (%p) 12000000 %.2p 12,00M ,2 zeigt an, dass das Ergebnis mit zwei Kommastellen ausgegeben werden soll. _2 gibt an, dass das Ergebnis zwei signifikante Stellen haben soll. %p fügt die SI-Präfixe hinzu.
12000000 %_2p 12M
Hexadezimal (%x) 12 %02x 0C Das Zeichen A zeigt an, dass der Ausgabe-String links ausgerichtet sein soll. 0 zeigt an, dass der Ergebnis-String mit Nullen aufgefüllt werden soll. Die Nummer gibt die Breite des Ergebnis-Strings an. Mit anderen Worten: Bei –n wird der Ausgabe-String bis zu einer Breite von n mit Leerzeichen aufgefüllt. b steht für die Basis 2, o für die Basis 8 und x für die Basis 16.
Oktal (%o) 12 %06o 000014
Binär (%b) 12 %b 1100
Relative Zeit (%t) 91,80 %.2t 01:31,80 Verstrichene Zeit wird immer in Wochen (%W), Tagen (%D), Stunden (%H), Minuten (%M), Sekunden (%S) und Millisekunden (%u) angegeben. Weitere Informationen zu den Zeitformat-Codes finden Sie unter Formatcodes für die Datums- und Zeitanzeige.
91,8 %<Stunden:%H Minuten:%M Sekunden:%S>t Stunden:00 Minuten:01 Sekunden:31
Absolute Zeit (%T) 00:00:00.000 AM 1/1/2001 (universelle Zeit) %<%.3X %x>T 00:00:00.000 01.01.2001 Mit %T wird die Zeit absolut angegeben. Mit der Angabe in <> wird die Formatierung der Zeit festgelegt. Dieses Format (einschließlich Zeichensetzung) richtet sich nach der Ländereinstellung Ihres Rechners. Die Zeit basiert auf der angegebenen Zeitzone. Weitere Informationen zu den Zeitformat-Codes finden Sie unter Formatcodes für die Datums- und Zeitanzeige.
00:00:00.000 AM 1/1/2001 (universelle Zeit) %<%Y.%m.%d>T 2001.01.01
00:00:00.000 AM 1/1/2001 (universelle Zeit) %^<%.3X %x>T 06:00:00.000 31.12.2000 Zur Anzeige der Zeit in Weltzeit fügen Sie ^ hinzu.
String (%s) Schmidt, Hans Name: %s, %s. Name: Schmidt, Hans. Strings sind nur zulässig, wenn Sie mit der Funktion In String formatieren arbeiten. Im zweiten Beispiel gibt der Format-String an, dass maximal sechs Zeichen vom String Hallo Welt verwendet und die restlichen Zeichen bis 10 mit Leerzeichen aufgefüllt werden sollen.
Hallo Welt String: %10.6s String: Hallo,
Variablenreihenfolge (%$) Schmidt, Hans %2$s %1$s Hans Schmidt In diesem Beispiel ist Schmidt die erste und Hans die zweite Variable. Wenn Sie das Syntaxelement $ im Format-String für eine bestimmte Variable verwenden, werden die nachfolgenden Syntaxelemente, denen $ nicht vorangestellt ist, auf die nächste Variable angewendet. Wenn Sie das Syntaxelement $ für eine Variable verwenden, verwenden Sie $ auch für beliebige andere Variablen in dem String, um die Lesbarkeit zu verbessern.
Prozentzeichen (%%) Keine %% % %% formatiert ein einzelnes %. Dieses Format bietet einen Weg, ein tatsächliches Prozentzeichen in den String aufzunehmen. Es wird dadurch kein Terminal zu den Funktionen In String formatieren oder In String suchen hinzugefügt.