PK_ERROR_code_t  PK_TOPOL_remove_body_component
(
--- received arguments ---
const PK_TOPOL_t  topol,     --- a topological entity in required component

--- returned arguments ---
PK_BODY_t  *const body       --- result body
)


This function extracts a connected component of a body as a new body.


Specific Errors:
    PK_ERROR_unsuitable_entity    given region is not solid


The given topological entity topol may be a vertex, edge, face, or solid
region.  The function determines the connected component of the owning body
which contains topol and removes it into another body.  If the body is not
disjoint then body will be PK_ENTITY_null.