Data Types
Control supports the following variable types:
| Name | Value range | Comment | Integer Constant | Integer value |
|---|---|---|---|---|
| anytype |
One of the types listed below, depending on the first variable assignment (For further information, see data type detail page) |
ANYTYPE_VAR | 1572864 | |
| atime | Time of the alarm, with extra index for several simultaneous alarms | ATIME_VAR | 2424832 | |
| bit32 | 0 to +4294967295 |
Bit pattern (32 bit) (For further information, see data type detail page) |
BIT32_VAR | 589824 |
| bit 64 |
0 to +10146744073709551615 |
Bit pattern (64 bit) (For further information, see data type detail page) |
BIT64_VAR | 4980736 |
| blob |
Binary large objects (For further information, see data type detail page) |
BLOB_VAR | 3014656 | |
| bool | 0, 1 or true, false | Binary value (1 bit) | BOOL_VAR | 262144 |
| char | 0 to 255 |
Character (1 byte). This can also represent a numerical data type that takes the values 0 to 255. An example for this is the _lock.._man_type datapoint config attribute. |
CHAR_VAR | 655360 |
| dbCommand | Access variable for ADO interface | |||
| dbConnection | Access variable for ADO interface | |||
| dbRecordset | Access variable for ADO interface | |||
| double | -1.79769e+308 to +1.79769e+308 | Floating point value (64 bit) | 458752 | |
| dpIdentifier | datapoint designation | DPIDENTIFIER_VAR | 720896 | |
| dyn_anytype |
Dynamic array of elements of any data type (For further information, see data type detail page) |
DYN_ANYTYPE_VAR | 2293760 | |
| dyn_atime |
Dynamic array of atime. dyn_atime contains atime, thus it is a mix of DpIdentifier and time with count, which include the config and the detail, but not the DPE, e.g.: ":_alert_hdl.2" + 2009.08.12 19:11:54.356 (0) (For further information, see data type detail page) |
DYN_ATIME_VAR | 2490368 | |
| dyn_bit32 |
Dynamic bit pattern array (32 bit) (For further information, see data type detail page) |
DYN_BIT32_VAR | 1245184 | |
| dyn_bit64 |
Dynamic bit pattern array (64 bit) (For further information, see data type detail page) |
DYN_BIT64_VAR | 5046272 | |
| dyn_blob |
Dynamic blob (For further information, see data type detail page) |
DYN_BLOB_VAR | 3080192 | |
| dyn_bool |
Dynamic array of binary values (For further information, see data type detail page) |
DYN_BOOL_VAR | 917504 | |
| dyn_char |
Dynamic character array (For further information, see data type detail page) |
DYN_CHAR_VAR | 1310720 | |
| dyn_errClass |
Dynamic array of WinCC OA internal error class (For further information, see data type detail page) |
DYN_ERRCLASS_VAR | 2883584 | |
| dyn_float |
Dynamic array of floating point values (For further information, see data type detail page) |
DYN_FLOAT_VAR | 1114112 | |
| dyn_int |
Dynamic array of integer values (32 bit) (For further information, see data type detail page) |
DYN_INT_VAR | 983040 | |
| dyn_langString |
Dynamic array of language strings (For further information, see data type detail page and Multi-language capability ). |
DYN_LANGSTRING_VAR | 2686976 | |
| dyn_long |
Dynamic array of integer values (64 bit) (For further information, see data type detail page) |
DYN_LONG_VAR | 4653056 | |
| dyn_mapping |
Dynamic Mapping. Mapping saves arbitrary key/value pairs. The pairs are saved in two arrays. (For further information, see data type detail page) |
DYN_MAPPING_VAR | 3866624 | |
| dyn_mixed |
Dynamic array of mixed elements. Each mixed element can be of a different data type (For further information, see data type detail page) |
DYN_MIXED_VAR | 4063232 | |
| dyn_shape | Dynamic array of dynamic arrays of pointers for graphic elements | DYN_SHAPE_VAR | 5177344 | |
| dyn_string |
Dynamic array of character strings (For further information, see data type detail page) |
DYN_STRING_VAR | 1179648 | |
| dyn_time |
Dynamic array of values in the internal time format (For further information, see data type detail page) |
DYN_TIME_VAR | 851968 | |
| dyn_uint |
Dynamic array of positive integer values (32 bit) (For further information, see data type detail page) |
DYN_UINT_VAR | 1048576 | |
| dyn_ulong |
Dynamic array of positive integer values (64 bit) (For further information, see data type detail page) |
DYN_ULONG_VAR | 4849664 | |
| dyn_dyn_anytype |
Dynamic array of dynamic array of elements of any data type (For further information, see data type detail page) |
DYN_DYN_ANYTYPE_VAR | 2359296 | |
| dyn_dyn_atime |
Dynamic array of dynamic atime arrays (For further information, see data type detail page) |
DYN_DYN_ATIME_VAR | 2555904 | |
| dyn_dyn_bit32 |
Dynamic array of dynamic bit pattern arrays (32 bit) (For further information, see data type detail page) |
DYN_DYN_BIT32_VAR | 2097152 | |
| dyn_dyn_bit64 |
Dynamic array of dynamic bit pattern arrays (64 bit) (For further information, see data type detail page) |
DYN_DYN_BIT64_VAR | 5111808 | |
| dyn_dyn_blob |
Dynamic blob array (For further information, see data type detail page) |
DYN_DYN_BLOB_VAR | 3604480 | |
| dyn_dyn_bool |
Dynamic array of dynamic arrays of binary values (For further information, see data type detail page) |
DYN_DYN_BOOL_VAR | 1769472 | |
| dyn_dyn_char |
Dynamic array of dynamic character arrays (For further information, see data type detail page) |
DYN_DYN_CHAR_VAR | 2162688 | |
| dyn_dyn_errClass |
Dynamic array of dynamic arrays of error classes (For further information, see data type detail page) |
DYN_DYN_ERRCLASS_VAR | 2949120 | |
| dyn_dyn_float |
Dynamic array of dynamic arrays of floating point values (For further information, see data type detail page) |
DYN_DYN_FLOAT_VAR | 1966080 | |
| dyn_dyn_int |
Dynamic array of dynamic arrays of integer values (32 bit) (For further information, see data type detail page) |
DYN_DYN_INT_VAR | 1835008 | |
| dyn_dyn_langString |
Dynamic array of dynamic arrays of multi-language strings (For further information, see data type detail page and Multi-language capability ) |
DYN_DYN_LANGSTRING_VAR | 2752512 | |
| dyn_dyn_long |
Dynamic array of dynamic arrays of integer values (64 bit) (For further information, see data type detail page) |
DYN_DYN_LONG_VAR | 4718592 | |
| dyn_dyn_mapping |
Dynamic array of arrays of mappings (For further information, see data type detail page) |
DYN_DYN_MAPPING_VAR | 3932160 | |
| dyn_dyn_mixed |
Dynamic array of arrays of mixed elements. Each mixed element can be of a different data type (For further information, see data type detail page) |
DYN_DYN_MIXED_VAR | 4128768 | |
| dyn_dyn_shape |
Dynamic array of dynamic arrays of pointers for graphic elements. (For further information, see data type detail page) |
DYN_DYN_SHAPE_VAR | 5242880 | |
| dyn_dyn_string |
Dynamic array of dynamic arrays of character strings (For further information, see data type detail page) |
DYN_DYN_STRING_VAR | 2031616 | |
| dyn_dyn_time |
Dynamic array of arrays of values in the internal time format (For further information, see data type detail page) Note:
In CTRL, times before 1970.1.1 00:00:00 are
not supported under Windows. |
DYN_DYN_TIME_VAR | 1703936 | |
| dyn_dyn_uint |
Dynamic array of dynamic arrays of positive integer values (32 bit) (For further information, see data type detail page) |
DYN_DYN_UINT_VAR | 1900544 | |
| dyn_dyn_ulong |
Dynamic array of dynamic arrays of positive integer values (64 bit) (For further information, see data type detail page) |
DYN_DYN_ULONG_VAR | 4915200 | |
| enum |
Datatype consisting of an enumeration of values (For further information, see data type detail page) |
|||
| errClass | Specifies the error classes | ERRCLASS_VAR | 2818048 | |
| file | File pointer | FILE_VAR | 1507328 | |
| float | -1.79769e+308 to +1.79769e+308 |
Floating point value. float in WinCC OA == double (64 bit), independent whether on a datapoint element or in a CTRL script. |
FLOAT_VAR | 458752 |
| idispatch | Data type for methods of ActiveX objects | IDISPATCH_VAR | 3538944 | |
| int | -2147483648 to +2147483647 | Integer value (32 bit) (For further information, see data type detail page) | INT_VAR | 327680 |
| langString |
Language string (For further information, see data type detail page, Multilingual functionality). |
LANGSTRING_VAR | 2621440 | |
| long | -9223372036854775808 to +9223372036854775807 |
Integer value (64 bit) (For further information, see data type detail page) |
LONG_VAR | 4587520 |
| mapping |
Mapping saves arbitrary key/value pairs. (For further information, see data type detail page) |
MAPPING_VAR | 3801088 | |
| mixed |
Contrary to anytype the variable type mixed gets each time a new type. (For further information, see data type detail page) |
MIXED_VAR | 3997696 | |
| shape | Pointer for graphic elements | SHAPE_VAR | 3473408 | |
| shared_ptr | shared pointer datatype (For further information, see data type detail page) | 3407872 | ||
| class_ptr | Only available classes/structs | class pointer datatype (For further information, see data type detail page) | ||
| string | Any number of characters | Character string (For further information, see data type detail page) | STRING_VAR | 524288 |
| time | 2*10^31s from 01.01.1970 (to 09 .01 .2038 04h14m07s) |
Internal time format (For further information, see data type
detail page)
Note:
In CTRL, times before 1970.1.1 00:00:00
are not supported under Windows. |
TIME_VAR | 196608 |
| uint | 0 to +4294967295 |
Positive integer value (32 bit) (For further information, see data type detail page) |
UINT_VAR | 393216 |
| unsigned | 0 to 4,294,967,295 | Positive integer value | ||
| ulong | 0 to +18446744073709551615 |
Positive integer value (64 bit) (For further information, see data type detail page) |
ULONG_VAR | 4784128 |
| va_list |
An arbitrary number of parameters is defined via va_list. (For further information, see data type detail page) |
VA_LIST_VAR | 1441792 | |
| vector | Vector datatype (For further information, see data type detail page) | 5636096 |