Format

Kategorie: Script / Strings
Ab Engineversion: 5.1 OC

Setzt eine Zeichenkette aus verschiedenen Werten zusammen. Dabei wird text von vorne bis zum Ende nach mit '%' beginnenden Platzhaltern durchsucht, um diese dann durch die Parameter zu ersetzen.
Das allgemeine Syntax für diese Platzhalter lautet:
%[Länge][.Präzision]Typ Bis auf den Typ sind also alle Parameter optional. Der Typ gibt den Datentyp an, den der Parameter hat. Möglich sind folgende Werte:

Typ	Bedeutung
d	Ganzzahl (int)
x	Ganzzahl (int), hexadezimale Ausgabe (0123456789abcdef)
X	Ganzzahl (int), hexadezimale Ausgabe (0123456789ABCDEF)
i	id (Bei IDs funktionieren die restlichen Parameter wie Länge und Präzision nicht!)
s	Zeichenkette
v	Beliebig. Vor allem nützlich zur Fehlersuche.

Länge gibt eine Minimallänge an. Wenn der Wert kürzer ist, wird er rechtsbündig ausgerichtet und mit Leerzeichen aufgefüllt. Wird vor die Länge eine '0' gestellt, wird mit Nullen statt Leerzeichen aufgefüllt.

Das Präzisionsfeld verhält sich je nach dem Parametertyp: Bei Ganzzahlen (d) gibt es die Minimalzahl der auszugebenden Zahlen an (der Rest wird mit Nullen aufgefüllt), während es bei Zeichenketten (s) die Maximalzahl der auszugebenden Zeichen angibt.

Log(Format("Hello, %s.You have %d Clonks!", GetPlayerName(0), GetCrewCount(0)));

Log(Format("'%3d'", 1));

Log(Format("'%i'", GetID(GetCursor())));

Log(Format("'%3.2d'", 5));

Log(Format("'%.2s'", "test"));

Log(Format("'%03d'", 12));