COleCurrency-Klasse

Kapselt den CURRENCY -Datentyp der OLE-Automatisierung.

Syntax

class COleCurrency

Member

Öffentliche Konstruktoren

Name	Beschreibung
COleCurrency::COleCurrency	Erstellt ein COleCurrency-Objekt.

Öffentliche Methoden

Name	Beschreibung
COleCurrency::Format	Generiert eine formatierte Zeichenfolgendarstellung eines COleCurrency Objekts.
COleCurrency::GetStatus	Ruft den Status (Gültigkeit) dieses COleCurrency Objekts ab.
COleCurrency::P arseCurrency	Liest einen CURRENCY-Wert aus einer Zeichenfolge und legt den Wert von COleCurrency.
COleCurrency::SetCurrency	Legt den Wert dieses COleCurrency Objekts fest.
COleCurrency::SetStatus	Legt den Status (Gültigkeit) für dieses COleCurrency Objekt fest.

Öffentliche Operatoren

Name	Beschreibung
operator =	Kopiert einen COleCurrency Wert.
operator +, -	Addiert, subtrahiert und ändert das Vorzeichen von COleCurrency Werten.
operator +=, -=	Addiert und subtrahiert einen COleCurrency Wert von diesem COleCurrency Objekt.
Operator*/	Skaliert einen COleCurrency Wert um einen ganzzahligen Wert.
Operator *=, /=	Skaliert diesen COleCurrency Wert um einen ganzzahligen Wert.
Operator <<	Gibt einen COleCurrency Wert in CArchive oder CDumpContext.
Operator >>	Eingabe eines COleCurrency Objekts von CArchive.
Operator CURRENCY	Wandelt einen COleCurrency Wert in eine WÄHRUNG um.
Operator ==, <= <usw.	Vergleicht zwei COleCurrency Werte.

Öffentliche Datenmember

Name	Beschreibung
COleCurrency::m_cur	Enthält die zugrunde liegende CURRENCY für dieses COleCurrency Objekt.
COleCurrency::m_status	Enthält den Status dieses COleCurrency Objekts.

Hinweise

COleCurrency besitzt keine Basisklasse.

CURRENCY wird als 8-Byte-Wert implementiert, wobei der ganzzahlige Wert von zwei auf 10.000 skaliert wird. Dies ermöglicht eine Festkommazahl mit 15 Stellen links vom Dezimaltrennzeichen und 4 Ziffern rechts. Der DATENTYP CURRENCY ist äußerst nützlich für Berechnungen mit Geld oder für eine beliebige Festkommaberechnung, bei der genauigkeit wichtig ist. Es ist einer der möglichen Typen für den VARIANT Datentyp der OLE-Automatisierung.

COleCurrency implementiert außerdem einige grundlegende arithmetische Vorgänge für diesen Festen Punkttyp. Die unterstützten Vorgänge wurden ausgewählt, um die Rundungsfehler zu steuern, die bei Festkommaberechnungen auftreten.

Vererbungshierarchie

COleCurrency

Anforderungen

Header: afxdisp.h

COleCurrency::COleCurrency

Erstellt ein COleCurrency-Objekt.

COleCurrency();
COleCurrency(CURRENCY cySrc);
COleCurrency(const COleCurrency& curSrc);
COleCurrency(const VARIANT& varSrc);

COleCurrency(
    long nUnits,
    long nFractionalUnits);

Parameter

cySrc
Ein CURRENCY-Wert, der in das neue COleCurrency Objekt kopiert werden soll.

curSrc
Ein vorhandenes COleCurrency Objekt, das in das neue COleCurrency Objekt kopiert werden soll.

varSrc
Eine vorhandene VARIANT Datenstruktur (möglicherweise ein COleVariant Objekt), die in einen Währungswert (VT_CY) konvertiert und in das neue COleCurrency Objekt kopiert werden soll.

nUnits, nFractionalUnits Gibt die Einheiten und Bruchteile (in 1/10.000's) des Werts an, der in das neue COleCurrency Objekt kopiert werden soll.

Hinweise

Alle diese Konstruktoren erstellen neue COleCurrency Objekte, die mit dem angegebenen Wert initialisiert werden. Eine kurze Beschreibung der einzelnen Konstruktoren folgt. Sofern nicht anders angegeben, wird der Status des neuen COleCurrency Elements auf "gültig" festgelegt.

• COleCurrency() Erstellt ein Objekt, das COleCurrency auf 0 (null) initialisiert wurde.

• COleCurrency(cySrc) Erstellt ein COleCurrency Objekt aus einem CURRENCY-Wert .

• COleCurrency(curSrc) Erstellt ein COleCurrency Objekt aus einem vorhandenen COleCurrency Objekt. Das neue Objekt hat denselben Status wie das Quellobjekt.

• COleCurrency(varSrc) Erstellt ein COleCurrency Objekt. Versucht, eine VARIANT-Struktur oder COleVariant ein Objekt in einen Währungswert (VT_CY) zu konvertieren. Wenn diese Konvertierung erfolgreich ist, wird der konvertierte Wert in das neue COleCurrency Objekt kopiert. Andernfalls wird der Wert des COleCurrency Objekts auf Null (0) und sein Status auf ungültig festgelegt.

• COleCurrency(nUnits, nFractionalUnits) Erstellt ein COleCurrency Objekt aus den angegebenen numerischen Komponenten. Wenn der absolute Wert des Bruchteils größer als 10.000 ist, wird die entsprechende Anpassung an den Einheiten vorgenommen. Beachten Sie, dass die Einheiten und Bruchteile durch signierte lange Werte angegeben werden.

Weitere Informationen finden Sie in den Einträgen CURRENCY und VARIANT im Windows SDK.

Beispiel

Die folgenden Beispiele zeigen die Auswirkungen der Nullparameter und der Konstruktoren mit zwei Parametern:

COleCurrency curZero;         // value: 0.0000
COleCurrency curA(4, 500);    // value: 4.0500
COleCurrency curB(2, 11000);  // value: 3.1000
COleCurrency curC(2, -50);    // value: 1.9950

COleCurrency::Format

Rufen Sie diese Memberfunktion auf, um eine formatierte Darstellung des Währungswerts zu erstellen.

CString Format(DWORD  dwFlags = 0, LCID  lcid = LANG_USER_DEFAULT) const;

Parameter

dwFlags
Gibt Kennzeichnungen für Gebietsschemaeinstellungen an. Nur die folgende Kennzeichnung ist für Währungen relevant:

• LOCALE_NOUSEROVERRIDE Verwenden Sie anstelle von benutzerdefinierten Benutzereinstellungen die Standardgebietsschemaeinstellungen des Systems.

lcid
Gibt die gebietsschema-ID an, die für die Konvertierung verwendet werden soll.

Rückgabewert

A CString , das den formatierten Währungswert enthält.

Hinweise

Er formatiert den Wert mithilfe der lokalen Sprachspezifikationen (Gebietsschema-IDs). Ein Währungssymbol ist nicht im zurückgegebenen Wert enthalten. Wenn der Status dieses COleCurrency Objekts null ist, ist der Rückgabewert eine leere Zeichenfolge. Wenn der Status ungültig ist, wird die Rückgabezeichenfolge durch die Zeichenfolgenressource IDS_INVALID_CURRENCY angegeben.

Beispiel

COleCurrency curA;           // value: 0.0000
curA.SetCurrency(4, 500);    // value: 4.0500

// value returned: 4.05
curA.Format(0, MAKELCID(MAKELANGID(LANG_CHINESE,
   SUBLANG_CHINESE_SINGAPORE), SORT_DEFAULT));
// value returned: 4,05
curA.Format(0, MAKELCID(MAKELANGID(LANG_GERMAN,
   SUBLANG_GERMAN_AUSTRIAN), SORT_DEFAULT));

COleCurrency::GetStatus

Rufen Sie diese Memberfunktion auf, um den Status (Gültigkeit) eines bestimmten COleCurrency Objekts abzurufen.

CurrencyStatus GetStatus() const;

Rückgabewert

Gibt den Status dieses COleCurrency Werts zurück.

Hinweise

Der Rückgabewert wird durch den aufgezählten Typ definiert, der CurrencyStatus innerhalb der COleCurrency Klasse definiert ist.

enum CurrencyStatus {
    valid = 0,
    invalid = 1,
    null = 2
    };

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

• COleCurrency::valid Gibt an, dass dieses COleCurrency Objekt gültig ist.

• COleCurrency::invalid Gibt an, dass dieses COleCurrency Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

• COleCurrency::null Gibt an, dass dieses COleCurrency Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

Der Status eines COleCurrency Objekts ist in den folgenden Fällen ungültig:

• Wenn der Wert aus einem VARIANT- oder COleVariant Wert festgelegt wird, der nicht in einen Währungswert konvertiert werden konnte.

• Wenn dieses Objekt während eines arithmetischen Zuordnungsvorgangs einen Überlauf oder Unterlauf erlebt hat, z += . B. oder *=.

• Wenn diesem Objekt ein ungültiger Wert zugewiesen wurde.

• Wenn der Status dieses Objekts mithilfe von SetStatus explizit auf ungültig festgelegt wurde.

Weitere Informationen zu Vorgängen, die den Status auf ungültig festlegen können, finden Sie in den folgenden Memberfunktionen:

• COleCurrency

• operator =

• operator + -

• operator += und -=

• Operator*/

• Operator *= und /=

Beispiel

// 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);

COleCurrency::m_cur

Die zugrunde liegende CURRENCY-Struktur für dieses COleCurrency Objekt.

Hinweise

Weitere Informationen finden Sie im Eintrag "CURRENCY " im Windows SDK.

COleCurrency::m_status

Der Typ dieses Datenelements ist der Aufzählungstyp CurrencyStatus, der innerhalb der COleCurrency Klasse definiert ist.

enum CurrencyStatus{
    valid = 0,
    invalid = 1,
    null = 2,
};

Hinweise

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

• COleCurrency::valid Gibt an, dass dieses COleCurrency Objekt gültig ist.

• COleCurrency::invalid Gibt an, dass dieses COleCurrency Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

• COleCurrency::null Gibt an, dass dieses COleCurrency Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

Der Status eines COleCurrency Objekts ist in den folgenden Fällen ungültig:

• Wenn der Wert aus einem VARIANT- oder COleVariant Wert festgelegt wird, der nicht in einen Währungswert konvertiert werden konnte.

• Wenn dieses Objekt während eines arithmetischen Zuordnungsvorgangs einen Überlauf oder Unterlauf erlebt hat, z += . B. oder *=.

• Wenn diesem Objekt ein ungültiger Wert zugewiesen wurde.

• Wenn der Status dieses Objekts mithilfe von SetStatus explizit auf ungültig festgelegt wurde.

Weitere Informationen zu Vorgängen, die den Status auf ungültig festlegen können, finden Sie in den folgenden Memberfunktionen:

• COleCurrency

• operator =

• operator +, -

• operator +=, -=

• Operator*/

• Operator *=, /=

COleCurrency::operator =

Diese überladenen Zuordnungsoperatoren kopieren den Quellwährungswert in dieses COleCurrency Objekt.

const COleCurrency& operator=(CURRENCY cySrc);
const COleCurrency& operator=(const COleCurrency& curSrc);
const COleCurrency& operator=(const VARIANT& varSrc);

Hinweise

Eine kurze Beschreibung der einzelnen Operatoren folgt:

• operator =( cySrc ) Der CURRENCY Wert wird in das COleCurrency Objekt kopiert, und sein Status ist auf gültig festgelegt.

• operator =( curSrc ) Der Wert und der Status des Operanden, ein vorhandenes COleCurrency Objekt wird in dieses COleCurrency Objekt kopiert.

• operator =( varSrc ) If the conversion of the VARIANT value (or COleVariant object) to a currency ( VT_CY) is successful, the converted value is copied into this COleCurrency object and its status is set to valid. Wenn die Konvertierung nicht erfolgreich ist, wird der Wert des COleCurrency Objekts auf 0 und sein Status auf ungültig festgelegt.

Weitere Informationen finden Sie in den Einträgen CURRENCY und VARIANT im Windows SDK.

Beispiel

// set to 35.0050
COleCurrency cur1(35, 50);
COleCurrency cur2;

// operator= copies COleCurrency types
cur2 = cur1;
ASSERT(cur1 == cur2);

// can be used to assign a CURRENCY type, as well
CURRENCY cy;
cy.Hi = 0;
cy.Lo = 350050;
cy.int64 = 350050;

// perform assignment
COleCurrency cur3;
cur3 = cy;
ASSERT(cur3 == cur1);

COleCurrency::operator +, -

Mit diesen Operatoren können Sie zwei COleCurrency Werte addieren und voneinander subtrahieren und das Vorzeichen eines COleCurrency Werts ändern.

COleCurrency operator+(const COleCurrency& cur) const;
COleCurrency operator-(const COleCurrency& cur) const;
COleCurrency operator-() const;

Hinweise

Wenn eine der Operanden null ist, ist der Status des resultierenden COleCurrency Werts null.

Wenn der arithmetische Vorgang überläuft, ist der resultierende COleCurrency Wert ungültig.

Wenn der Operand ungültig ist und der andere nicht NULL ist, ist der Status des resultierenden COleCurrency Werts ungültig.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

// 35.0050
COleCurrency cur1(35, 50);
// 2.0075
COleCurrency cur2(2, 75);
COleCurrency cur3;

// sum is 37.0125
cur3 = cur1 + cur2;
ASSERT(cur3 == COleCurrency(37, 125));

// difference is 32.9975
cur3 = cur1 - cur2;
ASSERT(cur3 == COleCurrency(32, 9975));

COleCurrency::operator +=, -=

Ermöglichen Sie das Hinzufügen und Subtrahieren eines COleCurrency Werts zu und von diesem COleCurrency Objekt.

const COleCurrency& operator+=(const COleCurrency& cur);
const COleCurrency& operator-=(const COleCurrency& cur);

Hinweise

Wenn eine der Operanden null ist, wird der Status dieses COleCurrency Objekts auf NULL festgelegt.

Wenn der arithmetische Vorgang überläuft, wird der Status dieses COleCurrency Objekts auf ungültig festgelegt.

Wenn eine der Operanden ungültig ist und die andere ungültig ist, wird der Status dieses COleCurrency Objekts auf ungültig festgelegt.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

// both set to 35.0050
COleCurrency cur1(35, 50);
COleCurrency cur2(35, 50);

// adding 2.0075 results in 37.0125
cur1 += COleCurrency(2, 75);
ASSERT(cur1 == COleCurrency(37, 125));

// subtracting 2.0075 results in 32.9975
cur2 -= COleCurrency(2, 75);
ASSERT(cur2 == COleCurrency(32, 9975));

COleCurrency::operator * und /

Ermöglicht es Ihnen, einen COleCurrency Wert um einen integralen Wert zu skalieren.

COleCurrency operator*(long nOperand) const;
COleCurrency operator/(long nOperand) const;

Hinweise

Wenn der COleCurrency Operand null ist, ist der Status des resultierenden COleCurrency Werts null.

Wenn der arithmetische Vorgang überläuft oder unterläuft, ist der Status des resultierenden COleCurrency Werts ungültig.

Wenn der COleCurrency Operand ungültig ist, ist der Status des resultierenden COleCurrency Werts ungültig.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

// 35 units and 50/10000, or 35.0050
COleCurrency cur1(35, 50);
COleCurrency cur2;

// divided by two is 17.5025
cur2 = cur1 / 2;
ASSERT(cur2 == COleCurrency(17, 5025));

// multiplied by two is 70.0100
cur2 = cur1 * 2;
ASSERT(cur2 == COleCurrency(70, 100));

COleCurrency::operator *=, /=

Ermöglichen Sie es Ihnen, diesen COleCurrency Wert um einen integralen Wert zu skalieren.

const COleCurrency& operator*=(long nOperand);
const COleCurrency& operator/=(long nOperand);

Hinweise

Wenn der COleCurrency Operand null ist, wird der Status dieses COleCurrency Objekts auf NULL festgelegt.

Wenn der arithmetische Vorgang überläuft, wird der Status dieses COleCurrency Objekts auf ungültig festgelegt.

Wenn der COleCurrency Operand ungültig ist, wird der Status dieses COleCurrency Objekts auf "ungültig" festgelegt.

Weitere Informationen zu den gültigen, ungültigen und NULL-Statuswerten finden Sie in der m_status Membervariable.

Beispiel

// both set to 35.0050
COleCurrency cur1(35, 50);
COleCurrency cur2(35, 50);

// divide in half
cur1 /= 2;
ASSERT(cur1 == COleCurrency(17, 5025));

// multiply by two
cur2 *= 2;
ASSERT(cur2 == COleCurrency(70, 100));

operator <<, operator >>

Unterstützt Diagnosedumping und -speicherung in einem Archiv.

friend CDumpContext& operator<<(
    CDumpContext& dc,
    COleCurrency curSrc);

friend CArchive& operator<<(
    CArchive& ar,
    COleCurrency curSrc);

friend CArchive& operator>>(
    CArchive& ar,
    COleCurrency& curSrc);

Hinweise

Der Extraktionsoperator ( >>) unterstützt das Laden aus einem Archiv.

COleCurrency::operator CURRENCY

Gibt eine CURRENCY Struktur zurück, deren Wert aus diesem COleCurrency Objekt kopiert wird.

operator CURRENCY() const;

Hinweise

COleCurrency::P arseCurrency

Rufen Sie diese Memberfunktion auf, um eine Zeichenfolge zum Lesen eines Währungswerts zu analysieren.

BOOL ParseCurrency(
    LPCTSTR lpszCurrency,
    DWORD dwFlags = 0,
    LCID lcid = LANG_USER_DEFAULT);

throw(CMemoryException*);
throw(COleException*);

Parameter

lpszCurrency
Ein Zeiger auf die mit Null beendete Zeichenfolge, die analysiert werden soll.

dwFlags
Gibt Flags für Gebietsschemaeinstellungen an, möglicherweise das folgende Kennzeichen:

• LOCALE_NOUSEROVERRIDE Verwenden Sie anstelle von benutzerdefinierten Benutzereinstellungen die Standardgebietsschemaeinstellungen des Systems.

lcid
Gibt die gebietsschema-ID an, die für die Konvertierung verwendet werden soll.

Rückgabewert

Nonzero, wenn die Zeichenfolge erfolgreich in einen Währungswert konvertiert wurde, andernfalls 0.

Hinweise

Es verwendet Gebietsschema-IDs (Gebietsschema-IDs) für die Bedeutung nicht numerischer Zeichen in der Quellzeichenfolge.

Eine Erläuterung der Gebietsschema-ID-Werte finden Sie unter Unterstützen mehrerer Sprachen.

Wenn die Zeichenfolge erfolgreich in einen Währungswert konvertiert wurde, wird der Wert dieses Objekts auf diesen COleCurrency Wert und dessen Status auf gültig festgelegt.

Wenn die Zeichenfolge nicht in einen Währungswert konvertiert werden konnte oder ein numerischer Überlauf vorhanden war, ist der Status dieses COleCurrency Objekts ungültig.

Wenn die Zeichenfolgenkonvertierung aufgrund von Speicherzuweisungsfehlern fehlgeschlagen ist, löst diese Funktion eine CMemoryException aus. In einem anderen Fehlerzustand löst diese Funktion eine COleException aus.

Beispiel

// works if default locale has dot decimal point
COleCurrency cur;
cur.ParseCurrency(_T("$135.95"), 0);
ASSERT(cur == COleCurrency(135, 9500));

Relationale COleCurrency-Operatoren

Vergleichen Sie zwei Währungswerte, und geben Sie einen Wert ungleich Null zurück, wenn die Bedingung wahr ist. andernfalls 0.

BOOL operator==(const COleCurrency& cur) const;
BOOL operator!=(const COleCurrency& cur) const;
BOOL operator<(const COleCurrency& cur) const;
BOOL operator>(const COleCurrency& cur) const;
BOOL operator<=(const COleCurrency& cur) const;
BOOL operator>=(const COleCurrency& cur) const;

Hinweise

Beispiel

COleCurrency curOne(3, 5000);             // 3.5
COleCurrency curTwo(curOne);              // 3.5
BOOL b = (curOne == curTwo);              // TRUE

b = curOne < curTwo;                      // FALSE, same value
b = curOne > curTwo;                      // FALSE, same value
b = curOne <= curTwo;                     // TRUE, same value
b = curOne >= curTwo;                     // TRUE, same value
curTwo.SetStatus(COleCurrency::invalid);
b = curOne == curTwo;                     // FALSE, different status
b = curOne != curTwo;                     // TRUE, different status

COleCurrency::SetCurrency

Rufen Sie diese Memberfunktion auf, um die Einheiten und Bruchteile dieses COleCurrency Objekts festzulegen.

void SetCurrency(
    long nUnits,
    long nFractionalUnits);

Parameter

nUnits, nFractionalUnits Gibt die Einheiten und Bruchteile (in 1/10.000) des Werts an, der in dieses COleCurrency Objekt kopiert werden soll.

Hinweise

Wenn der absolute Wert des Bruchteils größer als 10.000 ist, wird die entsprechende Anpassung an den Einheiten vorgenommen, wie im dritten der folgenden Beispiele gezeigt.

Beachten Sie, dass die Einheiten und Bruchteile durch signierte lange Werte angegeben werden. Der vierte der folgenden Beispiele zeigt, was passiert, wenn die Parameter unterschiedliche Zeichen aufweisen.

Beispiel

COleCurrency curA;           // value: 0.0000
curA.SetCurrency(4, 500);    // value: 4.0500
curA.SetCurrency(2, 11000);  // value: 3.1000
curA.SetCurrency(2, -50);    // value: 1.9950

COleCurrency::SetStatus

Rufen Sie diese Memberfunktion auf, um den Status (Gültigkeit) dieses COleCurrency Objekts festzulegen.

void SetStatus(CurrencyStatus  status  );

Parameter

status
Der neue Status für dieses COleCurrency Objekt.

Hinweise

Der Statusparameterwert wird durch den CurrencyStatus Aufzählungstyp definiert, der innerhalb der COleCurrency Klasse definiert ist.

enum CurrencyStatus {
    valid = 0,
    invalid = 1,
    null = 2
    };

Eine kurze Beschreibung dieser Statuswerte finden Sie in der folgenden Liste:

• COleCurrency::valid Gibt an, dass dieses COleCurrency Objekt gültig ist.

• COleCurrency::invalid Gibt an, dass dieses COleCurrency Objekt ungültig ist. Das heißt, der Wert ist möglicherweise falsch.

• COleCurrency::null Gibt an, dass dieses COleCurrency Objekt null ist, d. h., dass für dieses Objekt kein Wert angegeben wurde. (Dies ist "null" im Datenbankwert " ohne Wert" im Gegensatz zu C++ NULL.)

Siehe auch

Hierarchiediagramm
COleVariant-Klasse