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'

.

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"