f$ZahlZuText (f$FtoS)

Umwandlung einer Zahl in eine Zeichenkette. Als Dezimaltrenner wird der '.' verwendet. Falls kein Format angegeben wird, werden ganzzahlige Werte ohne Nachkommastellen, andere Werte mit 6 Nachkommastellen ausgegeben.

Falls anstelle der Zahl ein Text angegeben wird, wird kein Syntaxfehler gemeldet, sondern der Text zurückgegeben.

Das Format hat folgende Syntax:

%[flags] [width] [.precision] [{h | l | I64 | L}]type

flags:

0 : führende Nullen werden bis zur angegebenen Länge eingetragen.

+ : Es wird immer + bzw. – vor die Zahl geschrieben

width: Mindestanzahl auszugebender Zeichen

precision: Genauigkeit. Bei Gleitkommazahlen entspricht dies der Anzahl Nachkommastellen.

type: Art der Zahl:

c : einzelnes Zeichen

d : Ganzzahl

f : Kommazahl

x : Ausgabe als hexadezimalstring (kleine Buchstaben)

X : Ausgabe als hexadezimalstring (große Buchstaben)

Syntax:	Text = f$ZahlZuText( Zahl[, Formattext] )
	Argument	Typ	Bedeutung
	Zahl	Dezimal	umzuwandelnde Zahl
	Formattext (Optional)	Zeichenkette	Anweisungstext, nach dem die Ausgabe formatiert wird '%<Anzahl Stellen>.<Anzahl Nachkommastellen>lf' Wenn als Stellenanzahl 0 angegeben wird, wird die aktuelle Länge entsprechend der Zahl verwendet. Wird dagegen eine Stellenanzahl angegeben, kann dieser noch eine 0 vorangestellt werden, um einen Text mit führenden Nullen zu erhalten. Standardfall Ganzzahl: '%0.0lf' oder '%d' Standardfall Dezimalzahl: '%0.2lf' (für 2 Nachkommastellen) Umwandlung eines Zeichens: '%c' (siehe unten)
Ergebnis:	Zeichenkette	Zahl als formatierter Text
Beispiel:	Zahl als formatierter Text → Text = '12' Text = f$ZahlZuText( 89.358, '%0.2lf' ) → Text = '89.36' Text = f$ZahlZuText( 26, '%04.0lf' ) → Text = '0026'

Mit dem Formattext '%c' kann ein Sonderzeichen über den ASCII-Zahlencode in einen Text eingegeben werden, z.B. kann auf diese Weise ein Zeilenumbruch erzeugt werden:

Umbruch = f$ZahlZuText(13,'%c')

Die resultierende Zeichenkette besteht dann aus genau einem Zeichen, dem Zeilenumbruch.