Fstr$

Aufgabe:

Formatiert eine Zahl mit Hilfe der Format-Zeichenkette.

Diese besteht aus folgenden Zeichen ('wenn negativ' bezieht sich auf den zu formatierenden Wert):

*

Ziffer oder '*'-Präfix

$

Lokales Währungszeichen

-

Ziffer oder Vorzeichen, wenn negativ

+

Ziffer oder Vorzeichen

(

Ziffer oder '('-Präfix wenn negativ

)

')'-Postfix wenn negativ

#

Ziffer oder Leerzeichen-Präfix

&

Ziffer oder '0'

?

Beliebig viele Zeichen

.

Dezimalpunkt

,

Komma, oder Leerzeichen-Präfix

 

Ein Präfix ist dabei ein Zeichen, das einem Wert bei Bedarf vorangestellt wird. Der Ausdruck Fstr$(1, "***") ergibt z. B. "**1". Dem Wert "1" werden dabei die Zeichen "**" vorangestellt, weil es kürzer als die drei reservierten Stellen ist. Ein Postfix ist ein Zeichen, das einem Wert bei Bedarf nachgestellt wird. Diese Formatierungs-Zeichen dürfen beliebig kombiniert werden. Wenn die Zahl zu groß ist für die gewünschte Formatierung, wird eine Zeichenkette aus '*' erstellt.

Über den dritten (optionalen) Parameter kann zusätzlich die Formatierung gesteuert werden.

Wert

Bedeutung

1

Entfernung führender Leerzeichen. Die Anwendung entspricht den Funktionen Rtrim$() und Ltrim$().

2

Leere Zeichenkette, wenn Wert Null.

3

Entfernung führender Leerzeichen und leere Zeichenkette, wenn Wert Null.

4

Entfernung von '0' am Ende der Dezimalstellen.

 

Parameter:

Zahl

Zeichenkette Format-Zeichenkette

Zahl             (optional) zusätzliche Formatierung

Rückgabewert:

Zeichenkette

Beispiele:

Fstr$(3.142,"#")                           Ergebnis: "3"

Fstr$(0,"#",2)                               Ergebnis: ""

Fstr$(0003.142,"#.###",1)           Ergebnis: "3,142"

Fstr$(3.1,"######&.###",4)       Ergebnis: "3,1"

Fstr$(3.1,"######&.###") Ergebnis: "3,100"

Fstr$(.1,"######&.###")           Ergebnis: "0,100"

Fstr$(5003.1,"#,###.&&")             Ergebnis: "5.003,10"

Fstr$(3.142,"#.###")          Ergebnis: "3,142"

Fstr$(3.142,".######")               Ergebnis: "*******"

Fstr$(3.142,"(#.###)")                 Ergebnis: " 3,142 "

Fstr$(-3.142,"(#.###)")                Ergebnis: "(3,142)"

Fstr$(3.142,"+#.###")                 Ergebnis: "+3,142"

Fstr$(3.142,"-#.###")                  Ergebnis: " 3,142"

Fstr$(-3.142,"-#.###")                 Ergebnis: "-3,142"

Fstr$(3.142,"&&&.&&&")                Ergebnis: "003,142"

Fstr$(3.142,"***.***")                  Ergebnis: "**3,142"

Fstr$(3.142,"$$$.$$$")                  Ergebnis: "$$3,142"

Fstr$(3.142,"###.***")                Ergebnis: " 3,142"

Fstr$(5003.1,"#,###.&&")             Ergebnis: "5.003,10"

Fstr$(3.142,"#####")                  Ergebnis: " 3"