Das Asterisk Buch

Strings (als Variablen, die keine Zahlen, sondern Text enthalten) sollten immer in Anführungszeichen gesetzt werden. Asterisk akzeptiert sie aber auch ohne diese Markierung. So sind die folgenden zwei Zeilen im Ergebnis gleich:

exten => 1234,1,Set(OBST=Apfel)
exten => 1234,2,Set(OBST="Apfel")

Sollte der String ein Komma oder ein Leerzeichen enthalten, dann müssen Sie Anführungszeichen verwenden, da diese sonst als Kommandos und nicht als Strings interpretiert werden:

exten => 1234,1,Set(OBSTSORTEN="Apfel, Birne, usw.")

Bei einer Variablen, die Zeichen oder Zeichenfolgen (Wörter, Text) als Werte enthält, kann es vorkommen, dass man bestimmte Zeichen verwenden möchte, die bereits für andere Funktionen reserviert sind. Wollen Sie zum Beispiel ein Underscore-Zeichen als Bestandteil des Variablenwertes verwenden, müssen Sie es besonders kennzeichnen bzw. maskieren. Diese Kennzeichnung nennt man beim Programmieren „escapen“. Folgende Zeichen müssen auf jeden Fall maskiert („escapt“) werden:

[ ] $ " \

Das Quoting in der extensions.conf erfolgt mit einem vorangestellten \ (Backslash).

Beispiel:

exten => 1234,1,Set(BETRAG="10,00 US \$")

Bestehen Variablen aus einer Ganzzahl (Integer), so kann diese maximal 18 Stellen betragen. Bei Zahlen, die größer sind, tritt ein Fehler auf, der im Logfile protokolliert wird.

	Tipp
	Wenn Sie mit größeren Zahlen oder Kommazahlen (Real) arbeiten wollen, können Sie dies mit einem AGI-Skript realisieren (siehe Kapitel 20, Asterisk Gateway Interface (AGI)).

Set(Variablenname=Wert)

Beispiel:

; Eine Channel-Variable setzen:
exten => 10,1,Set(LIEBLINGSOBSTSORTE="Apfel")

; Eine globale Variable setzen:
exten => 10,n,Set(GLOBAL(KLINGELZEIT)=90)

; Die Variablen auf dem CLI ausgeben
exten => 10,n,NoOp(KLINGELZEIT = ${KLINGELZEIT})
exten => 10,n,NoOp(LIEBLINGSOBSTSORTE = ${LIEBLINGSOBSTSORTE})
exten => 10,n,NoOp(VAR1 = ${VAR1})
exten => 10,n,NoOp(VAR2 = ${VAR2})

Will man eine Channel-Variable übergeben, aber keine globale Variable dafür benutzen, so kann man der Channel-Variable ein _ (Unterstrich) voransetzen. Diese Channel-Variable wird dann an den nächsten Channel vererbt. Dabei wird der Unterstrich entfernt. Die Vererbung kann also nur einmal erfolgen.

Beispiel:

exten => 1234,1,Set(_KUCHENSORTE="Marmorkuchen")

Will man eine Channel-Variable beliebig oft vererben, so muss man zwei __ (Unterstrich)-Zeichen vor die Variable setzen. Die zwei Unterstrich-Zeichen werden dann immer mitvererbt.

	Warnung
	Asterisk unterscheidet die Namen von Variablen, die mit einem Underscore anfangen, nicht von Variablen, die keinen Underscore haben. So wird im folgenden Beispiel aus der vererbbaren Channel-Variable KUCHENSORTE eine normale (nicht vererbbare) Channel-Variable: exten => 1234,1,Set(__KUCHENSORTE="Marmorkuchen") exten => 1234,n,Set(KUCHENSORTE="Marmorkuchen")

Beispiel:

exten => 1234,1,Set(__KUCHENSORTE="Nusskuchen")

Die Unterstriche müssen aber nur beim Setzen der Variable vorangestellt werden, nicht beim Auslesen.

exten => 1234,1,Set(__KUCHENSORTE="Pflaumenkuchen")
exten => 1234,n,NoOp(Kuchen: ${KUCHENSORTE})

In der Regel bezeichnen Strings eine Aneinanderreihung einzelner Zeichen (character). Die Größe eines Strings bestimmt sich durch die Anzahl der identifizierbaren einzelnen Zeichen. Zum Beispiel besteht der String „Apfelbaum“ aus 9 Zeichen. Ein String kann grundsätzlich in sogenannte Teilstrings zerlegt werden, also in Strings, die, wenn man sie wieder aneinanderreiht, den ursprünglichen String ergeben. Im genannten Beispiel könnten wir den String „Apfelbaum“ in die Teilstrings „Apfel“ und „baum“ zerlegen, aber auch „Apf“ und „elbaum“ sind echte Teilstrings. Ein String hat theoretisch keine begrenzte Größe, er kann beliebig viele Zeichen enthalten; der gesamte Text dieses Buches könnte so als ein String aufgefasst werden. Natürlich wäre das dann nicht mehr sehr handlich. Dennoch ist der Vorgang des Zerlegens eines Strings in Teilstrings eine Standardprozedur beim Programmieren von Anwendungen. In vielen Programmiersprachen heißt die hier beschriebene Funktionalität Substring. Mit einer Substring-Funktion kann man Teile eines Strings ausschneiden und das Ergebnis in einer anderen Variablen abspeichern. In Asterisk gibt es keine eigenständige Routine für diese Substring-Funktion, sondern hierfür wird ein : (Doppelpunkt) nach dem Variablennamen eingesetzt. Vom Inhalt der Variablen, also dem String, wird dann eine vorgegebene Anzahl von Zeichen (Länge) als Teilstring abgetrennt.

${VARIABLENNAME[:Anfang[:Laenge]]}

exten => _0X.,1,Set(RUFNUMMER=${EXTEN:1})

exten => _0X.,1,Set(DURCHWAHL=${EXTEN:-5})

exten => _0X.,1,Set(VORWAHL=${EXTEN:1:3})

exten => _0001X.,1,Set(INTERNATIONALEVORWAHL=${EXTEN:3:1})
exten => _0001X.,n,Set(ORTSVORWAHL=${EXTEN:4:3})
exten => _0001X.,n,Set(RUFNUMMER=${EXTEN:7})
exten => _0001X.,n,Set(DURCHWAHL=${EXTEN:-4}