Integrierte Funktionen werden von Ausdrücken in StyleBooks verwendet.

Beispielsweise können Sie die integrierte Funktion str() verwenden, um eine Zahl in eine Zeichenfolge umzuwandeln.

str($parameters.order)

Oder Sie können die integrierte Funktion int() verwenden, um eine Zeichenfolge in eine Ganzzahl umzuwandeln.

int($parameters.priority)

Im Folgenden finden Sie eine Liste der in StyleBook-Ausdrücken unterstützten integrierten Funktionen mit Anwendungsbeispielen:

str()

Die Funktion str() wandelt das Eingabeargument in einen Zeichenfolgenwert um.

Zulässige Argumenttypen:

• string
• number
• TCP-Port
• boolean
• IP-Adresse

Beispiele:

• Die Funktion "set-" + str(10) gibt "set-10" zurück.
• Die Funktion str(10) gibt 10 zurück.
• Die Funktion str(1.1.1.1) gibt 1.1.1.1 zurück.
• Die Funktion str(T rue) gibt "T rue" zurück.
• Die Funktion str(ADM) gibt "mas" zurück.

int()

Die Funktion int() akzeptiert eine Zeichenfolge, Zahl, IP-Adresse oder einen tcpport als Argument und gibt eine Ganzzahl zurück.

Beispiele:

• Die Funktion int("10") gibt 10 zurück.
• Die Funktion int(10) gibt 10 zurück.
• Die Funktion int(ip('0.0.4.1')) gibt 1025 zurück.

bool()

Die Funktion bool() akzeptiert einen beliebigen Typ als Argument. Wenn der Argumentwert false, leer oder nicht vorhanden ist, gibt diese Funktion false zurück.

Andernfalls gibt sie true zurück.

Beispiele:

• Die Funktion bool(true) gibt true zurück.
• Die Funktion bool(false) gibt false zurück.
• Die Funktion bool($parameters.a) gibt false zurück, wenn $parameters.a false, leer oder nicht vorhanden ist.

len()

Die Funktion len() akzeptiert eine Zeichenfolge oder eine Liste als Argument und gibt die Anzahl der Zeichen in einer Zeichenfolge oder die Anzahl der Elemente in einer Liste zurück.

Beispiel 1:

Wenn Sie eine Substitution wie folgt definieren:

items: ["123", "abc", "xyz"]

Die Funktion len($substitutions.items) gibt 3 zurück.

Beispiel 2:

Die Funktion len("NetScaler Console") gibt 10 zurück.

Beispiel 3:

Wenn $parameters.vips die Werte ['1.1.1.1', '1.1.1.2', '1.1.1.3'] hat, gibt die Funktion len($parameters.vips) 3 zurück.

min()

Die Funktion min() akzeptiert entweder eine Liste oder eine Reihe von Zahlen oder TCP-Ports als Argumente und gibt das kleinste Element zurück.

Beispiele mit einer Reihe von Zahlen/TCP-Ports:

• Die Funktion min(80, 100, 1000) gibt 80 zurück.
• Die Funktion min(-20, 100, 400) gibt -20 zurück.
• Die Funktion min(-80, -20, -10) gibt -80 zurück.
• Die Funktion min(0, 100, -400) gibt -400 zurück.

Beispiele mit einer Liste von Zahlen/TCP-Ports:

• Angenommen, $parameters.ports ist eine Liste von TCP-Ports und hat die Werte: [80, 81, 8080].

  Die Funktion min($parameters.ports) gibt 80 zurück.

max()

Die Funktion max() akzeptiert entweder eine Liste oder eine Reihe von Zahlen oder TCP-Ports als Argumente und gibt das größte Element zurück.

Beispiele mit einer Reihe von Zahlen/TCP-Ports:

• Die Funktion max(80, 100, 1000) gibt 1000 zurück.
• Die Funktion max(-20, 100, 400) gibt 400 zurück.
• Die Funktion max(-80, -20, -10) gibt -10 zurück.
• Die Funktion max(0, 100, -400) gibt 100 zurück.

Beispiele mit einer Liste von Zahlen/TCP-Ports:

• Angenommen, $parameters.ports ist eine Liste von TCP-Ports und hat die Werte: [80, 81, 8080].

  Die Funktion max($parameters.ports) gibt 8080 zurück.

bin()

Die Funktion bin() akzeptiert eine Zahl als Argument und gibt eine Zeichenfolge zurück, die die Zahl im Binärformat darstellt.

Beispiele für Ausdrücke:

Die Funktion bin(100) gibt 0b1100100 zurück.

oct()

Die Funktion oct() akzeptiert eine Zahl als Argument und gibt eine Zeichenfolge zurück, die die Zahl im Oktalformat darstellt.

Beispiele für Ausdrücke:

Die Funktion oct(100) gibt 0144 zurück.

hex()

Die Funktion hex() akzeptiert eine Zahl als Argument und gibt eine Kleinbuchstaben-Zeichenfolge zurück, die die Zahl im Hexadezimalformat darstellt.

Beispiele für Ausdrücke:

Die Funktion hex(100) gibt 0x64 zurück.

lower()

Die Funktion lower() akzeptiert eine Zeichenfolge als Argument und gibt dieselbe Zeichenfolge in Kleinbuchstaben zurück.

Beispiel:

Die Funktion lower("ADM") gibt adm zurück.

upper()

Die Funktion upper() akzeptiert eine Zeichenfolge als Argument und gibt dieselbe Zeichenfolge in Großbuchstaben zurück.

Beispiel:

Die Funktion upper("NetScaler Console") gibt NetScaler Console zurück.

sum()

Die Funktion sum() akzeptiert eine Liste von Zahlen oder TCP-Ports als Argumente und gibt die Summe der Zahlen in der Liste zurück.

Beispiel 1:

Wenn Sie eine Substitution wie folgt definieren: Substitutionen:

list-of-numbers = [11, 22, 55]

Die Funktion sum($substitutions.list-of-numbers) gibt 88 zurück.

Beispiel 2:

Wenn $parameters.ports [80, 81, 82] ist, gibt die Funktion sum($parameters.ports) 243 zurück.

pow()

Die Funktion pow() akzeptiert zwei Zahlen als Argumente und gibt eine Zahl zurück, die das erste Argument hoch der Potenz des zweiten darstellt.

Beispiel:

Die Funktion pow(3,2) gibt 9 zurück.

ip()

Die Funktion ip() akzeptiert eine Ganzzahl, Zeichenfolge oder eine IP-Adresse als Argument und gibt die IP-Adresse basierend auf dem Eingabewert zurück.

Beispiele:

• Geben Sie eine IP-Adresse in der Funktion ip an:

  Die Funktion ip(3.1.1.1) gibt 3.1.1.1 zurück.

• Geben Sie eine Zeichenfolge in der Funktion ip an:

  Die Funktion ip('2.1.1.1') gibt 2.1.1.1 zurück.

• Geben Sie eine Ganzzahl in der Funktion ip an:

  • Die Funktion ip(12) gibt 0.0.0.12 zurück.

  • Wenn Sie eine Ganzzahl als Zeichenfolge in der Funktion ip angeben, gibt sie eine äquivalente IP-Adresse der Eingabe zurück.

    Die Funktion ip('1025') gibt 0.0.4.1 zurück.

  Diese Funktion unterstützt auch die Addition und Subtraktion von Ganzzahlen und gibt eine resultierende IP-Adresse zurück.

  • Addition: Die Funktion ip(1025) + ip(12) gibt 0.0.4.13 zurück.

  • Subtraktion: Die Funktion ip('1025') - ip(12) gibt 0.0.3.245 zurück.

  • Kombinierte Addition und Subtraktion: Die Funktion ip('1.1.1.1') + ip('1.1.1.1') – ip(2) gibt 2.2.2.0 zurück.

base64.encode()

Die Funktion base64.encode() akzeptiert ein Zeichenfolgenargument und gibt die Base64-kodierte Zeichenfolge zurück.

Beispiel:

Die Funktion base64.encode("abcd") gibt YWJjZA== zurück.

base64.decode()

Die Funktion base64.decode() akzeptiert eine Base64-kodierte Zeichenfolge als Argument und gibt die dekodierte Zeichenfolge zurück.

Beispiel:

Die Funktion base64.decode("YWJjZA==") gibt abcd zurück.

exists()

Die Funktion exists() akzeptiert ein Argument beliebigen Typs und gibt einen booleschen Wert zurück. Der Rückgabewert ist True, wenn die Eingabe einen Wert hat. Der Rückgabewert ist False, wenn das Eingabeargument keinen Wert hat (d. h. keinen Wert).

Angenommen, $parameters.monitor ist ein optionaler Parameter. Wenn Sie diesem Parameter beim Erstellen eines Konfigurationspakets einen Wert zuweisen, gibt die Funktion exists($parameters.monitor) True zurück.

Andernfalls gibt sie False zurück.

filter()

Die Funktion filter() akzeptiert zwei Argumente.

Argument 1: Eine Substitutionsfunktion, die ein Argument akzeptiert und einen booleschen Wert zurückgibt.

Argument 2: Eine Liste.

Die Funktion gibt eine Untermenge der ursprünglichen Liste zurück, wobei jedes Element True ergibt, wenn es an die Substitutionsfunktion im ersten Argument übergeben wird.

Beispiel:

Betrachten Sie eine Substitutionsfunktion wie folgt:

Substitutionen:

x(a): $a != 81

Diese Funktion gibt True zurück, wenn der Eingabewert nicht gleich 81 ist. Andernfalls gibt sie False zurück.

Angenommen, $parameters.ports ist [81, 80, 81, 89].

Die Funktion filter($substitutions.x, $parameters.ports) gibt [80, 89] zurück, indem alle Vorkommen von 81 aus der Liste entfernt werden.

if-then-else()

Die Funktion if-then-else() akzeptiert drei Argumente.

Argument 1: Boolescher Ausdruck

Argument 2: Beliebiger Ausdruck

Argument 3: Beliebiger Ausdruck (optional)

Wenn der Ausdruck in Argument 1 als True ausgewertet wird, gibt die Funktion den Wert des als Argument 2 angegebenen Ausdrucks zurück.

Andernfalls, wenn Argument 3 angegeben ist, gibt die Funktion den Wert des Ausdrucks in Argument 3 zurück.

Wenn Argument 3 nicht angegeben ist, gibt die Funktion no zurück.

Beispiel 1:

Die Funktion if-then-else($parameters.servicetype == HTTP, 80, 443) gibt 80 zurück, wenn $parameters.servicetype den Wert HTTP hat. Andernfalls gibt die Funktion 443 zurück.

Beispiel 2:

Die Funktion if-then-else($parameters.servicetype == HTTP, $parameters.hport, $parameters.sport) gibt den Wert von $parameters.hport zurück, wenn $parameters.servicetype den Wert HTTP hat.

Andernfalls gibt die Funktion den Wert von $parameters.sport zurück.

Beispiel 3:

Die Funktion if-then-else($parameters.servicetype == HTTP, 80) gibt 80 zurück, wenn $parameters.servicetype den Wert HTTP hat.

Andernfalls gibt die Funktion keinen Wert zurück.

join()

Die Funktion join() akzeptiert zwei Argumente:

Argument 1: Liste von Zahlen, TCP-Ports, Zeichenfolgen oder IP-Adressen

Argument 2: Trennzeichen-Zeichenfolge (optional)

Diese Funktion verbindet die Elemente der als Argument 1 angegebenen Liste zu einer Zeichenfolge, wobei jedes Element durch die als Argument 2 angegebene Trennzeichen-Zeichenfolge getrennt wird. Wenn Argument 2 nicht angegeben ist, werden die Elemente in der Liste zu einer Zeichenfolge verbunden.

Beispiel:

• $parameters.ports ist [81, 82, 83].

  • Mit Trennzeichen-Argument:

    Die Funktion join($parameters.ports, '-') gibt 81-82-83 zurück.

  • Ohne Trennzeichen-Argument:

    Die Funktion join($parameters.ports) gibt 818283 zurück.

split()

Die Funktion split() teilt eine Eingabezeichenfolge in mehrere Listen auf, abhängig von den angegebenen Trennzeichen. Wenn kein oder ein leeres ('') Trennzeichen angegeben ist, betrachtet diese Funktion ein Leerzeichen als Trennzeichen und teilt die Zeichenfolge in Listen auf.

Beispiele:

• Die Funktion split('Example_string_split', 's') gibt ['Example_','tring_','plit'] zurück.

• Die Funktion split('Example string split') gibt ['Example','string','split'] zurück.

• Die Funktion split('Example string split', '') gibt ['Example','string','split'] zurück.

• Die Funktion split('Example string') gibt ['Example','string'] zurück.

  Diese Funktion betrachtet aufeinanderfolgende Leerzeichen als ein einziges Leerzeichen.

map()

Die Funktion map() akzeptiert zwei Argumente;

Argument 1: Eine beliebige Funktion

Argument 2: Eine Liste von Elementen.

Die Funktion gibt eine Liste zurück, wobei jedes Element in der Liste das Ergebnis der Anwendung der Funktion map() (Argument 1) auf das entsprechende Element in Argument 2 ist.

Zulässige Funktionen in Argument 1:

• Integrierte Funktionen, die ein Argument akzeptieren:

  base64.encode, base64.decode, bin, bool, exists, hex, int, ip, len, lower, upper, oct, quotewrap, str, trim, upper, url.encode, url.decode

• Substitutionsfunktionen, die mindestens ein Argument akzeptieren.

Beispiel:

Angenommen, $parameters.nums ist [81, 82, 83].

• Map mit einer integrierten Funktion, str

  Die Funktion map(str, $parameters.nums) gibt ["81", "82", "83"] zurück.

  Das Ergebnis der Map-Funktion ist eine Liste von Zeichenfolgen, wobei jedes Element durch Anwenden der str-Funktion auf das entsprechende Element in der Eingabeliste ($parameters.nums) berechnet wird.

• Map mit einer Substitutionsfunktion

  • Substitutionen:

    add-10(port): $port + 10

  • Ausdruck:

    Die Funktion map($substitutions.add-10, $parameters.nums) gibt eine Liste von Zahlen zurück: [ 91, 92, 93 ]

Das Ergebnis dieser Map-Funktion ist eine Liste von Zahlen. Jedes Element wird durch Anwenden der Substitutionsfunktion $substitutions.add-10 auf das entsprechende Element in der Eingabeliste ($parameters.nums) berechnet.

quotewrap()

Die Funktion quotewrap() akzeptiert eine Zeichenfolge als Argument und gibt eine Zeichenfolge zurück, nachdem ein doppeltes Anführungszeichen vor und nach dem Eingabewert hinzugefügt wurde.

Beispiel:

Die Funktion quotewrap("ADM") gibt "mas" zurück.

replace()

Die Funktion replace() akzeptiert drei Argumente:

Argument 1: Eine string oder Liste der folgenden integrierten Typen:

• string
• number
• ipaddress
• TCP-Port
• boolean

Argument 2: Ein einzelner Wert oder eine Liste von Werten, deren Typ mit dem in Argument 1 angegebenen Typ übereinstimmt

Argument 3: Ein einzelner Wert desselben Typs wie in Argument 1 angegeben (optional)

Die Funktion replace() ersetzt alle Vorkommen von Argument 2 durch Argument 3 in Argument 1.

Wenn Argument 3 nicht angegeben ist, werden alle Vorkommen von Argument 2 aus Argument 1 entfernt.

Beispiel:

• Die Funktion replace('abcdef', 'def', 'xyz') gibt abcxyz zurück.

  Alle Vorkommen von def werden durch xyz ersetzt.

• replace('abcdefabc', 'def') gibt abcabc zurück.

  Da kein Argument 3 vorhanden ist, wird def aus der resultierenden Zeichenfolge entfernt.

• Die Funktion replace('An#example@to%replace!characters', ['@', '#', '!', '%'], '_') gibt An_example_to_replace_characters zurück.

  Die Ausgabezeichenfolge enthält Unterstriche (_) anstelle der in ['@', '#', '!', '%'] angegebenen Zeichen.

• Die Funktion replace([10.10.10.1, 10.10.10.2, 10.10.10.3, 10.10.10.4], [10.10.10.2, 10.10.10.4]) gibt [10.10.10.1, 10.10.10.3] zurück.

  Da kein Argument 3 vorhanden ist, werden 10.10.10.2 und 10.10.10.4 aus der resultierenden Liste der IP-Adressen entfernt.

• Die Funktion replace([8080, 8081, 8082, 8083, 8084], 8083, 80) gibt [8080, 8081, 8082, 80, 8084] zurück.

  Alle Vorkommen von 8083 werden durch 80 ersetzt.

trim()

Die Funktion trim() gibt eine Zeichenfolge zurück, bei der führende und nachgestellte Leerzeichen aus der Eingabezeichenfolge entfernt wurden.

Beispiel:

Die Funktion trim(' abc ') gibt abc zurück.

truncate()

Die Funktion truncate() akzeptiert zwei Argumente:

Argument 1: Zeichenfolge

Argument 2: Zahl

Die Funktion gibt eine Zeichenfolge zurück, bei der die Eingabezeichenfolge in Argument 1 auf die durch Argument 2 angegebene Länge gekürzt wird.

Beispiel:

Die Funktion truncate('NetScaler Console', 6) gibt Citrix zurück.

distinct()

Die Funktion distinct() extrahiert eindeutige Elemente aus einer Listeneingabe.

Beispiele: Wenn $parameters.input_list ['ADM', 'ADC', 'VPX', 'ADC', 'ADM', 'CPX'] ist, gibt die Funktion distinct($parameters.input_list) ['ADM', 'ADC', 'VPX', 'CPX'] zurück.

url.encode()

Die Funktion url.encode() gibt eine Zeichenfolge zurück, bei der Zeichen gemäß RFC 3986 unter Verwendung des ASCII-Zeichensatzes transformiert werden.

Beispiel:

Die Funktion url.encode("a/b/c") gibt a%2Fb%2Fc zurück.

url.decode()

Die Funktion url.decode() gibt eine Zeichenfolge zurück, bei der das URL-kodierte Argument gemäß RFC 3986 in eine reguläre Zeichenfolge dekodiert wird.

Beispiel:

Die Funktion url.decode("a%2Fb%2Fc") gibt a/b/c zurück.

is-ipv4()

Die Funktion is-ipv4() akzeptiert eine IP-Adresse als Argument und gibt den booleschen Wert True zurück, wenn die IP-Adresse im IPv4-Format vorliegt.

Die Funktion is-ipv4(10.10.10.10) gibt True zurück.

is-ipv6()

Die Funktion is-ipv6() akzeptiert eine IP-Adresse als Argument und gibt den booleschen Wert True zurück, wenn die IP-Adresse im IPv6-Format vorliegt.

Die Funktion is-ipv6(2001:DB8::) gibt True zurück.

startswith()

Die Funktion startswith() bestimmt, ob eine Zeichenfolge mit einem bestimmten Präfix beginnt. Diese Funktion erfordert zwei obligatorische Zeichenfolgenargumente.

startswith(str, sub_str)

Diese Funktion gibt True zurück, wenn die Zeichenfolge (str) mit der Unterzeichenfolge (sub_str) beginnt.

Beispiele:

• Die Funktion startswith('Citrix', 'Ci') gibt True zurück.
• Die Funktion startswith('Citrix', 'iC') gibt False zurück.
• Die Funktion startswith('Citrix', 'Ab') gibt False zurück.

endswith()

Die Funktion endswith() bestimmt, ob eine Zeichenfolge mit einem bestimmten Suffix endet. Diese Funktion erfordert zwei obligatorische Zeichenfolgenargumente.

endswith(str, sub_str)

Diese Funktion gibt True zurück, wenn die Zeichenfolge (str) mit der Unterzeichenfolge (sub_str) endet.

Beispiele:

• Die Funktion endswith('Citrix', 'ix') gibt True zurück.
• Die Funktion endswith('Citrix', 'Ix') gibt False zurück.
• Die Funktion endswith('Citrix', 'ab') gibt False zurück.

contains()

Die Funktion contains() bestimmt, ob eine Zeichenfolge eine bestimmte Unterzeichenfolge enthält. Diese Funktion erfordert zwei obligatorische Zeichenfolgenargumente.

contains(str, sub_str)

Diese Funktion gibt True zurück, wenn die Unterzeichenfolge (sub_str) irgendwo innerhalb der Zeichenfolge (str) enthalten ist.

Beispiel:

• Die Funktion contains('Citrix', 'tri') gibt True zurück.
• Die Funktion contains('Citrix', 'Ci') gibt True zurück.
• Die Funktion contains('Citrix', 'ti') gibt False zurück.

substring()

Verwenden Sie die Funktion substring(), um eine Unterzeichenfolge aus einer Zeichenfolge zu extrahieren.

substring(str, start_index, end_index)

Diese Funktion erfordert die zwei obligatorischen Argumente und ein optionales Ganzzahlargument.

• str (Obligatorisch)
• start_index (Obligatorisch)
• end_index (Optional)

Diese Funktion gibt die Unterzeichenfolge aus der Zeichenfolge (str) zurück, die sich zwischen den angegebenen Indexpositionen befindet. Wenn Sie die Endindexposition nicht angeben, extrahiert die Funktion die Unterzeichenfolge vom Startindex bis zum Ende der Zeichenfolge.

Hinweis

Wenn Sie end_index angeben, schließt die Unterzeichenfolge das Zeichen an der Position end_index aus.

Beispiel:

• Die Funktion substring('Citrix', 2) gibt trix zurück.

• Die Funktion substring('Citrix', 10) gibt (") zurück.

  In diesem Beispiel gibt die Funktion eine leere Zeichenfolge zurück, da sie eine ungültige start_index-Position hat.

• Die Funktion substring('Citrix', 2, 4) gibt tr zurück.

  In diesem Beispiel extrahiert die Funktion die Zeichen zwischen den Indexpositionen 2 und 4.

• Die Funktion substring('Citrix', -3) gibt rix zurück.

  Wenn Sie Zeichen extrahieren möchten, die sich am Ende der Zeichenfolge befinden, geben Sie einen negativen Wert für das Argument start_index an.

  In diesem Beispiel extrahiert die Funktion die Unterzeichenfolge, die die letzten drei Zeichen in der Zeichenfolge enthält.

multiple()

Die Funktion multiple() akzeptiert zwei Argumente:

Argument 1: Eine number, string, boolean, ipaddress, TCP-Port oder password

Argument 2: Eine number

Die Funktion multiple(argument1, argument2) gibt eine Liste mit vielen Kopien von Argument 1 zurück. Die Anzahl der Kopien entspricht der Zahl, die an Argument 2 übergeben wurde.

Beispiele:

• Die Funktion multiple(10.10.10.10, 3) gibt [10.10.10.10, 10.10.10.10, 10.10.10.10] zurück.

• Die Funktion multiple(8080, 4) gibt [8080, 8080, 8080, 8080] zurück.

reverse()

Die Funktion reverse() akzeptiert eine Liste von Elementen als Argument und gibt eine Liste mit denselben Elementen, aber in umgekehrter Reihenfolge zurück.

Das Argument kann eine Liste der folgenden integrierten Typen sein:

• string
• number
• ipaddress
• ipnetwork
• TCP-Port
• boolean
• password
• object
• file
• certfile
• keyfile
• certkey

Beispiele:

• reverse([10.102.20.1, 10.102.20.2, 10.102.20.3]) gibt [10.102.20.3, 10.102.20.2, 10.102.20.1] zurück.
• reverse([80,81,82,81]) gibt [81,82,81,80] zurück.
• reverse(['app-mx','app-cx','conf-27','app3']) gibt ['app3','conf-27','app-cx','app-mx'] zurück.