Automation Engine Script-Leitfaden > Funktionelle Gliederung > Strings > CONVERT

CONVERT

Scriptfunktion: Wandelt den Datentyp eines Wertes um.

Syntax 

CONVERT (Data type, value)

Syntax

Beschreibung/Format

Datentyp

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

unsigned: Positive Ganzzahlen ohne Vorzeichen
signed: Ganzzahlen mit Vorzeichen
float: Gleitkommazahlen
string: Zeichenkette, Text

Die Angabe von Datentypen erfolgt nicht mit Hochkomma!

Wert

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.

Kommentare 

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 umgewandelte 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:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH