STR_PAD

Verwenden Sie die Script-Funktion STR_PAD, um einen String auf eine bestimmte Länge zu vergrößern. Dazu müssen Sie eine festgelegte Anzahl von Zeichen auf der rechten Seite, auf der linken Seite oder auf beiden Seiten des Strings hinzufügen.

Syntax

STR_PAD (String, [Zeichen], Gesamtlänge, Ausrichtung)

Parameter

• STR_PAD
  Erweitert einen String auf eine bestimmte Länge

• String
  String, der erweitert werden soll.
  Format: Script-Literal oder Script-Variable
• Zeichen
  (Optional) Ein Zeichen, das verwendet werden soll, um den String zu verlängern
  Format: AE-Name, Script-Literal oder Script-Variable
  Standardwert: ein Leerzeichen (" ")
• Gesamtlänge
  Die Länge, die der String schließlich haben soll.
  Format: Eine beliebige Zahl, die Sie ohne Anführungszeichen angeben, ein Script-Literal oder eine Script-Variable
• Ausrichtung
  Definiert, wo der ursprüngliche String positioniert wird
  Zulässige Werte:
  • LEFT
    Der String befindet sich auf der linken Seite und die zusätzlichen Zeichen auf der rechten Seite.
  • RIGHT
    Der String befindet sich auf der rechten Seite und die zusätzlichen Zeichen auf der linken Seite.
  • CENTER
    Der String befindet sich mittig, und die zusätzlichen Zeichen werden auf der linken und rechten Seite des Strings gleichmäßig verteilt. Wenn die Anzahl der hinzuzufügenden Zeichen nicht geradzahlig ist, enthält die Position auf der rechten Seite des Strings ein Zeichen mehr.

Rückgabewert: der erweiterte String

Beispiele

Im folgenden Beispiel werden drei Möglichkeiten zum Erweitern eines Strings mit 20 Zeichen auf eine endgültige Länge von 31 Zeichen angezeigt. Das Ergebnis wird in den Aktivierungsreport ausgegeben.

: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 für das Scripting...........
+++++++String für das Scripting+++++++
________________ String für das Scripting

Siehe auch: