xpxPutInstance

FUNCTION xpxPutInstance (instanceId : GENERIC;
                         attrValues : GENERIC) 
                         status     : INTEGER;

The xpxPutInstance function can be used to set attribute values to all attributes in the specified instance instanceId. The attribute values are specified in the attrValues argument. This argument must be specified as an entity constructor. If the actual instance type is an subtype, then an entity constructor for the actual subtype plus an entity constructor for each supertype must be specified with the entity constructor concatenation operator (||) between each entity constructor. Empty entity constructors must be specified for entities without attributes.
An indeterminate value for an attribute value will result in an unset attribute value.

Arguments

Return Value

Options

Example

status := xpxPutInstance(aLineInst, tar::LINE(tar::POINT(1.0, 2.0, 3.0), tar::POINT(10.0, 20.0, 30.0)));

status := xpxCreateInstanceBN(xpxTargetModelId, 'POINT', p1);
status := xpxPutInstance(p1, tar::POINT(1.0, 2.0, 3.0));
status := xpxCreateInstanceBN(xpxTargetModelId, 'POINT', p2);
status := xpxPutInstance(p2, tar::POINT(10.0, 20.0, 30.0));
status := xpxCreateInstanceBN(xpxTargetModelId, 'LINE', aLineInst);
status := xpxPutInstance(aLineInst, tar::LINE(p1, p2));

See also