CnvAI

CnvAI(int1[, int2[, handle3[, int4]]]) : alpha

Umwandlung eines ganzzahligen Wertes (32 Bit) in einen alphanumerischen Wert

Details

• int1: Umzuwandelnder Wert
• int2:
  • Formatoptionen (optional):
  • _FmtNumNoGroup
  • _FmtNumNoZero
  • _FmtNumLeadZero
  • _FmtNumHex
  • _FmtInternal
  • _FmtNone
• handle3: Regionaldeskriptor (optional)
• int4: Anzahl der Stellen (optional)
• Resultat: alpha Umgewandelter Wert
• Siehe: Verwandte Befehle

Diese Funktion wandelt einen Wert vom Typ int in einen Wert vom Typ alpha. Die angegebenen Formatoptionen entscheiden über das genaue Format.

Die Länge des Resultats ist abhängig vom umzuwandelnden Wert.

Wird in (handle3) ein Deskriptor eines Locale -Objekt angegeben, bestimmen die dort eingetragenen Eigenschaften das Format des Rückgabewertes.

Wird in (int4) die Anzahl der Stellen vorgegeben, wird eine Zeichenkette der angegebenen Länge erzeugt. Die Zeichenkette wird mit Leerzeichen auf die entsprechende Länge aufgefüllt. Bei der Verwendung der Option _FmtNumLeadZero wird statt Leerzeichen Nullen verwendet. Zu der Länge zählen ebenfalls Vorzeichen und Tausendertrennzeichen. Übersteigt der Wert die angegebene Anzahl der Stellen, wird der Laufzeitfehler _ErrCnv erzeugt. Wird dieser Laufzeitfehler mit ErrIgnore ( _ErrCnv , true ) unterdrückt, wird eine leere Zeichenkette zurückgegeben.

Wird der Wert 0x80000000 ohne die Formatoption _FmtNumHex konvertiert, wird eine leere Zeichenkette zurückgegeben.

Beispiele:

CnvAI(2134, _FmtInternal)                        // '2134'
CnvAI(2134, _FmtNone, hdlLangGB)                 // '2,134'
CnvAI(0, _FmtNumNoZero)                          // ''
CnvAI(65536, _FmtNumLeadZero | _FmtNumHex, 0, 5) // '0ffff'
CnvAI(1000, _FmtNone, 0, 4)                      // '' Ein Laufzeitfehler wird erzeugt.
CnvAI(1000, _FmtNumNoGroup, 0, 4)                // '1000'
CnvAI(1000, _FmtNone, 0, 5)                      // '1.000'
CnvAI(-1000, _FmtNone, 0, 5)                     // '' Ein Laufzeitfehler wird erzeugt.
CnvAI(0x80000000)                                // ''
CnvAI(0x80000000, _FmtNumHex)                    // '80000000'

Mögliche Laufzeitfehler:

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