Format (FPScript)
Formatiert einen Wert und gibt das Ergebnis als Zeichenkette zurück.
Syntax
Format(Format, Value)
Die Syntax der Format-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
Format |
Der Formatierer, der das Ausgabeformat bestimmt. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Value |
Der zu formatierende Wert. Es sind alle Datenstrukturen erlaubt. Es sind alle Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
Anmerkungen
Das Ergebnis ist immer vom Datentyp Zeichenkette.
Der formatierte Wert wird als Zeichenkette zurückgegeben. Wenn das Argument Value eine Datenreihe oder eine Datenmatrix ist, so erfolgt die Berechnung elementweise und das Ergebnis ist wieder eine Datenreihe bzw. eine Datenmatrix. Bei zusammengesetzten Datenstrukturen wird nur die Y-Komponente verrechnet. Die Datensatzstruktur des Ergebnisses entspricht dann der Struktur der Y-Komponente des Arguments Value.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Format("%.5g", 1.234567) |
Ergibt "1,2346". Formatiert den Fließkommawert als Fließkommazahl mit 5 gültigen Stellen. |
Format("%.5g", DataSeries) |
Formatiert eine Datenreihe als Fließkommazahl mit 5 gültigen Stellen. Das Ergebnis ist wieder eine Datenreihe. |
Format("%p", 135) |
Ergibt "0,75 Pi". Formatiert den Fließkommawert als Winkel im Bogenmaß. |
Format("%.4p", 135) |
Ergibt "3/4 Pi". Formatiert den Fließkommawert als Bruch von Pi im Bogenmaß. |