IDENID   

Equivalent PK functions: PK_PART_find_entity_by_ident

IDENID ( contxt, id, srtype, entity, ifail )
============================================

  Identify entity by identifier

    Can be called from the GO.

Receives:
  KI_tag_part              *contxt         --- entity giving context for search
  KI_int_id                *id             --- id of required entity
  KI_cod_ty                *srtype         --- type of required entity
                                           --- ( one of TYTOIN, TYTORG, TYTOSH,
                                           ---  TYTOFA, TYTOLO, TYTOED, TYTOVX,
                                           ---  TYGESU, TYGECU, TYGEPT, TYGETF,
                                           ---  TYADAT, TYADLI, TYADFE )

Returns:
  KI_tag_entity            *entity         --- required entity
  KI_cod_error             *ifail          --- error code

Specific errors:
  KI_bad_type_combn         'srtype' inconsistent with 'contxt'
  KI_bad_type               'srtype' is invalid
  KI_not_found              'id' not found

Description:
  The part 'contxt' is searched for an entity with identifier 'id' of type
  'srtype'; this entity is returned as 'entity'. The acceptable combinations
  of entity and context are as follows :

           Entity                               Context
           ============================================
           Instance, transform                 Assembly
           Shell, region, face, loop, edge,
           vertex                              Body
           Surface, curve, point
             attached to topology              Body
           Surface, curve, point
             (construction)                    Body or Assembly
           Feature, attribute, list            Body or Assembly

  Since IDENID incurs a significant overhead, it should not be used for
  operations where efficiency is of critical importance; such operations
  should make direct use tags to access model entities.

  See OUIDEN for further explanation about identifiers.