Zuweisung¶

Variablen werden immer Zeichenfolgen zugewiesen, deren Leerzeichen erhalten bleiben. Die folgenden Beispiele veranschaulichen dies:

    %Serien%=Neue Serien~Krimis

Der Variable '%Serien%' wird die Zeichenfolge "Neue Serien~Krimis" zugewiesen. Sie lässt sich beliebig weiterverwenden:

    %Pfad%=%Serien%

Der Variable '%Pfad%' wird der Inhalt der Variable '%Serien%' zugewiesen.

    %Pfad%=%Serien%~Tatort

Die Variable '%Pfad%' enthält die Zeichenfolge "Neue Serien~Krimis~Tatort".

Bedingte Zuweisung¶

Für Zuweisungen werden einfache Wenn-dann-sonst-Konstrukte mittels bedingter Ausdrücke ('wenn ? dann : sonst') unterstützt. Bedingte Ausdrücke dürfen keine Zeichenfolgen enthalten, sondern nur Variablen; Leerzeichen werden ignoriert.

    %Foo%=Verschiedenes
    %Variable%=%Pfad% ? %Pfad% : %Foo%

Beim ternären Operator '?:' steht der Ausdruck '%Pfad% ?' für die Bedingung "Pfad nicht leer?". Wenn dies zutrifft, wird '%Variable%' der Inhalt von '%Pfad%' zugewiesen, andernfalls der Inhalt von '%Foo%'.

Auch andere Prüfungen sind möglich:

So zum Beispiel:

    %Variable%=%Pfad%!=5 ? %Pfad% : %Foo%

Die Bedingung '%Path%!=5 ?' bedeutet "ist '%Pfad%' ungleich 5?".

Der Vergleich von Variablen ist ebenfalls möglich:

    %Fuenf%=5
    %Variable%=%Pfad%!=%Fuenf% ? %Pfad% : %Foo%

Man beachte, dass der Variablenname '%Fünf%' aufgrund des Umlauts ungültig wäre.

Aufruf von Systemkommandos¶

Während der Variablenauswertung können auch externe Befehle aufgerufen werden. Die zurückgegebene Zeichenfolge wird der jeweiligen Variablen zugewiesen:

    %Ergebnis%=system(<Skriptname>[, <Parameter>])

Ruft das Skript Skriptname mit den in der optionalen Liste 'Parameter' angegebenen Parametern auf. Ein solcher Parameter kann ein beliebiger Ausdruck sein, der gegebenenfalls andere Variablen enthält, jedoch kein Systemaufruf oder bedingter Ausdruck.

Beispiel:

    %Ergebnis%=system(/usr/local/bin/mein-skript.sh, -t %Title% -s %Subtitle% -u %EineAndereVariable%)

Als Parameter verwendete Variablen werden bei Bedarf in einfache Anführungszeichen (Apostrophe) gesetzt.

Das Skript sollte einen String ohne Zeilenvorschübe zurückgeben, da deren Entfernung zu unerwünschten Ergebnissen führen kann. Wenn das Skript nichts zurückgibt, wird der Variable '%Ergebnis%' ein leerer String zugewiesen.

Aufruf von TCP-Diensten¶

in TCP-Dienst kann mit der folgenden Syntax aufgerufen werden:

    %Ergebnis%=connect(<Adresse>, <Port>, [<Daten>])

Dadurch wird eine Verbindung zu 'Adresse' über den angegebenen 'Port' hergestellt und die optionalen 'Daten' übergeben. Der Parameter 'Adresse' kann eine IP-Adresse oder der Domänenname eines TCP-Dienstes sein. Das vom Dienst zurückgegebene Ergebnis muss mit einem Zeilenvorschub abgeschlossen sein.

Länge von Argumenten¶

Bei der Übergabe von Werten an Verbindungs- oder Systembefehle kann es hilfreich sein, zum einfacheren Parsen die Länge eines Arguments zu kennen. Diese lässt sich wie folgt ermitteln:

    %Ergebnis%=length(<beliebige Argumente>)

Beispiel:

    %Titellaenge%=length(%Title%)

Weitere Variablen¶

Eine Liste der internen Variablen findet sich in epgsearchmenu.conf(5). Darüber hinaus kann jede in epgsearchcats.conf definierte Variable verwendet werden; siehe hierzu auch epgsearchcats.conf(5).