PK_PART_find_entity_by_ident

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          (MILD) class is invalid
    PK_ERROR_bad_class_combn    (MILD) class is inconsistent with given part
    PK_ERROR_child_body         (MILD) part is a child body


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_lattice construction geometry
        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
        PK_CLASS_body    as a child body in a compound body

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_lattice construction geometry
        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.