STR_PAD

Script-Funktion: Erweitert eine Zeichenfolge auf eine bestimmte Länge.

Syntax

STR_PAD (String, [Character], Total length, Alignment)

Syntax	Beschreibung/Format
String	Zeichenfolge, die erweitert werden soll. Format: Script-Literal oder Script-Variable
Character	Beliebiges Zeichen, das für die Erweiterung verwendet wird. Format: AE-Name, Script-Literal oder Script-Variable Standardwert: ein Leerzeichen
Total length	Die Länge, auf die die Zeichenfolge erweitert werden soll. Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable
Alignment	Die Position der Zeichenfolge. Format: Script-Literal oder Script-Variable Erlaubte Werte: „LEFT“ - Die Zeichenfolge wird links positioniert. „RIGHT“ - Die Zeichenfolge wird rechts positioniert. „CENTER“ - Die Zeichenfolge wird in der Mitte positioniert.

Rückgabewerte
Die erweiterte Zeichenkette.

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

Weiters kann definiert werden, wie die Zeichenfolge im Ergebnis angeordnet sein soll (Parameter Alignment). Die möglichen Werte sind LEFT, RIGHT und CENTER.
Bei CENTER werden links und rechts von der Zeichenfolge so viele Zeichen platziert, dass die gewünschte Länge erreicht wird. Bei einer ungeraden Anzahl von aufzufüllenden Zeichen, wird rechts von der Zeichenfolge ein Zeichen mehr als links eingefügt.

Beispiele

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

:SET &STRING# = "String for Scripting"
:SET &STRLEN# = 31
: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#

Das folgende Ergebnis wird im Aktivierungsreport ausgegeben:

String for Scripting...........
+++++String for Scripting++++++   
___________String for Scripting

Siehe auch: