System.Variants.Unassigned

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi