4D v14.3

CREER SELECTION SUR TABLEAU

Accueil

 
4D v14.3
CREER SELECTION SUR TABLEAU

CREER SELECTION SUR TABLEAU 


 

CREER SELECTION SUR TABLEAU ( laTable ; tabEnrg {; nom} ) 
Paramètre Type   Description
laTable  Table in Table de la sélection
tabEnrg  Entier long, Tableau booléen in Tableau de n° d’enregistrements, ou Tableau de booléens (Vrai = l’enregistrement est dans la sélection, Faux = il n’est pas dans la sélection)
nom  Chaîne in Nom de la sélection temporaire à créer, ou Appliquer la commande à la sélection courante si ce paramètre est omis ou vide

La commande CREER SELECTION SUR TABLEAU construit la sélection temporaire nom à 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 laTable à la sélection nom.

Si vous ne passez pas le paramètre nom ou si vous passez une chaîne vide, la commande s’appliquera à la sélection courante de laTable, qui sera donc mise à jour.

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 la sélection nom. Si un numéro est invalide (enregistrement non créé), l’erreur -10503 est générée.

Note : Attention, vous devez veiller à ce que le tableau ne contienne pas d'éléments ayant la même valeur, sinon la sélection résultante sera incorrecte.

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 dans la sélection nom. En principe, le nombre d’éléments du tableau doit être égal au nombre d’enregistrements de laTable. Si le tableau est plus petit que le nombre d’enregistrements, seuls les enregistrements définis par le tableau pourront faire partie de la sélection.

Note : Avec un tableau de booléens, la commande utilise les éléments du numéro 0 au numéro N-1.

Si un numéro d'enregistrement est invalide (enregistrement non créé), l’erreur -10503 est générée. Vous pouvez intercepter cette erreur à l'aide d'une méthode installée par la commande APPELER SUR ERREUR.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Sélections Temporaires
Numéro : 640
Nom intl. : CREATE SELECTION FROM ARRAY

Cette commande modifie la variable système ErrorCette commande change la sélection courante

 
HISTORIQUE 

Modifié : 4D v6.7

 
VOIR AUSSI  

COPIER SELECTION
CREER ENSEMBLE SUR TABLEAU
EFFACER SELECTION
Nommer les objets du langage 4D
TABLEAU ENTIER LONG SUR SELECTION
UTILISER SELECTION

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)