OpenDOF Project
DOFObjectID DOFObjectID_Create_AttributeObjectID ( const DOFObjectID  self,
const DOFObjectIDAttributeType  type,
const DOFObjectID  objectID 
)

Create a new DOFObjectID by augmenting an existing DOFObjectID with specified Attribute type and a DOFObjectID.

Resource Management:
This function allocates resources that must later be freed by calling DOFObjectID_Destroy.
Note
This function stores Attributes in increasing numerical order by type, as required by the protocol specification.
Parameters
selfThe original DOFObjectID, which remains unchanged. This should not be NULL.
typeThe ID of the new Attribute. See DOFObjectIDAttributeType. Valid numeric range is 0 <= type <= 127.
objectIDThe new Attribute's data as a DOFObjectID. This should not be NULL, and the total length of the object ID (in byte form, see DOFObjectID_GetBytesSize) should be 255 bytes or less. The data must be appropriate for the given attribute type.
Returns
The new DOFObjectID.
Exceptions
NULLis returned if
  • an invalid parameter is detected; or
  • the existing objectID already contains an Attribute with the same type; or
  • insufficient resources exist to create the DOFObjectID.
core-c-dof-oal Version 8.0.1 Build 0
2018-01-22