aSimpleChildClassObject = castValue(aSimpleParentClassObject)

The typical usage scenario of this function is mapping from generic values like Strings, Integers, and Floats to more specific types. For example, the following InputValues class has to be mapped to the OutputValues class:

Frequently, classes such as OuputValues is imported from XML Schema files and their simple types are not plain Strings or Integers but more specific types. For example, the String related types in the castValue example look like

and the numeric types are defined as

If you want to assign for example a String to a more specific type such as StringEnumType, then you have to downcast the values as shown in the example action below. But in contrast to the standard cast() function, castValue() will check the enumeration constraint, i.e. whether the String takes only the allowed values VAL1, VAL2, or VAL3. This happens at runtime. If the constraint is violated, an exception is thrown at the very place the mis-assignment takes place. Thus, it is recommended to use castValue() wherever possible. The error codes are listed below.

Example File (Builder project Basic Modeling/Data):

<your example path>\Basic Modeling\Data\uml\castValue.xml

Hierarchies of Constraints

It is possible that classes inherit from already constraint types. The following diagram shows the class MinMaxLengthType that specializes the class PatternType. This means that MinMaxLengthType inherits all constraints of PatternType whereas the constraints of the child class override the parent constraints. For example, MinMaxLengthType has the constraint maxLength = 10 which overrides the constraint maxLength = 20 of PatternType.

The same applies to enumerations. This means effectively that the enumeration values are merged. For example, the allowed values of AdditionalEnumeration objects are SUBVAL1, SUBVAL2, VAL1, VAL2, VAL3.

Errors

The error domain (type) is FUMSMCV. Allowed error codes are:

Example: