###Function###
StringFormat

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

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

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


###ReturnValue###
Gibt die formatierte Zeichenfolge zurück, entsprechend zu &quot;variable format&quot; definiert in den &quot;format control&quot; parametern.


###Remarks###
Um Speicherüberlauf (buffer overflow) zu vermeiden, ist jede &quot;variable&quot; auf 65535 Zeichen limitiert.

&quot;variable format&quot; ist: %[Flags] [Weite] [.Genauigkeit] Typ

		<b>Specification der Weite (width)</b>

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).

		<b>Typ Spezifizierung</b>

@@StandardTable1@@
<b>Typ</b>	<b>Variablen Typ</b>	<b>Ausgabeformat</b>
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 &quot;abcdef&quot;.
X	Integer	Hexadezimal Ganzzahl (ohne VZ), Gebrauch &quot;ABCDEF&quot;.
e	Float	Wert mit Vorzeichen in der Form [ - ]<i>d</i><b>.</b><i>dddd</i> <b>e</b> [<i>sign</i>]<i>ddd</i> wobei <i>d</i> ein Einzelnes dezimales Zeichen ist, <i>dddd</i> steht für ein oder mehrere dezimale Zeichen, <i>ddd</i> steht für genau drei dezimale Zeichen und <i>sign (Vorzeichen)</i> kann + oder - sein.
E	Float	Identisch zum <b>e</b> Format bis auf das <b>E</b> gegenüber <b>e</b> den Exponent einführt.
f	Float	Wert mit Vorzeichen in der Form [ - ]<i>dddd</i><b>.</b><i>dddd</i>, wobei <i>dddd</i> 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 <b>f</b> oder <b>e</b> Format, je nachdem welches Format für den gegebenen Wert und die erwartete Genauigkeit angemessener ist. Das <b>e</b> 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 <b>g</b> Format bis auf das <b>E</b> gegenüber <b>e</b> den Exponent einführt.
s	String	Zeichenfolge.
@@End@@

		<b>Flag Spezifizierung</b>

@@StandardTable1@@
<b>Flag</b>	<b>Bedeutung</b>	<b>Vorgabe</b>
-	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 <i>width</i> eine <b>0</b> vorangestellt werden Nullen addiert bis das Minimum der Weite erreicht ist. Kommen 0 und - vor, wird <b>0</b> ignoriert. Ist <b>0</b> spezifiziert mit einem Integer/Ganzzahl Format (<b>i</b>, <b>u</b>, <b>x</b>, <b>X</b>, <b>o</b>, <b>d</b>) wird <b>0</b> 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 <b>o</b>, <b>x</b>, oder <b>X</b> Format, der # Flag setzt jedem nicht Null Ausgabewert eine 0, 0x, oder 0X voran.	Keine Leerzeichen.
#	Benutzt mit dem <b>e</b>, <b>E</b> oder <b>f</b> Format, der <b>#</b> Flag zwingt den Ausgabewert in allen Fällen ein Dezimalpunkt zu enthalten.	Der Dezimalpunkt wird nur bei nachfolgenden Zeichen angezeigt.
#	Benutzt mit dem <b>g</b> or <b>G</b> Format, der <b>#</b> Flag zwingt den Ausgabewert in allen Fällen einen Dezimalpunkt anzuzeigen und verhindert das Abschneiden von nachfolgenden Nullen.<br>Wird ignoriert, wenn benutzt mit <b>c</b>, <b>d</b>, <b>i</b>, <b>u</b>, or <b>s</b>.	Der Dezimalpunkt wird nur bei noch nachfolgenden Zeichen angezeigt. Nachfolgende Nullen werden abgeschnitten.
@@End@@

		<b>Spezikation der Genauigkeit (precision)</b>

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 */

	<b>Wie Genauigkeitsangaben den Type beeinflussen</b>

@@StandardTable1@@
<b>Typ</b>	<b>Bedeutung</b>	<b>Vorgabe</b>
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.
@@End@@


###Related###
Kein.


###Example###
@@IncludeExample@@