GET_PROCESS_INFO

Fonction de script : Extrait les informations d'une séquence de données.

Syntaxe

GET_PROCESS_INFO (Data sequence, Information [ , Row ])

Syntaxe	Description / format
Data sequence	Référence à la séquence de données dont les informations doivent être lues. Format : variable de script
Information	Informations spécifiques à extraire Format : nom AE Valeurs autorisées : INDEX : position actuelle de la boucle de traitement dans laquelle la séquence de données est utilisée. COLUMNS : nombre de colonnes de la ligne spécifiée. Si aucune ligne n'est spécifiée, c'est la ligne actuelle (uniquement si elle est utilisée dans des boucles de traitement) ou la première ligne qui est utilisée. ROWS : nombre de lignes de la séquence de données
Row	Ligne dont le numéro de colonne doit être déterminé. Format : Nombre sans guillemets, littéral de script ou variable de script. Ce paramètre ne peut être spécifié que si le nombre de colonnes est demandé (Informations = COLUMNS).

Code retour
Informations de la séquence de données

Cette fonction de script vous permet d'extraire des informations générales (telles que le nombre de colonnes ou de lignes) sur les séquences de données. Pour cela, vous devez spécifier la référence de la séquence de données et les informations à lire.

Lorsque le nombre de colonnes doit être lu, vous pouvez également spécifier la ligne correspondante. Si aucune ligne n'est donnée, la ligne utilisée dépend de l'utilisation de l'élément de script :

• La fonction de script est utilisée dans une boucle de traitement : Ligne à laquelle la boucle accède actuellement.
• La fonction de script est utilisée en dehors d'une boucle de traitement : Première ligne

L'information INDEX stipule que la fonction est utilisée à l'intérieur d'une boucle de traitement. Dans ce cas, c'est le numéro de la ligne à laquelle la boucle accède actuellement qui est extrait.

Lorsque le nombre de lignes est lu, il n'y a pas de dépendances spéciales.

Notez que la séquence de données spécifiée doit exister et ne doit pas être fermée par l'élément :CLOSE_PROCESS. Sinon, une erreur d'exécution se produit.

Exemples

L'exemple suivant illustre la création d'une séquence de données renseignée avec les entrées d'un objet Variable. Le nombre de colonnes est ensuite déterminé pour chaque ligne et écrit dans le rapport d'activation.

:SET &HND# = PREP_PROCESS_VAR(VARA.SQL,"*WIN*")
:SET &LNR# = GET_PROCESS_INFO(&HND#, ROWS)

:PROCESS &HND#
:SET &IND# = GET_PROCESS_INFO(&HND#,INDEX)
:SET &COL# = GET_PROCESS_INFO(&HND#,COLUMNS,&IND#)
:PRINT "Line &IND# / &LNR# has &COL# columns"
:ENDPROCESS

:CLOSE_PROCESS &HND#

Voir aussi :