Fonction de script : Ajoute une ligne à une séquence de données spécifique.
Syntaxe
PUT_PROCESS_LINE (Data sequence, Row [ , Delimiter ])
|
Syntaxe |
Description / format |
|---|---|
|
Data sequence |
Séquence de données à laquelle une ligne doit être ajoutée. |
| Row |
Ligne à ajouter à la séquence de données Vous pouvez aussi spécifier un tableau de script. |
|
Delimiter |
Caractère quelconque qui divise la ligne spécifiée en colonnes. Si un tableau a été spécifié pour Row, ce paramètre n'a aucun effet. |
|
Code retour |
|---|
|
"0" : la séquence de données a été étendue avec succès par la ligne mentionnée. |
Cette fonction de script ajoute une ligne à la séquence de données. La séquence de données est alors directement modifiée, le code retour indique uniquement si l'ajout de la ligne a pu être réalisé correctement. Spécifiez la référence de la séquence de données et la ligne qui doit être ajoutée.
Les séquences de données peuvent être créées avec l'élément de script CREATE_PROCESS ou avec les fonctions PREP_PROCESS*.
Assurez-vous de spécifier une séquence de données existante ou qui n'a pas encore été fermée via :CLOSE_PROCESS. Sinon, une erreur d'exécution se produit. Vous ne pouvez pas utiliser cette fonction de script pour créer une nouvelle séquence de données.
La ligne à ajouter peut être spécifiée sous la forme d'une chaîne de caractères (littéral de script ou variable de script) ou d'un tableau de script (variable de script). Si vous utilisez une chaîne de caractères, un séparateur peut être spécifié pour la diviser en plusieurs colonnes. Si aucun séparateur n'est spécifié, la nouvelle ligne dispose d'une seule colonne qui contient toute la chaîne.
Si vous spécifiez un tableau de script, il est automatiquement réparti en colonnes selon ses éléments. Notez que les éléments vides à la fin du tableau sont ignorés.
Exemples
Dans l'exemple suivant, une séquence de données est créée pour enregistrer une liste de fichiers. Puis un nom de fichier est récupéré dans une variable d'objet et ajouté à la séquence de données.
:SET &HND# = PREP_PROCESS_FILENAME("WIN01","C:\AUTOMIC\temp\test*.txt","Y",,)
:SET &LINE# = GET_VAR(VARA.FILELIST)
:SET &RET# = PUT_PROCESS_LINE(&HND#,&LINE#)
Voir aussi :