PK_ENTITY_ask_first_attrib

PK_ERROR_code_t    PK_ENTITY_ask_first_attrib
(
--- received arguments ---
PK_ENTITY_t        entity,          --- entity
PK_ATTDEF_t        attdef,          --- attribute definition

--- returned arguments ---
PK_ATTRIB_t *const attrib           --- an attribute on entity of given attdef.
                                    --- (possibly PK_ENTITY_null)
)


This function returns an attribute with the given attribute definition
attached to the given entity.


If there are no such attributes, then PK_ENTITY_null is returned.
When there are multiple attributes attached an arbitrary one is returned.

This function is mainly intended for use with attributes of classes 1-5
which only allow a single attribute with a given definition to be attached
to an entity.