PTENFE   

Equivalent PK functions: PK_GROUP_add_entities

PTENFE ( featre, entity, ifail )
================================

  Put entities into feature

Receives:
  KI_tag_feature           *featre         --- feature
  KI_tag_list_entity       *entity         --- entities to be added

Returns:
  KI_cod_error             *ifail          --- failure code

Specific errors:
  KI_duplicate_list_item    entity appears twice in argument list
  KI_already_in_feat        entity is already in feature
  KI_not_in_same_part       entity and feature not in same part
  KI_wrong_type_for_feat    wrong entity in list

Description:

  'entity' may be either a single entity, or a list of entities. All
  the entities are added to the feature, provided they are of a permitted
  type, are contained in the same part as the feature and are not in the
  feature already. If any entity does not satisfy these criteria,
  an ifail will be returned, and the feature will be unchanged.

  If the feature belongs to an assembly the permitted types for 'entity' are
  instance, surface, curve and point.

  If the feature belongs to a body the permitted types for 'entity' are
  region, face, edge, vertex, surface, curve and point.

  Unless the feature is mixed (i.e. feature type is TYFEMX) its type must
  correspond to that of 'entity' (TYFESU for a surface etc.).