4D Doc Center : LIRE PROPRIETES CHAMP

4D v14.3

LIRE PROPRIETES CHAMP


LIRE PROPRIETES CHAMP ( 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 LIRE PROPRIETES CHAMP 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 :

Constante	Type	Valeur
Est un BLOB	Entier long	30
Est un booléen	Entier long	6
Est un champ alpha	Entier long	0
Est un entier	Entier long	8
Est un entier 64 bits	Entier long	25
Est un entier long	Entier long	9
Est un float	Entier long	35
Est un numérique	Entier long	1
Est un texte	Entier long	2
Est une date	Entier long	4
Est une heure	Entier long	11
Est une image	Entier long	3
Est une sous table	Entier long	7

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.
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 :

LIRE PROPRIETES CHAMP(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 :

LIRE PROPRIETES CHAMP(->[Table3]Champ2;vType;vLong;vIndex;vUnique;vInvisible)