4D v16.3

CREATE SET FROM ARRAY

Accueil

 
4D v16.3
CREATE SET FROM ARRAY

CREATE SET FROM ARRAY 


 

CREATE SET FROM ARRAY ( laTable ; tabEnrg {; nomEnsemble} ) 
Paramètre Type   Description
laTable  Table in Table de l’ensemble
tabEnrg  Entier long, Tableau booléen in 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  Chaîne in Nom de l’ensemble à créer, ou Appliquer la commande à l’ensemble Userset si ce paramètre est omis ou vide

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.

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.



Voir aussi  

BOOLEAN ARRAY FROM SET
CREATE SELECTION FROM ARRAY
Identifiants

 
PROPRIÉTÉS 

Produit : 4D
Thème : Ensembles
Numéro : 641

Cette commande modifie la variable système ErrorCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Modifié : 4D v6.7

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)