PK_ATTRIB_create_empty

PK_ERROR_code_t    PK_ATTRIB_create_empty
(
--- received arguments ---
PK_ENTITY_t        entity,          --- entity to attach to
PK_ATTDEF_t        attdef,          --- attribute definition

--- returned arguments ---
PK_ATTRIB_t *const attrib           --- created attribute
)


This function creates an attribute with the given definition with no data
(all fields of length zero), and attaches it to the given entity.


Specific Errors:
    PK_ERROR_existing_attrib        The entity may not own more than one
                                    attribute with the given definition
    PK_ERROR_wrong_entity           The entity may not own an attribute
                                    with the given definition