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

STR_CUT, MID, SUBSTR

Fonctions de script : copie des caractères d'une chaîne de caractères.

Syntaxe

STR_CUT(String, Start, [Length])
MID(String, Start, [Length])
SUBSTR(String, Start, [Length])

Syntaxe	Description / format
Chaîne de caractères	Chaîne de caractères alphanumérique Format : littéral de script ou variable de script
Début	Position à partir de laquelle les caractères sont copiés. Format : nombre sans guillemets ou variable de script
Longueur	Nombre de caractères qui doivent être copiés. Format : nombre sans guillemets ou variable de script

Code retour
Partie d'une chaîne de caractères

Remarques

Ces fonctions de script fonctionnent de la même façon. Elles copient les caractères d'une chaîne de caractères donnée. La longueur est un paramètre facultatif. Si elle n'est pas indiquée, tous les caractères jusqu'à la fin de la chaîne de caractères sont retournés.

La chaîne de caractères elle même reste inchangée.

Exemples

Dans le premier exemple, la fonction de script retourne "CD" . Le résultat du deuxième exemple est "CDEFGH", la chaîne de caractères copiée jusqu'à la fin.

:SET &STRING# = MID("ABCDEFGH",3,2)

:SET &STRING# = SUBSTR("ABCDEFGH",3)

L'exemple suivant utilise la fonction de script SUBSTR pour diviser un terme défini par l'utilisateur. Les trois premiers caractères sont attribués à la première variable de script et le dernier caractère à la deuxième variable de script.

:READ &TABNAME#, "04", "Please specify table name xxxy"
:SET &TABPRE# = SUBSTR(&TABNAME#,1,3)
:SET &TABSUF# = SUBSTR(&TABNAME#,4,1)

Rubriques connexes :

Elément de script	Description
STR_SUBSTITUTE	Remplace des caractères ou une chaîne de caractères dans une chaîne de caractères.
STR_CAT	Combine deux chaînes de caractères en une troisième.

Eléments de script - Chaînes de caractères

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