company logo

Instance - Instance string

In order to simplify passing instance values to different functions, automatic conversion from string to instance is supported by this class. Since an instance value is a complex instance, it is structured according to a type definition. Providing instance values in a proper internal instance format is rather complicated. Hence, instance values can be passed as typed strings in one of the supported string formats (usually ESDF). Besides ESDF, instances can be provided in OIF or XML format.

The instance value requires a type definition for the Instance in order to convert the instance properly. The type definition, however, need not to be provided by the application. It will be assigned to the string instance, when instance conversion is required, e.g. when calling Property ::insert( vInstance,iPosition ) and passing the instance as parameter to the function. In this case, the insert() function assigns the proper type definition to the instance value.

An instance object might be reused in several function calls to any property handle. The type definition for the instance will be updated automatically, whenever required.

In order to change string type or set data type additional functions are available in TypedString .