CREATE SET FROM ARRAY
CREATE SET FROM ARRAY ( laTable ; tabEnrg {; nomEnsemble} )
| Paramètre | Type | Description | |
|---|---|---|---|
| laTable | Table | → | Table de l’ensemble |
| tabEnrg | Integer, Boolean array | → | Tableau de n° d’enregistrements, ou Tableau de booléens (Vrai = l’enregistrement est dans l’ensemble, Faux = il n’est pas dans l’ensemble) |
| nomEnsemble | Text | → | Nom de l’ensemble à créer, ou Appliquer la commande à l’ensemble Userset si ce paramètre est omis ou vide |
Description
La commande CREATE SET FROM ARRAY crée l’ensemble nomEnsemble à partir :
- soit du tableau de numéros d’enregistrements absolus tabEnrg de laTable,
- soit du tableau de booléens tabEnrg ; dans ce cas, les valeurs du tableau indiquent l’appartenance (VRAI) ou non (FAUX) de chaque enregistrement de table à l’ensemble nomEnsemble.
Lorsque vous utilisez la commande avec un tableau d’entiers longs, tous les numéros du tableau représentent la liste des numéros d’enregistrements qui feront partie de l’ensemble nomEnsemble. Si un numéro est invalide (enregistrement non créé), l’erreur -10503 est générée.
Lorsque vous utilisez la commande avec un tableau de booléens, le Nième élément du tableau représente l’intégration (VRAI) ou non (FAUX) de l’enregistrement numéro N à l’ensemble nomEnsemble. En principe, le nombre d’éléments du tableau doit être égal au nombre d’enregistrements de table. Si le tableau est plus petit que le nombre d’enregistrements, seuls les enregistrements définis par le tableau pourront faire partie de l’ensemble.
Note : Avec un tableau de booléens, la commande utilise les éléments à partir du numéro 0 jusqu'au numéro N-1.
Si vous ne passez pas le paramètre nomEnsemble ou si vous passez une chaîne vide, la commande s’applique à l’ensemble système Userset.
Gestion des erreurs
Dans un tableau d'entier longs, si un numéro d'enregistrement est invalide (enregistrement non créé), l’erreur -10503 est générée.