System.VarClear
Delphi
procedure VarClear(var V: Variant);
C++
extern void __fastcall VarClear(Variant& v);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.pas sysvari.h |
System | System |
Description
Efface le Variant spécifié afin qu'il ne soit pas affecté.
L'appel de VarClear est équivalent à l'affectation de la constante Unassigned au variant. V peut être un Variant ou un OleVariant, et il doit être possible de lui affecter une valeur (qui doit être une lvalue).
Après un appel à VarClear, 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é dans un autre type (au moyen de VarAsType), 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.