System.VarClear

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure VarClear(var V: Variant);

C++

extern void __fastcall  VarClear(Variant& v);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.pas
sysvari.h
System System

Beschreibung

Leert eine Variante, damit sie keine Zuweisung hat.

Ein Aufruf von VarClear entspricht der Zuweisung der Konstante Unassigned zu einer Variante. V kann entweder eine Variante oder ein OleVariant sein, jedoch muss es möglich sein, ihr einen Wert zuzuweisen (es muss sich um einen L-Wert handeln).

Nach einem Aufruf von VarClear gibt die Funktion VarlsEmpty den Wert true zurück, und die Funktion VarType gibt varEmpty zurück. Die Verwendung einer nicht zugewiesenen Variante in einem Ausdruck bewirkt die Auslösung einer Exception. Wenn Sie versuchen, eine nicht zugewiesene Variante in einen anderen Typ (mit Hilfe von VarAsType) zu konvertierten, wird ebenfalls eine Exception ausgelöst.

Anmerkung:  Verwechseln Sie das Leeren einer Variante, bei der sie ohne Zuweisung bleibt, nicht mit dem Zuweisen eines Null-Werts. Eine Null-Variante ist zugewiesen, hat aber den Wert Null. Im Unterschied zu nicht zugewiesenen Varianten können Null-Varianten in Ausdrücken verwendet und in andere Varianten-Typen konvertiert werden.

Siehe auch

Codebeispiele