Funktionsreferenz

StringFormat

Gibt eine formatierte Zeichenfolge zurück (ähnlich zu C sprintf() Funktion).

StringFormat ( "format control", var1 [, ... var32] )

 

Parameter

format control Das Format und Flags (siehe Anmerkungen).
var1...var32 Bis zu 32 Variable, die entprechend dem "format control" ausgegebn werden.

 

Bemerkungen

Um Speicherüberlauf (buffer overflow) zu vermeiden, ist jede "variable" auf 65535 Zeichen limitiert.

"variable format" ist: %[Flags] [Weite] [.Genauigkeit] Typ

        Specification der Weite (width)

Das zweite optionale Feld der Format Spezifikation ist die der Weite. Das Argument für die Weite ist eine nicht negative dezimale Ganzzahl, die das Minimum der zu druckenden Zeichen festlegt. Ist die Anzahl der Zeichen im Ausgabewert kleiner als die spezifiert Weite, werden Leerzeichen rechts oder links zu den Werten addiert — abhängig davon ob der Flag für Links-Ausrichtung spezifiziert ist — bis die minimale Weite erreicht ist. Ist der Weite eine 0 vorangestellt werden Nullen addiert bis das Minimum erreicht ist (nicht sinnvoll für links ausgerichtete Zahlen).

Die Weite Spezifikation verursacht niemals das ein Wert abgeschnitten wird. Ist die Anzahl der Zeichen im Ausgabewert größer als die spezifizierte Weite oder ist die Weite nicht angegeben, werden alle Zeichen gedruckt (entsprechend der Genauigkeit der Spezifizierung).

        Typ Spezifizierung

Typ Variablen Typ Ausgabeformat
d, i Ganzzahl Dezimale Ganzzahl mit Vorzeichen.
o Integer Oktale Ganzzahl ohne Vorzeichen.
u Integer Dezimale Ganzzahl ohne Vorzeichen.
x Integer Hexadezimal Ganzzahl (ohne VZ), Gebrauch "abcdef".
X Integer Hexadezimal Ganzzahl (ohne VZ), Gebrauch "ABCDEF".
e Float Wert mit Vorzeichen in der Form [ - ]d.dddd e [sign]ddd wobei d ein Einzelnes dezimales Zeichen ist, dddd steht für ein oder mehrere dezimale Zeichen, ddd steht für genau drei dezimale Zeichen und sign (Vorzeichen) kann + oder - sein.
E Float Identisch zum e Format bis auf das E gegenüber e den Exponent einführt.
f Float Wert mit Vorzeichen in der Form [ - ]dddd.dddd, wobei dddd für ein oder mehrere dezimale Zeichen steht. Die Anzahl der Zeichen vorm dezimal Punkt ist abhängig von der Größenordnung der Zahl. Die Anzahl der Zeichen nach dem dezimal Punkt ist abhängig von der verlangten Genauigkeit.
g Float Wert mit Vozeichen ausgedruckt im f oder e Format, je nachdem welches Format für den gegebenen Wert und die erwartete Genauigkeit angemessener ist. Das e Format wird nur verwendet, wenn der Exponent des Werte weniger als -4 oder größer oder gleich dem Genauigkeitsargument ist. Nachfolgende Nullen werden abgeschnitten und der Dezimalpunkt erscheint nur, wenn ein oder mehrere Nachkommastellen folgen.
G Float Identisch zum g Format bis auf das E gegenüber e den Exponent einführt.
s String Zeichenfolge.

        Flag Spezifizierung

Flag Bedeutung Vorgabe
- Richtet das Ergebnis im gegebenen Feld links aus. Rechtsbündig.
+ Stellt dem Ausgabewert ein Vorzeichen (+ or -) vor, falls der Ausgabewertes von diesem Typ ist. Vorzeichen erscheinen nur vor negativen Werten(-).
0 Wird width eine 0 vorangestellt werden Nullen addiert bis das Minimum der Weite erreicht ist. Kommen 0 und - vor, wird 0 ignoriert. Ist 0 spezifiziert mit einem Integer/Ganzzahl Format (i, u, x, X, o, d) wird 0 ignoriert. Kein auffüllen.
Blank Dem Ausgabewert wird ein Leerzeichen vorangestellt, wenn der Ausgabewert ein Vorzeichen enthält und positiv ist; Das Leerzeichen wird ignoriert, wenn das Leerzeichen und + flags erscheinen. Kein Leerzeichen.
# Benutzt mit dem o, x, oder X Format, der # Flag setzt jedem nicht Null Ausgabewert eine 0, 0x, oder 0X voran. Keine Leerzeichen.
# Benutzt mit dem e, E oder f Format, der # Flag zwingt den Ausgabewert in allen Fällen ein Dezimalpunkt zu enthalten. Der Dezimalpunkt wird nur bei nachfolgenden Zeichen angezeigt.
# Benutzt mit dem g or G Format, der # Flag zwingt den Ausgabewert in allen Fällen einen Dezimalpunkt anzuzeigen und verhindert das Abschneiden von nachfolgenden Nullen.
Wird ignoriert, wenn benutzt mit c, d, i, u, or s.		 Der Dezimalpunkt wird nur bei noch nachfolgenden Zeichen angezeigt. Nachfolgende Nullen werden abgeschnitten.

        Spezikation der Genauigkeit (precision)

Das dritte optionale Feld der Format Spezifikationen ist die Genauigkeitsangabe. Es handelt sich dabei um eine nicht negative dezimale Ganzzahl, der ein Punkt (.) vorangestellt wird. Diese Spezifikation legt fest: die Anzahl der Zeichen die gedruckt werden soll, die Anzahl der dezimalen Stellen oder die Anzahl signifikanter Zeichen (siehe Tabelle unten). Ungleich der Spezifikation der Weite, die Spezifikation der Genauigkeit kann das Abschneiden der Ausgabewerte bewirken oder das Runden von Fließkomma Zahlen. Ist die Genauigkeit mit 0 angegeben und der ist der zu konvertierende Wert ebenfalls 0, enhält der Ausgabewert kein Zeichen (= no characters output), wie nachfolgend dargestellt:

printf( "%.0d", 0 ); /* No characters output */

    Wie Genauigkeitsangaben den Type beeinflussen

Typ Bedeutung Vorgabe
d, i, u, o, x, X Der Genauigkeitswert legt die minimale Anzahl der Zeichen, die gedruckt werden sollen, fest. Wenn die Anzahl der Zeichen im Argument kleiner ist als die Genauigkeit, wird der Ausgabewert links mit Nullen aufgefüllt. Der Wert wird nicht abgeschnitten, wenn die Anzahl der Zeichen die Genauigkeit überschreitet. Die Vorgabe für die Genauigkeit ist 1.
e, E Der Geanuigkeitswert legt Anzahl der zu druckenden Nachkommastellen fest. Die letzte Nachkommastelle wird gerundet. Der Vorgabewert ist 6. Ist die Genauigkeit 0 oder erscheint ein Punkt ohne Nachkommastellen, wird kein dezimal Punkt gedruckt.
f Der Genauigkeitswert legt die Anzahl der Nachkommastellen fest. Wenn ein dezimal Punkt erscheint, ist mindestens ein Zeichen davor. Der Wert wird auf die entsprechende Anzahl von Zeichen gerundet. Der Vorgabewert ist 6. Ist die Genauigkeit 0 oder erscheint ein Punkt ohne Nachkommastellen, wird kein dezimal Punkt gedruckt.
g, G Der Genauikeitswert legt die maximale Anzahl signifikanter Zeichen, die gedruckt werden sollen, fest. Sechs signifikante Zeichen werden gedruckt, wobei nachfolgende Nullen abgeschnitten werden. Sechs signifikante Zeichen werden gedruckt, wobei nachfolgende Nullen abgeschnitten werden.
s Der Genauigkeitswert legt die maximale Anzahl der zu druckenden Zeichen fest. Zeichen die dieses Limit übersteigen werden nicht gedruckt. Zeichen werden bis zum erscheinen eines Null-Zeichens gedruckt.

 

Siehe auch

Kein.

 

Beispiel


$string = "string"
$float = 12.3
$int = 345
$s =StringFormat ( "var1=%s var2=%.2f, var3=%d" ,$string, $float, $int )
$msgbox(0, "Result", $s)
; will output         "var1=string var2=12.30 var3=345"
; notice the 12.30  done with the %.2f which force 2 digits after the decimal point