Automation Engine Script-Leitfaden > Funktionelle Gliederung > Strings > STR_PAD

STR_PAD

Script-Funktion: Vergleicht zwei Zeichenketten

Syntax

STR_PAD(String, [Zeichen], Total Length, Position)

Syntax	Beschreibung/Format
Zeichenkette	Zeichenkette, die erweitert werden soll. Format: Script-Literal oder Script-Variable
Zeichen	Beliebiges Zeichen, das für die Erweiterung verwendet wird. Format: AE-Name, Script-Literal oder Script-Variable Standardwert: ""
Gesamtlänge	Länge, auf welche die Zeichenkette erweitert werden soll. Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable
Ausrichtung	Position der Zeichenkette. Format: Script-Literal oder Script-Variable Erlaubte Werte: "LEFT" - Zeichenkette wird links angeordnet "RIGHT" - Zeichenkette wird rechts angeordnet "CENTER" - Zeichenkette wird mittig angeordnet

Rückgabewerte
Erweiterte Zeichenkette

Anmerkungen

Die Script-Funktion vergrößert eine Zeichenkette auf eine bestimmte Länge. Für die Erweiterung wird dabei jenes Zeichen verwendet, das beim Parameter Zeichen angegeben ist. Standardmäßig wird der neue Platz mit Leerzeichen aufgefüllt.

Weiters kann definiert werden, wie die Zeichenkette im Ergebnis angeordnet sein soll (Parameter Ausrichtung). Möglich ist dabei rechts, links oder mittig.
Bei mittiger Anordnung werden links und rechts von der Zeichenkette so viele Zeichen platziert, dass die gewünschte Länge erreicht wird. Bei einer ungeraden Anzahl von aufzufüllenden Zeichen, wird rechts vom String ein Zeichen mehr eingefügt.

Beispiele

Folgendes Beispiel vergrößert die selbe Zeichenkette auf 3 unterschiedliche Arten und gibt das Ergebnis im Aktivierungsprotokoll aus.

:SET &STRING# = "UC4 String"
:SET &STRLEN# = 15
:SET &STRNEW# = STR_PAD(&STRING#, ".", &STRLEN#, "LEFT")
:PRINT &STRNEW#
:SET &STRNEW# = STR_PAD(&STRING#,, &STRLEN#, "CENTER")
:PRINT &STRNEW#
:SET &STRNEW# = STR_PAD(&STRING#, "_", &STRLEN#, "RIGHT")
:PRINT &STRNEW#

Ergebnis im Aktivierungsprotokoll:

UC4 String.....
UC4 String
_____UC4 String

Siehe auch:

Script-Sprachmittel	Beschreibung
STR_SPLIT	Zeichenkette mit Hilfe eines Trennzeichens in mehrere Teile aufspalten.

Script-Sprachmittel - Aktivierungsdaten

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support