System.Variants.Unassigned

Aller au parent : System.Variants

Delphi

function Unassigned: Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall Unassigned(void);

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Variants.pas System.Variants.hpp	System.Variants	System.Variants

Description

Renvoie un variant "vide".

Une variable variant peut être "vide", c'est-à-dire ne pas encore avoir été initialisée. La fonction Unassigned renvoie un variant vide, qui peut être affecté à une variable variant pour restaurer cette variable à son état initial.

Utilisez la fonction VarIsEmpty pour tester si un variant est vide. Appliquée à un variant vide, la fonction standard VarType renvoie varEmpty.

Si un variant vide est transtypé en un autre type (par exemple, par une affectation à une variable non variant ou en appelant VarAsType), les conversions suivantes sont effectuées :

Destination	Résultat de conversion
Type numérique	Zéro
Type chaîne	Chaîne vide
Booléen	False.

Remarque : Unassigned est utile avec des variants faisant référence à des objets OLE Automation, que vous voulez conserver "en vie" jusqu'à ce qu'une autre valeur soit affectée au variant.

Il y a une fonctionnalité correspondante sous Linux. A documenter ultérieurement.