STR_PAD

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

Syntaxe

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

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

Codes retour
La chaîne de caractères étendue

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

Vous pouvez aussi définir l'ordre dans lequel la chaîne de caractères doit être affichée dans le résultat (paramètre Alignment). Le positionnement peut se faire LEFT, RIGHT ou CENTER.
En cas de position au CENTER, des caractères sont placés à droite et à gauche de la chaîne de caractères afin d'atteindre la longueur souhaitée. Si le nombre de caractères requis pour étendre la chaîne est impair, un caractère supplémentaire est inséré à droite de la chaîne.

Exemples

Dans l'exemple suivant, la même chaîne de caractères augmente de trois façons différentes et le résultat s'affiche dans le rapport d'activation.

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

Le résultat suivant est écrit dans le rapport d'activation :

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

Voir aussi :