PK_ERROR_code_t   PK_GROUP_remove_entities
(
--- received arguments ---
PK_GROUP_t        group,        --- group
int               n_entities,   --- number of entities
const PK_ENTITY_t entities[],   --- entities

--- returned arguments ---
int        *const n_removed     --- number of entities removed from group
)


This function removes from the given group, any entities which are also in
the given array of entities.


The array entities may include duplicates and entities which are not
in the given group.