Differences

This shows you the differences between two versions of the page.

--- macros:types [2017/11/19 15:31] – [Datatypes in this Wiki] icke_siegen
+++ macros:types [2018/09/09 09:27] (current) – [Casting - type conversion] icke_siegen
@@ Line 11: / Line 11: @@
 ===== Casting - type conversion =====
-As types are that important to adhere to, and as functions are very picky about what they want to get as input and what they maybe return, there are means to convert data from one type to another. This is called type casting. While this is a good thing in order to provide the correct data type, this invokes the next challenge: conversion rules. Some are easy to understand, e.g. casting an integer value to a float. Others aren't: what rule would you suggest to cast the string "Moving Light" into an integer value? But usually you shouldn't need to bother. Just use the appropriate [[macros:namespace:math.cast|casting function]], e.g. in the example [[macros:example:changexfade]].
+As types are that important to adhere to, and as functions are very picky about what they want to get as input and what they maybe return, there are means to convert data from one type to another. This is called type casting. While this is a good thing in order to provide the correct data type, this invokes the next challenge: conversion rules. Some are easy to understand, e.g. casting an integer value to a float. Others aren't: what rule would you suggest to cast the string "Moving Light" into an integer value? But usually you shouldn't need to bother. Just use the appropriate [[macros:namespace:math.cast|casting function]], e.g. in the example [[macros:example:changechaseroverlap]].
-===== Datatypes in this Wiki =====
+Another example about when and when not to reference types: http://forum.avolites.com/viewtopic.php?f=20&t=5766#p20783
-Here is a list of the types covered in this wiki:
+>The ActionScript.SetProperty function can be used to set a value of any type, as the parameter type Object is the root class for all types including non-reference types (e.g. integers, floats). The ActionScript.SetProperty.Integer function only accepts an integer as the second parameter which can have the advantage when parsing input this can be assumed and so the correct type is chosen (particularly in WebAPI). However you can force a conversion by using casts which can work where automatic conversion is not possible for example:
+>
+><code xml>ActionScript.SetProperty("Windows.Playbacks.FixedColumns", int:"5")</code>will work where
+><code xml>ActionScript.SetProperty.Integer("Windows.Playbacks.FixedColumns", "5")</code>will not.
+>
+>The ActionScript.SetProperty.Enum function takes a string as the value parameter and internally converts that string to the correct enumeration type based on the current value of the property being set. WebAPI does something similar when initially parsing values but uses the function parameter type to determine this however as there are many enumeration types there is not a SetProperty function for each one as this would be impractical. You could do the following:
+>
+><code xml>
+ActionScript.SetProperty("Windows.Playbacks.ButtonSize",
+  Math.ToEnum(
+    "Avolites.Titan.Controllers",
+    "Avolites.Titan.Controllers.HandleButtonSize",
+    "Fixed")
+  )</code>
+>but that is very long-winded in comparison to the ''ActionScript.SetProperty.Enum'' function.
+And another hint: casting doesn't work inside code blocks, see http://forum.avolites.com/viewtopic.php?f=20&t=5783:
+>It appears that you cannot use the cast operator within a statement block. It tries to get the function being called but cannot find it inside the statement block.
+===== Datatypes in this Wiki =====
+Here is a list of the primitive types covered in this wiki:
 <nspages macros:type -h1 -simpleList -textPages="">
+And the more complex object types:
+<nspages macros:type:object -h1 -simpleList -textPages="">
 ----