GET FIELD PROPERTIES
GET FIELD PROPERTIES ( ptrChp | numTable {; numChamp}; champType {; champLong {; indexé {; unique {; invisible}}}} )
| Paramètre | Type | Description | |
|---|---|---|---|
| ptrChp | numTable | Pointeur, Entier long | 🡒 | Pointeur de champ ou Numéro de table |
| numChamp | Entier long | 🡒 | Numéro de champ si un numéro de table est passé en premier paramètre |
| champType | Entier long | 🡘 | Type de champ |
| champLong | Entier long | 🡘 | 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 GET FIELD PROPERTIES retourne des informations sur le champ désigné par numTable et numChamp ou par ptrChp.
Vous pouvez soit passer :
- les numéros de table et de champ dans numTable et numChamp
- ou un pointeur vers le champ dans ptrChp.
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 4D (thème Types champs et variables) :
| Constante | Type | Valeur |
| ------------------ | ----------- | ------ |
| Is alpha field | Entier long | 0 |
| Is BLOB | Entier long | 30 |
| Is Boolean | Entier long | 6 |
| Is date | Entier long | 4 |
| Is float | Entier long | 35 |
| Is integer | Entier long | 8 |
| Is integer 64 bits | Entier long | 25 |
| Is longint | Entier long | 9 |
| Is object | Entier long | 38 |
| Is picture | Entier long | 3 |
| Is real | Entier long | 1 |
| Is subtable | Entier long | 7 |
| Is text | Entier long | 2 |
| Is time | Entier long | 11 | - Le paramètre champLong retourne la longueur du champ si celui-ci est de type Alpha (ce qui signifie que vous obtenez *champType=*Is alpha field). 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.
- 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...).
Exemple 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 :
GET FIELD PROPERTIES(1;3;vType;vLong;vIndex;vUnique;vInvisible)
Exemple 2
L'exemple suivant récupère dans les variables vType, vLong, vIndex, vUnique et vInvisible les propriétés du champ [Table3]Champ2 :
GET FIELD PROPERTIES(->[Table3]Champ2;vType;vLong;vIndex;vUnique;vInvisible)