version 6.7.1 (Modifiée)
LIRE PROPRIETES CHAMP (chpPtr | tableNum{; champNum}; champType{; champLong{; indexé{; unique{; invisible}}}})
Paramètre | Type | Description | |
chpPtr | tableNum | Pointeur | Num | Pointeur de champ ou Numéro de table | |
champNum | Numérique | Numéro de champ si un numéro de table est | |
passé en premier paramètre | |||
champType | Numérique | Type de champ | |
champLong | Numérique | Longueur du champ (si alphanumérique) | |
indexé | Booléen | Vrai = Indexé, Faux = Non indexé | |
unique | Booléen | Vrai = Unique, Faux = Non unique | |
invisible | Booléen | Vrai = Invisible, Faux = Visible |
Description
La commande LIRE PROPRIETES CHAMP retourne des informations sur le champ désigné par tableNum et champNum ou par chpPtr.
Vous pouvez soit passer :
les numéros de table et de champ dans tableNum et champNum
ou un pointeur vers le champ dans chpPtr.
Après l'appel :
Le paramètre champType retourne le type du champ. Le paramètre variable champType reçoit l'une des valeurs prédéfinies par les constantes de 4e Dimension :
Constante | Type | Valeur |
Est un champ alpha | Entier long | 0 |
Est un texte | Entier long | 2 |
Est un numérique | Entier long | 1 |
Est un entier | Entier long | 8 |
Est un entier long | Entier long | 9 |
Est une date | Entier long | 4 |
Est une heure | Entier long | 11 |
Est un booléen | Entier long | 6 |
Est une image | Entier long | 3 |
Est une sous table | Entier long | 7 |
Est un BLOB | Entier long | 30 |
Le paramètre champLong retourne la longueur du champ si celui-ci est de type Alpha (ce qui signifie que vous obtenez champType=Est un champ alpha). La valeur de champLong n'est pas significative pour les autres types de champ.
Le paramètre indexé retourne Vrai si le champ est indexé, Faux sinon. La valeur de indexé est significative pour les champs de type Alphanumérique, Entier, Entier long, Réel, Date, Heure et Booléen.
Le paramètre unique retourne Vrai si le champ dispose de l'attribut "Unique", Faux sinon. L'attribut Unique ne peut être appliqué qu'aux champs indexés.
Le paramètre invisible retourne Vrai si le champ dispose de l'attribut "Invisible", Faux sinon. L'attribut Invisible permet de masquer le champ dans les éditeurs standard de 4D (étiquettes, graphes...).
Exemples
(1) Dans l'exemple suivant, les variables vType, vLong, vIndex, vUnique et vInvisible prennent pour valeur les propriétés du troisième champ de la première table :
LIRE PROPRIETES CHAMP(1; 3;vType;vLong;vIndex;vUnique;vInvisible)
(2) L'exemple suivant récupère dans les variables vType, vLong, vIndex, vUnique et vInvisible les propriétés du champ [Table3]Champ2 :
LIRE PROPRIETES CHAMP(->[Table3]Champ2;vType;vLong;vIndex;vUnique;vInvisible)
Référence
Champ, FIXER INDEX, Nom du champ.