version 6.7 (Modifiée)
CREER ENSEMBLE SUR TABLEAU (table; tabEnrg{; nomEns})
Paramètre | Type | Description | |
table | Table | Table de l'ensemble | |
tabEnrg | Tab Entier long | Booléen | 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) | |||
nomEns | Alpha | Nom de l'ensemble à créer, ou | |
Appliquer la commande à l'ensemble Userset | |||
si ce paramètre est omis ou vide |
Description
La commande CREER ENSEMBLE SUR TABLEAU crée l'ensemble nomEns à partir :
soit du tableau de numéros d'enregistrements absolus tabEnrg de la table table,
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 nomEns.
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 nomEns. 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 nomEns. 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 nomEns ou si vous passez une chaîne vide, la commande s'applique à l'ensemble système Userset.
Référence
CREER SELECTION SUR TABLEAU, Nommer les objets du langage 4D, TABLEAU BOOLEEN SUR ENSEMBLE.
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.