COleCurrency::GetStatus

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定された COleCurrency オブジェクトの状態 (有効性) を取得します。

CurrencyStatus GetStatus( ) const;

戻り値

この COleCurrency 値の状態を返します。

解説

戻り値は、COleCurrency クラス内で定義されている列挙型 CurrencyStatus として定義されています。

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

状態値の簡単な説明は、次の一覧を参照してください。

COleCurrency::valid この COleCurrency オブジェクトが有効であることを示します。
COleCurrency::invalid この COleCurrency オブジェクトが無効、つまりその値が不正である可能性を示します。
COleCurrency::null この COleCurrency オブジェクトが null、つまりこのオブジェクトに値が設定されていないことを示します。これは、C++ の NULL とは異なり、"値を持たない" というデータベース用語での "null" です。

次の場合 COleCurrency オブジェクトの状態は無効になります。

値が、通貨値に変換できない VARIANT 値、または COleVariant 値から設定された場合。
オブジェクトが、たとえば += または *= などの代入演算中にオーバーフローまたはアンダーフローになった場合。
このオブジェクトに無効な値が代入された場合。
このオブジェクトの状態が SetStatus を使って、明示的に無効に設定された場合。

状態が無効に設定される可能性のある演算の詳細については、次のメンバ関数を参照してください。

使用例

// even an empty COleCurrency is valid
COleCurrency cy;
ASSERT(cy.GetStatus() == COleCurrency::valid);

// always valid after being set
cy.SetCurrency(4, 500);
ASSERT(cy.GetStatus() == COleCurrency::valid);

// some conversions aren't possible and will
// cause an invalid state, like this:
CByteArray array;
COleVariant varBogus(array);
cy = varBogus;
ASSERT(cy.GetStatus() == COleCurrency::invalid);