System.VarClear

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi