System.Internal.VarHlpr.VariantClear
Delphi
procedure VariantClear(var V: Variant);
C++
extern DELPHI_PACKAGE void __fastcall VariantClear(System::Variant &V);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.Internal.VarHlpr.pas System.Internal.VarHlpr.hpp |
System.Internal.VarHlpr | System.Internal.VarHlpr |
Description
Efface le Variant spécifié afin qu'il ne soit pas affecté.
L'appel de VariantClear est équivalent à l'affectation de la constante Unassigned au Variant. Après un appel à VariantClear, la fonction VarIsEmpty renvoie true et la fonction VarType renvoie varEmpty. L'utilisation d'un variant non affecté dans une expression provoque le déclenchement d'une exception. De même, lors d'une tentative de conversion d'un Variant non affecté en un autre type (au moyen de VariantCast), une exception est déclenchée.
Remarque : Ne confondez pas l'effacement d'un Variant, qui le laisse Unassigned, et l'affectation d'une valeur Null. Un Variant Null est encore affecté, mais il a la valeur Null. A l'inverse des Variants Unassigned, les Variants Null peuvent être utilisés dans des expressions et convertis en d'autres types de Variants.