CnvAM

CnvAM(decimal1[, int2[, handle3[, int4[, int5]]]]) : alpha

Umwandlung eines Dezimalwerts in einen alphanumerischen Wert

Details

• decimal1: Umzuwandelnder Wert
• int2:
  • Formatoptionen (optional):
  • _FmtNumNoGroup
  • _FmtNumNoZero
  • _FmtNumPoint
  • _FmtNumCurrency
  • _FmtNumCurrencyIntl
  • _FmtNumLeadZero
  • _FmtInternal
  • _FmtNone
• handle3: Regionaldeskriptor (optional)
• int4: Anzahl der Nachkommastellen (optional)
• int5: Länge der Zeichenkette (optional)
• Resultat: alpha Umgewandelter Wert
• Siehe: Verwandte Befehle

Diese Funktion wandelt einen Wert vom Typ decimal in einen Wert vom Typ alpha. Die Länge des Resultats ist abhängig vom umzuwandelnden Wert.

Wird in (handle3) der Deskriptor eines Locale -Objektes übergeben, bestimmen die dort eingetragenen Eigenschaften das Format des Rückgabewertes.

In (int4) wird die Anzahl der Nachkommastellen angegeben. Bei der Angabe von -1 werden die Ländereinstellungen von Windows verwendet. Besitzt der Wert mehr signifikante Nachkommastellen als angegeben, findet eine kaufmännische Rundung statt. Bei -2 werden soviele Nachkommastellen dargestellt, wie der Wert benötigt.

Ohne Angabe von (int4) wird die Anzahl der Nachkommastellen in den landesspezifischen Einstellungen benutzt. Wird kein Regionaldeskriptor angegeben (handle3 = 0), wird die systemdefinierte Einstellung verwendet.

Die maximale Länge der erzeugten Zeichenkette kann in (int5) angegeben werden. Wird eine Zeichenkette erzeugt, deren Länge größer als die angegebene Länge ist, wird der Laufzeitfehler _ErrCnv erzeugt. Wird dieser Laufzeitfehler mit ErrIgnore ( _ErrCnv , true ) unterdrückt, wird eine leere Zeichenkette zurückgegeben.

Wird in (int2) der Wert _FmtNumLeadZero angegeben, muss in (int4) und in (int5) die Anzahl der Nachkommastellen und die Länge der Zeichenkette angegeben werden. Die Zahl in (decimal1) wird in eine Zeichenkette mit führenden Nullen gewandelt.

info

Die Option _FmtNumLeadZero kann nicht mit den Optionen _FmtNumCurrency oder _FmtNumCurrencyIntl kombiniert werden.

Kann der Wert nicht umgewandelt werden, wird der Laufzeitfehler _ErrCnv erzeugt. Es wird ein leerer Alphawert zurückgeliefert, wenn der Laufzeitfehler übergangen wird.

Beispiele:

CnvAM(1000.0\m)                      // '1.000,00'
CnvAM(1000.0\m, _FmtNumNoGroup)      // '1000,00'
CnvAM(1000.0\m, _FmtNumPoint)        // '1000.00'
CnvAM(1000.0\m, _FmtNone, 0, 3, 12)  // '   1.000,000'
CnvAM(-1000.0\m, _FmtNone, 0, 3, 9)  // '' Es wird ein Laufzeitfehler erzeugt.
CnvAM(-1000.0\m, _FmtNone, 0, 3, 10) // '-1.000,000'

Mögliche Laufzeitfehler

• _ErrCnv: Fehler bei Typkonvertierung
• _ErrHdlInvalid: Der in (handle3) übergebene Regionaldeskriptor ist nicht korrekt