Ausdruck auswerten

$ ermöglicht die Umwandlung von Zahlen in Zeichenfolgen oder die Modifikation von Zeichenfolgen. Der Operand auf der linken Seite von $ ist die Zahl, die umgewandelt wird. Der Operand auf der rechten Seite von $ legt die Art der Umwandlung fest. Dieser ist mit der Formatzeichenfolge der printf()-Funktion in der Programmiersprache C vergleichbar. Die Formatzeichenfolge besteht aus den folgenden vier Teilen:

<Flags><Breite>.<Genauigkeit><Umwandlung>

Als regulärer Ausdruck:

[-+ #]?([0-9]+)?(\.[0-9]*)?[doxXfeEgGsb]?

Der reguläre Ausdruck steht für eine Zeichenfolge, die aus null oder mehr Zeichen im ersten Klammernpaar, gefolgt von null oder mehr Ziffern, hinter denen ein Punkt stehen kann, hinter dem wiederum Ziffern und ein Umwandlungszeichen aus dem letzten Klammernpaar stehen kann.

Beispiele für die Umwandlung von Zeichenfolgen mit $

Zum besseren Verständnis sind die Ergebnisse mit zusätzlichen Leerzeichen ein zweites Mal aufgelistet, wobei Punkte die zusätzlichen Leerzeichen vor und hinter der Eingabezeichenfolge darstellen. In der Zeichenfolge „total.....“ stehen die letzten 5 Punkte beispielsweise für Leerzeichen.

Die einzelnen Teile der Formatzeichenfolge sind wie folgt definiert:

Flags:

Null oder mehr Flags in beliebiger Reihenfolge, die die Bedeutung der Umwandlungsspezifikation festlegen. Flags können die folgenden Zeichen umfassen:

Flag	Beschreibung
-	Das Ergebnis der Umwandlung ist im Feld links ausgerichtet.
+	Das Ergebnis einer vorzeichenbehafteten Umwandlung beginnt immer mit einem Vorzeichen, d. h. + oder -.
Leerzeichen	Wenn das erste Zeichen einer vorzeichenbehafteten Umwandlung kein Vorzeichen ist, wird dem Ergebnis ein Vorzeichen vorangestellt.
#	Der Wert muss in eine „alternative Form“ umgewandelt werden. Bei d- und s-Umwandlungen (siehe unten) hat dieses Flag keine Auswirkung. Bei einer o-Umwandlung (siehe unten) wird die Genauigkeit erhöht, damit die erste Ziffer des Ergebnisses eine Null ist. Bei x- oder X-Umwandlungen (siehe unten) wird einem von null verschiedenen Ergebnis 0x bzw. 0X vorangestellt. Bei e-, E-, f-, g- und G-Umwandlungen enthält das Ergebnis immer ein Radixzeichen (auch dann, wenn hinter dem Radixzeichen keine Ziffern stehen). Bei g- und G-Umwandlungen werden führende Nullen nicht aus dem Ergebnis entfernt (entgegengesetzt zum üblichen Verhalten).

Breite:

Eine optionale Zeichenfolge aus Dezimalziffern zum Angeben einer minimalen Feldbreite. Wenn der umgewandelte Wert bei einem Ausgabefeld weniger Zeichen umfasst als die Feldbreite, wird der Wert auf der linken Seite bis zur Feldbreite aufgefüllt (bzw. auf der rechten Seite, falls das Linksausrichtungsflag - angegeben wurde).

Genauigkeit:

Die Genauigkeit gibt die minimale Anzahl der anzuzeigenden Ziffern für Ganzzahlenumwandlungen (das Feld wird mit führenden Nullen aufgefüllt), die Anzahl der anzuzeigenden Ziffern hinter dem Radixzeichen bei e- und f-Umwandlungen, die maximale Anzahl signifikanter Ziffern bei g-Umwandlungen bzw. die maximale Anzahl auszugebender Zeichen bei einer Zeichenfolgenumwandlung an. Die Angabe der Genauigkeit erfolgt in Form eines Punkts . mit einer Dezimalziffernzeichenfolge dahinter. Eine leere Ziffernzeichenfolge wird als Null behandelt.

Umwandlung:

Die Art der gewünschten Umwandlung wird durch ein Umwandlungszeichen angegeben:

Umwandlungszeichen	Beschreibung
d, o, x, X	Das ganzzahlige Argument wird in vorzeichenbehafteter Dezimal- (d), vorzeichenloser Oktal- (o) oder vorzeichenloser Hexadezimalschreibweise (x und X) ausgegeben. Bei der x-Umwandlung werden die Zahlen und Kleinbuchstaben 0123456789abcdef, bei der X-Umwandlung die Zahlen und Großbuchstaben 0123456789ABCDEF verwendet. Die Genauigkeitskomponente des Arguments bestimmt die minimale Anzahl anzuzeigender Ziffern. Wenn der umgewandelte Wert mit weniger Ziffern als das angegebene Minimum dargestellt werden kann, wird er mit führenden Nullen erweitert. Die Standardgenauigkeit ist 1. Bei der Umwandlung eines Nullwerts mit einer Genauigkeit von 0 werden keine Zeichen zurückgegeben.
f	Das Fließkommazahlenargument wird in Dezimalschreibweise in der Form [-]ddd.ddd ausgegeben, wobei die Anzahl der Ziffern hinter dem Radixzeichen, ., der angegebenen Genauigkeit entspricht. Wird im Argument keine Genauigkeit angegeben, werden sechs Ziffern ausgegeben. Wird die Genauigkeit explizit als 0 angegeben, wird kein Radixzeichen angezeigt.
e, E	Das Fließkommazahlenargument wird in der Form [-]d.ddde+dd ausgegeben, wobei eine Ziffer vor dem Radixzeichen steht und die Anzahl der Ziffern dahinter der angegebenen Genauigkeit entspricht. Wird keine Genauigkeit angegeben, werden sechs Ziffern ausgegeben. Wird die Genauigkeit als 0 angegeben, wird kein Radixzeichen angezeigt. Das E-Umwandlungszeichen bewirkt, dass eine Zahl entsteht, bei der E anstelle von e vor dem Exponenten steht. Der Exponent enthält immer mindestens zwei Ziffern. Wenn der auszugebende Wert jedoch einen Exponenten mit mehr als zwei Ziffern notwendig macht, werden bei Bedarf weitere Ziffern im Exponenten ausgegeben.
g, G	Das Fließkommazahlenargument wird in f- oder e-Form (bzw. E-Form, wenn G als Umwandlungszeichen verwendet wird) ausgegeben, wobei die Genauigkeit die Anzahl signifikanter Ziffern angibt. Die verwendete Form hängt vom umgewandelten Wert ab. Die e-Form wird nur verwendet, wenn der resultierende Exponent der Umwandlung kleiner als -4 bzw. größer-gleich der Genauigkeit ist. Führende Nullen werden aus dem Ergebnis entfernt. Ein Radixzeichen wird nur angezeigt, wenn dahinter eine Ziffer folgt.
s	Das Argument wird als Zeichenfolge verarbeitet. Die Zeichen der Zeichenfolge werden ausgegeben, bis das Ende der Zeichenfolge oder die Anzahl der Zeichen erreicht ist, die durch die Genauigkeit des Arguments bestimmt wird. Wird keine Genauigkeit im Argument angegeben, wird sie als unendlich interpretiert, sodass alle Zeichen bis zum Ende der Zeichenfolge ausgegeben werden.

Eine nicht vorhandene oder unzureichende Feldgröße bewirkt in keinem Fall, dass ein Feld abgeschnitten wird. Wenn das Ergebnis einer Umwandlung breiter ist als die Feldbreite, wird das Feld einfach dem Umwandlungsergebnis entsprechend erweitert.

Die Zeichenfolgenverkettung (+) kann zusammen mit Zeichenfolgen sowie allen numerischen Typen angewendet werden. Die Operanden werden bei Bedarf zuerst in Zeichenfolgen umgewandelt (gemäß der jeweiligen Standarddarstellung). Mindestens ein Operand muss bereits eine Zeichenfolge sein, damit der Operator für die Zeichenfolgenverkettung verwendet werden kann.

Beispiel für eine Zeichenfolgenverkettung

In diesem Beispiel wird ein Dateiname erstellt (z. B. „Name2.png“). Dazu werden zwei Zeichenfolgekonstanten („Name“ und „.png“) und ein Ganzzahlenwert (der Schleifenindexzähler) verkettet.

strchr(string,char) gibt den Index des ersten Vorkommens eines der Zeichen in char in der Zeichenfolge string zurück, strrchr(string,char) den Index des letzten Vorkommens eines der Zeichen in char in der Zeichenfolge string. Ist keines der Zeichen in string enthalten, wird -1 zurückgegeben. Bei string kann es sich um eine einzelne Zeichenfolge oder ein Tupel handeln.

Beispiele für str(r)chr

strstr(string_1,string_2) gibt den Index des ersten Vorkommens von string_2 in string_1 zurück und strrstr(string_1,string_2) gibt den Index des letzten Vorkommens von string_2 in string_1 zurück. Ist string_2 nicht in string_1 enthalten, wird -1 zurückgegeben. Bei string_1 kann es sich um eine einzelne Zeichenfolge oder ein Tupel handeln.

Beispiele für str(r)str

strlen(string) gibt die Anzahl der Zeichen in string zurück.

Beispiel für strlen

string{index} wählt ein einzelnes Zeichen in string aus, das über die Indexposition bestimmt wird. Der Index reicht von null bis zur Länge von string minus 1. Das Ergebnis des Operators ist eine Zeichenfolge der Länge eins.

string{index_1:index_2} gibt alle Zeichen von der ersten angegebenen Indexposition (index_1) bis zur zweiten angegebenen Position (index_2) in s als Zeichenfolge zurück. Der Index reicht von null bis zur Länge von string minus 1.

Beispiele für {}

split(string_1,string_2) unterteilt string_1 in einzelne Teilzeichenfolgen. String_1 wird an den Positionen aufgeteilt, an denen ein Zeichen aus string_2 steht.

Beispiel für split

Die Zeichenfolge wird am Zeichen „:“ in zwei Teilzeichenfolgen aufgeteilt. Die Teilzeichenfolgen werden in einem Tupel zurückgegeben.

regexp_match(string_1,string_2) sucht Elemente des Tupels string_1, die dem regulären Ausdruck string_2 entsprechen. Es wird ein Tupel mit derselben Größe wie das Eingabetupel zurückgegeben. Das resultierende Tupel enthält die übereinstimmenden Ergebnisse für jedes Tupelelement des Eingabetupels. Bei einer Übereinstimmung wird die entsprechende Teilzeichenfolge zurückgegeben. Andernfalls wird eine leere Zeichenfolge zurückgegeben.

Beispiele für regexp_match

regexp_replace(string_1,regex,string_2) ersetzt die Teilzeichenfolgen in string_1, die dem regulären Ausdruck regex entsprechen, durch die in string_2angegebene Zeichenfolge. Standardmäßig wird nur die erste übereinstimmende Teilzeichenfolge der einzelnen Elemente in string_1 ersetzt. Wenn alle Vorkommen ersetzt werden sollen, muss die Option 'replace_all' in regex festgelegt werden.

Beispiele für regexp_replace

regexp_select(string_1,regex) gibt nur die Elemente des Tupels string_1 zurück, die dem regulären Ausdruck regex entsprechen. Im Gegensatz zu regexp_match werden die ursprünglichen Tupelelemente anstelle der übereinstimmenden Teilzeichenfolgen zurückgegeben. Tupelelemente, die nicht dem regulären Ausdruck entsprechen, werden gelöscht. Darüber hinaus unterstützt regexp_select die Option 'invert_match'. Diese Option bewirkt, dass die Eingabezeichenfolgen ausgewählt werden, die nicht dem regulären Ausdruck entsprechen.

Beispiele für regexp_select

regexp_test(string,regex) gibt die Anzahl der Elemente des Tupels string zurück, die dem regulären Ausdruck regex entsprechen. Darüber hinaus gibt es eine Kurzschreibweise des Operators, die in Bedingungsausdrücken praktisch ist: string_1 =~ string_2