PK_ERROR_code_t    PK_PART_find_entity_by_ident
(
--- received arguments ---
PK_PART_t          part,        --- part in which to search for entity
PK_CLASS_t         class,       --- class of entity
int                identifier,  --- identifier of entity

--- returned arguments ---
PK_ENTITY_t *const entity       --- entity (may be PK_ENTITY_null)
)


This function searches the given part for an entity of the given class
with the given identifier.


Specific Errors:
    PK_ERROR_bad_class            given class is invalid
    PK_ERROR_bad_class_combn      given class is inconsistent with given part


If the class of part is PK_CLASS_body then the class of entities to be
found may be one of:

        PK_CLASS_region
        PK_CLASS_shell
        PK_CLASS_face
        PK_CLASS_loop
        PK_CLASS_edge
        PK_CLASS_vertex
        PK_CLASS_surf   either attached to a  face   or construction geometry
        PK_CLASS_curve  either attached to an edge   or construction geometry
        PK_CLASS_point  either attached to a  vertex or construction geometry
        PK_CLASS_group
        PK_CLASS_attrib
        PK_CLASS_ki_list

If the class of part is PK_CLASS_assembly, then the class of entities to be
found may be one of:

        PK_CLASS_instance
        PK_CLASS_transf
        PK_CLASS_surf   construction geometry
        PK_CLASS_curve  construction geometry
        PK_CLASS_point  construction geometry
        PK_CLASS_group
        PK_CLASS_attrib
        PK_CLASS_ki_list

If an entity with the given identifier is not found then PK_ENTITY_null is
returned.