 |
openDAQ
Open data acquisition platform
|
| |
|
openDAQ
Open data acquisition platform
|
|
| |
Structs are immutable objects that contain a set of key-value pairs. The key, as well as the types of each associated value for each struct are defined in advance within a Struct type that has the same name as the Struct. More...
Structs are immutable objects that contain a set of key-value pairs. The key, as well as the types of each associated value for each struct are defined in advance within a Struct type that has the same name as the Struct.
The Struct types are stored within a Type manager. In any given instance of openDAQ, a single Type manager should exist that is part of its Context.
When creating a Struct, the Type manager is used to validate the given dictionary of keys and values against the Struct type stored within the manager. If no type with the given Struct name is currently stored, a default type is created using the Struct field names and values as its parameters. When creating a Struct, fields that are part of the Struct type can be omitted. If so, they will be replaced by either null or, if provided by the Struct type, the default value of the field.
In the case that a field name is present that is not part of the struct type, or if the value type of the field does not match, construction of the Struct will fail.
NOTE: Field values of fields with the Core type ctUndefined can hold any value, regardless of its type.
Structs are an openDAQ core type (ctStruct). Several objects in openDAQ such as an Unit, or DataDescriptor are Structs, allowing for access to their fields through Struct methods. Such objects are, by definition, immutable - their fields cannot be modified. In order to change the value of a Struct-type object, a new Struct must be created.
A Struct can only have fields of Core type: ctBool, ctInt, ctFloat, ctString, ctList, ctDict, ctRatio, ctComplexNumber, ctStruct, or ctUndefined. Additionally, all Container types (ctList, ctDict) should only have values of the aforementioned types.
Public Member Functions | |
| StructTypePtr | getStructType () const |
| Gets the Struct's type. More... | |
| ListPtr< IString > | getFieldNames () const |
| Gets a list of all Struct field names. More... | |
| ListPtr< IBaseObject > | getFieldValues () const |
| Gets a list of all Struct field values. More... | |
| BaseObjectPtr | get (const StringPtr &name) const |
| Gets the value of a field with the given name. More... | |
| DictPtr< IString, IBaseObject > | getAsDictionary () const |
| Gets the field names and values of the Struct as a Dictionary. More... | |
| Bool | hasField (const StringPtr &name) const |
| Checks whether a field with the given name exists in the Struct. More... | |
|
inline |
Gets the value of a field with the given name.
| name | The name of the queried field. |
|
inline |
Gets the field names and values of the Struct as a Dictionary.
Gets a list of all Struct field names.
The list of names will be of equal length to the list of values. Additionally, the name of a field at any given index corresponds to the value stored in the list of values.
|
inline |
Gets a list of all Struct field values.
The list of names will be of equal length to the list of values. Additionally, the name of a field at any given index corresponds to the value stored in the list of values.
|
inline |
Gets the Struct's type.
|
inline |
Checks whether a field with the given name exists in the Struct.
| name | The name of the checked field. |
name exists in the Struct; false otherwise. 
1.8.17