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.