System.Variants.VarType
Delphi
function VarType(const V: Variant): TVarType;
C++
extern DELPHI_PACKAGE System::Word __fastcall VarType(const System::Variant &V);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | System.Variants.pas System.Variants.hpp |
System.Variants | System.Variants |
Description
Returns the type code of a specified variant.
VarType returns the type code of the given variant. The resulting value is either the type code for a custom Variant type, or it is constructed from the constants declared in the System unit.
The lower twelve bits of a variant type code (the bits defined by the varTypeMask bit mask) define the type of the variant. The varArray bit is set if the variant is an array of the given type. The varByRef bit is set if the variant is a reference to a value of the given type as opposed to an actual value.
The following table describes the meaning of each of the variant types defined in the System unit:
| Variant Type | Description |
|---|---|
| varEmpty | The variant is Unassigned. |
| varNull | The variant is Null. |
| varAny | Represents a Variant that can hold any value. |
| varSmallint | 16-bit signed integer (type Smallint in Delphi, short in C++). |
| varInteger | 32-bit signed integer (type Integer in Delphi, int in C++). |
| varSingle | Single-precision floating-point value (type Single in Delphi, float in C++). |
| varDouble | Double-precision floating-point value (type double). |
| varCurrency | Currency floating-point value (type Currency). |
| varDate | Date and time value (type TDateTime). |
| varOleStr | Reference to a dynamically allocated UNICODE string. |
| varDispatch | Reference to an Automation object (an IDispatch interface pointer). |
| varError | Operating system error code. |
| varBoolean | 16-bit Boolean (type WordBool). |
| varVariant | Indicates another variant. |
| varUnknown | Reference to an unknown object (an IInterface or IUnknown interface pointer). |
| varShortInt | 8-bit signed integer (type ShortInt in Delphi or signed char in C++). |
| varByte | A Byte. |
| varWord | Unsigned 16-bit value (Word). |
| varLongWord | Unsigned 32-bit value (type LongWord in Delphi or unsigned long in C++). |
| varInt64 | 64-bit signed integer (Int64 in Delphi or __int64 in C++). |
| varStrArg | COM-compatible string. |
| varString | Reference to a dynamically allocated string (not COM-compatible). |
| varArray | Indicates a Variant array. |
| varByRef | Indicates that the variant contains a reference as opposed to a value. |
| varTypeMask | Indicates the type of each array element. |
Note: The code of each variant type is listed on the System unit page (section Constants).
The value returned by VarType corresponds to the VType field of a TVarData record.
The type of a variant can be changed using VarAsType.