CONVERT

Verwenden Sie die Script-Funktion CONVERT, um den Datentyp eines Werts zu konvertieren. Die Script-Funktion ermöglicht es Ihnen, Werte zu konvertieren, die direkt oder über eine Script-Variable angegeben wurden. Die Script-Funktion gibt den Wert mit dem konvertierten Datentyp zurück. Weisen Sie den Rückgabewert der Script-Funktion einer Variablen zu, um den konvertierten Wert zu verwenden.

Wichtig! Stellen Sie sicher, dass die Datentypen übereinstimmen, da Nichtübereinstimmungen Fehler verursachen können:

  • Der Datentyp des Werts, den Sie konvertieren möchten, muss mit dem Datentyp der Zielvariablen übereinstimmen.
  • Der Datentyp, den Sie in der Script-Funktion angeben, muss mit dem Datentyp der Zielvariablen übereinstimmen.

Hinweise:

  • Ein String kann nur in eine Zahl konvertiert werden, wenn der String aus einer Zahl in einem Format besteht, das für die Zielvariable gültig ist.
  • Wenn Sie einen höher auflösenden Zahlentyp in einen niedriger auflösenden Wert umwandeln, werden Dezimalzahlen gerundet, und die Vorzeichen werden entfernt.
  • Beachten Sie, dass mit der Script-Funktion keine negativen Zahlen umgewandelt werden können.

Syntax

CONVERT (Datentyp, Wert)

Parameter

  • CONVERT
    Konvertiert den Datentyp eines Wertes

  • Datentyp
    Datentyp, in den Sie den Wert konvertieren wollen
    Zulässige Werte:

    • unsigned
      Positive Ganzzahlen ohne Vorzeichen
    • signed
      Ganzzahlen mit Vorzeichen
    • float
      Gleitkommazahl
    • string
      String, Text
    Hinweis: Geben Sie den Datentyp ohne Anführungszeichen an.

  • Wert
    Wert, dessen Datentyp Sie konvertieren möchten
    Format:Script-Literal oder Script-Variable
    Hinweis: Schließen Sie Zahlen in Anführungszeichen ein.


Beispiel

Das folgende Script wandelt eine positive Ganzzahl in einen String um.

:define &unsigned#, unsigned
:define &string#, string

:set &unsigned# = 12
:set &string# = CONVERT(string, &unsigned#)

Das folgende Script wandelt einen String in eine Zahl um. Diese Konvertierung ist möglich, weil der String im Beispiel aus einer Zahl in einem Format besteht, das für den Zieldatentyp gültig ist.

:define &unsigned#, unsigned
:define &string#, string

:set &string# = "1234"
:set &unsigned# = CONVERT(unsigned,&string#)

Siehe auch:

seealso

:DEFINE