System.Variants.VarCheckEmpty

提供: RAD Studio API Documentation
移動先: 案内検索

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 例外を発生させます。

例外を発生させないで VariantUnassigned かどうかを確認したい場合には、この関数ではなく VarIsEmpty 関数を使用してください。Variant の値が未定義かどうかを確認したい場合は、VarIsClear 関数を使用してください。

メモ:  Unassigned バリアントと、値が NullVariant とを混同してはなりません。Null バリアントには値が割り当てられています。ただ、その値が Null だというだけです。割り当てられていないバリアントとは違って、Null バリアントは式で使用したり、他の型のバリアントに変換することができます。

関連項目