CONVERT

Script-Funktion: Konvertiert den Datentyp eines Wertes.

Syntax

CONVERT (Data type, Value)

Syntax

Beschreibung/Format

Data type

Datentyp in welchen umgewandelt werden soll.
Erlaubte Werte: "unsigned", "signed", "float" und "string"

unsigned: Positive Ganzzahlen ohne Vorzeichen
signed: Ganzzahlen mit Vorzeichen
float: Gleitkommazahl
string: Zeichenfolge, Text

Die Angabe von Datentypen erfolgt nicht mit Hochkomma.

Value

Wert, dessen Datentyp in einen anderen Datentyp umgewandelt werden soll.

Format: Script-Literal oder Script-Variable

Zahlen müssen auch unter Hochkomma angegeben werden.


Rückgabewert

Wert mit dem umgewandelten Datentyp.

Mit der Script-Funktion ist es möglich den Datentyp eines Wertes, der entweder direkt oder über eine Script-Variable angeben wird, in einen anderen Datentyp umzuwandeln. Der Rückgabewert ist der umgewandeltete Wert, der einer Zielvariable zugewiesen werden muss.

Beachten Sie bei der Verwendung dieser Script-Funktion, dass der Datentyp des umzuwandelnden Wertes zum Datentyp der Zielvariable passt.

Strings können nur in Zahlen umgewandelt werden, wenn die Zeichenkette eine Zahl in einem gültigen Format beinhaltet.

Wenn versucht wird, einen höheren Zahlentyp in einen niedrigeren umzuwandeln, werden Kommazahlen gerundet oder die Vorzeichen entfernt.

Entspricht der Datentyp der Zielvariable nicht dem Parameter "Datentyp" der Funktion, ist die Umwandlung nicht möglich und es kommt zu einem Scriptfehler.

Beachten Sie, dass mit der Scriptfunktion keine negativen Zahlen umgewandelt werden können

Beispiel

Im ersten Beispiel wird eine positive Ganzzahl in eine Zeichenkette umgewandelt.

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

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

Im zweiten Beispiel wird eine Zeichenkette in eine Zahl umgewandelt. Dies ist nur möglich, wenn die Zeichenkette aus einer Zahl besteht, welche ein für den Zieldatentyp gültiges Format aufweist.

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

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

Siehe auch: