System.Variants.VarType

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function VarType(const V: Variant): TVarType;

C++

extern DELPHI_PACKAGE System::Word __fastcall VarType(const System::Variant &V);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Variants.pas
System.Variants.hpp
System.Variants System.Variants

Description

Renvoie le code du type du variant spécifié.

La fonction VarType renvoie le code du type du variant donné. La valeur résultante est le code de type d'un Variant personnalisé ou elle est construite à partir des constantes déclarées dans l'unité System.

Un type variant est défini par les douze bits de poids faible de son code (spécifiés par le masque binaire varTypeMask). Le bit varArray est positionné si le variant est un tableau du type spécifié. Le bit varByRef est positionné si le variant est une référence à une valeur du type spécifié et non une valeur réelle.

Le tableau suivant décrit la signification des codes de type de variant définis dans l'unité System :

Type de variant Description
varEmpty Le variant n'est pas assigné (Unassigned).
varNull Le variant est Null.
varAny Représente un Variant qui peut contenir n'importe quelle valeur.
varSmallint Entier signé sur 16 bits (type Smallint dans Delphi, short dans C++ ).
varInteger Entier signé sur 32 bits (type Integer dans Delphi, int dans C++).
varSingle Valeur à virgule flottante à simple précision (type Single dans Delphi, float dans C++).
varDouble Valeur à virgule flottante en double précision (type double).
varCurrency Valeur à virgule flottante monétaire (type Currency).
varDate Valeur date et heure (type TDateTime).
varOleStr Référence à une chaîne UNICODE allouée dynamiquement.
varDispatch Référence à un objet Automation (un pointeur d'interface IDispatch).
varError Code d'erreur du système d'exploitation.
varBoolean Booléen sur 16 bits (type WordBool).
varVariant Indique un autre variant.
varUnknown Référence à un objet inconnu (un pointeur d'interface IUnknown ou IInterface).
varShortInt Entier signé sur 8 bits (type ShortInt dans Delphi, signed char dans C++).
varByte Un octet.
varWord Valeur sur 16 bits non signée (Word).
varLongWord Valeur sur 32 bits non signée (type LongWord dans Delphi, unsigned long dans C++).
varInt64 Entier signé sur 64 bits (Int64 dans Delphi, __int64 dans C++).
varStrArg Chaîne compatible COM.
varString Référence à une chaîne allouée dynamiquement (non compatible COM).
varArray Indique un tableau Variant.
varByRef Indique que le variant contient une référence et non une valeur.
varTypeMask Indique le type de chaque élément de tableau.

Remarque : Le code de chaque type de variant est listé sur la page de l'unité System (section Constantes).

La valeur renvoyée par VarType correspond au champ VType d'un enregistrement TVarData.

Le type d'un variant peut être modifié en utilisant la fonction VarAsType.

Voir aussi