TapHome

Datentyp-Konvertierungen

Datentyp-Konvertierungsfunktionen der TapHome-Skriptsprache — TODOUBLE, TOSTRING, TOBCD, FROMBCD, TOBYTEARRAY, RGBTOHSV und HSVTORGB.

TODOUBLE

Wandelt einen String in eine Zahl um. Gibt NaN bei Fehler zurück.

TODOUBLE( text )

Beispiele:

TODOUBLE(“232”) ... 232
TODOUBLE(“-192.332”)  ...  -192.332
TODOUBLE(“some text”)  ...  NaN

TOSTRING

Gibt einen String-Wert des angegebenen Werts oder der Collection gemäß der angegebenen Kodierung zurück. Die Kodierung ist optional (Standard ist iso-8859-1).

TOSTRING(value, encoding)

Beispiele:

TOSTRING(192, “X”)  …  Result = “C0”
TOSTRING(192, “X4”)  …  Result = “00C0”
TOSTRING(192, “F4”)  …  Result = “123.3400”
TOSTRING(192, “F0”)  …  Result = “123”
TOSTRING(BYTECOLLECTION("48656c6c6f"))			(Result is “Hello”)
TOSTRING(BYTECOLLECTION(\"48656c6c6f\"), “iso-8859-1”)	(Result is “Hello”)
TOSTRING(192, “X4”)							(Result is “00C0”)

TOBCD

Konvertiert die angegebene Zahl in das binär codierte Dezimalformat (BCD). Das Kodierungsschema ist BCD-8421.

TOBCD(number)

Beispiele:

TOBCD(1)  ...  1
TOBCD(9)  ...  9
TOBCD(10)  ...  16

FROMBCD

Dekodiert die angegebene Zahl, die im binär codierten Dezimalformat (BCD) kodiert ist. Das Kodierungsschema ist BCD-8421.

FROMBCD(number)

Beispiele:

FROMBCD(16)  ...  10
FROMBCD(32)  ...  20

TOBYTEARRAY

Konvertiert eine Zeichenkette in ein Byte-Array gemäß der angegebenen Kodierung. Die Kodierung ist optional (Standard ist iso-8859-1).

TOBYTEARRAY( string, encoding )

Beispiele:

TOBYTEARRAY("Hello")			(Result is byte array 48656c6c6f)

RGBTOHSV

Wandelt RGB-Farbdefinitionen um und gibt die Farbe im Farbmodell Hue/Saturation/Brightness zurück.

RGBTOHSV( r, g, b )      (r, g, b … 0 - 0xFF)

Beispiel:

VAR HSVColor := RGBTOHSV( r, g, b );
VAR saturation := HSVColor.Saturation;   (Saturation … 0 - 1)
VAR hue := HSVColor.Hue;                 (Hue … 0 - 360)
VAR value := HSVColor.Value;             (Value … 0 - 1)

HSVTORGB

Konvertiert eine Farbe, die durch Hue/Saturation/Brightness definiert ist, und gibt die Farbe im RGB-Format zurück.

HSVTORGB( hue, saturation, value )

Beispiel:

VAR color := HSVTORGB( hue, saturation, 1)
VAR red := color.red;                   (red … 0 - 0xFF)
VAR green := color.green;               (green … 0 - 0xFF)
VAR blue := color.blue;                 (blue … 0 - 0xFF)