CREER SELECTION SUR TABLEAU

4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 6.7 (Modifiée)


CREER SELECTION SUR TABLEAU (table; tabEnrg{; tempo})

ParamètreTypeDescription
tableTableTable de la sélection
tabEnrgTab Entier long | BooléenTableau 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)
tempoAlphaNom de la sélection temporaire à créer, ou
Appliquer la commande à la sélection courante si
ce paramètre est omis ou vide

Description

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

Si vous ne passez pas le paramètre tempo ou si vous passez une chaîne vide, la commande s'appliquera à la sélection courante de table, 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 tempo. 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 tempo. 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 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.

Référence

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

Gestion des erreurs

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.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant