Manuel des Scripts Automation Engine > Organisation fonctionnelle > Chaînes de caractères > STR_PAD

STR_PAD

Fonction de script : Elargir une chaîne de caractères à une longueur définie.

Syntaxe

STR_PAD(String, [Caractère], Total Length, Position)

Syntaxe	Description / format
Chaîne de caractères	Chaîne de caractères devant être étendue. Format : littéral de script ou variable de script
Caractère	Caractère quelconque utilisé pour l'extension. Format : Nom AE, littéral de script ou variable de script Valeur par défaut : " "
Longueur totale	Longueur d'extension de la chaîne de caractères. Format : littéral de script, nombre sans guillemets ou variable de script
Ajustement	Ajustement de la chaîne de caractères Format : littéral de script ou variable de script Valeurs autorisées : "LEFT" - Chaîne de caractères ajustée à gauche "RIGHT" - Chaîne de caractères située à droite "CENTER" - Chaîne de caractères positionnée au centre

Codes retour
Chaîne de caractères étendue

Commentaires

La fonction de script étend la chaîne de caractères à une certaine longueur. Le caractère défini dans le paramètre Caractère est utilisé pour l'extension. Par défaut, le nouvel espace est complété avec des espaces vides.

En outre, il est possible de définir l'ajustement de la chaîne de caractères dans le résultat (paramètre Position). L'ajustement peut se faire à droite, à gauche ou au centre.
En cas d'ajustement au centre, des caractères sont placés à droite et à gauche de la chaîne de caractères afin d'atteindre la longueur souhaitée. En cas de nombre impair de caractères de remplissage, un caractère supplémentaire est inséré à droite de la chaîne.

Exemples

L'exemple suivant étend la même chaîne de caractères selon 3 types différents et affiche le résultat dans le protocole d'activation.

: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#

Résultat dans le protocole d'activation :

UC4 String.....
UC4 String
_____UC4 String

Rubriques connexes :

Elément de script	Description
STR_SPLIT	Séparer la chaîne de caractères en plusieurs parties à l'aide d'un séparateur.

Eléments de script - Données d'activation

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle