TurboPL Referenz

Str Prozedur

Top  Previous  Next

Syntax

Str(Wert: Real/Integer; Breite, Nachkommastellen: Integer; TausenderTrenner, Füllzeichen, Dezimaltrenner: String): String

Kategorie

Basisfunktion

Erklärung

Wandelt den Wert in Zeichenkette um. Mit Ausnahme des Wertes sind alle weiteren Parameter optional. Die Breite gibt die Länge der Zeichenkette an, innerhalb derer der Wert rechtsbündig dargestellt wird. Reicht die Länge zur Darstellung der Zahl nicht aus, wird die Zeichenkette automatisch soweit nötig erweitert. Nachkommastellen bestimmt die Anzahl der Nachkommastellen. TausenderTrenner gibt die Tausendertrennung an, Füllzeichen ist dasjenige Zeichen, mit dem die Zeichenkette nach links hin aufgefüllt wird. Wenn ein Parameter nicht angegeben ist, werden die folgenden Vorgabewerte benutzt:

Breite                        1                        so breit wie nötig

Nachkommastellen        0                        keine Nachkommastellen

TausenderTrenner        leer                        keine Tausendertrennung

Füllzeichen                Leerzeichen                vorne Leerzeichen

Dezimaltrenner                leer                        das mit SetNumberFormats eingestellte Zeichen, Standard-mäßig ein Punkt

Wenn das Argument bei Wert ein Aufzählungsfeld ist, liefert Str den Aufzählungswert.

Wenn das Argument ein Null-Wert ist, liefert Str einen Leerstring.

Laufzeitfehler

Keine

Beispiel

Str(1)                                                ->            "1"

Str(123)                                                ->          "123"

Str(1,5)                                                ->        "    1"

Str(123,5)                                        ->        "  123"

Str(1,5,2)                                        ->        " 1.00"

Str(123,5,2)                                ->       "123.00"

Str(1,5,2,".")                        ->        " 1,00"

Str(12345,12,2,".")                -> "   12.345,00"

Str(12345,12,2,".","$")                -> "$$$12.345,00"

Str(12345,12,2,".","*")                -> "***12.345,00"

Siehe auch

Val, Text-Funktionen, SetNumberFormats