System.Variants.VarCheckEmpty
Delphi
procedure VarCheckEmpty(const V: Variant);
C++
extern DELPHI_PACKAGE void __fastcall VarCheckEmpty(const System::Variant &V);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | System.Variants.pas System.Variants.hpp |
System.Variants | System.Variants |
説明
指定したバリアントの値が Unassigned であった場合に例外を発生させます。
Variant が値を持っていることをコードで想定していて、値を持っていない場合には例外を発生させたいなら、VarCheckEmpty を呼び出してください。VarCheckEmpty は、V で指定した Variant の値が Unassigned かどうかを確認し、Unassigned であった場合には EVariantTypeMismatchError 例外を発生させます。
例外を発生させないで Variant が Unassigned かどうかを確認したい場合には、この関数ではなく VarIsEmpty 関数を使用してください。Variant の値が未定義かどうかを確認したい場合は、VarIsClear 関数を使用してください。
メモ： Unassigned バリアントと、値が Null の Variant とを混同してはなりません。Null バリアントには値が割り当てられています。ただ、その値が Null だというだけです。割り当てられていないバリアントとは違って、Null バリアントは式で使用したり、他の型のバリアントに変換することができます。