Fstr$

Aufgabe:

Formatiert eine Zahl mit Hilfe der Format-Zeichenkette.

Dieser 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"