PK_BODY_remove_from_parents

PK_ERROR_code_t                        PK_BODY_remove_from_parents
(
--- received arguments ---
int                                    n_children, --- number of children
const PK_BODY_t                        children[], --- children
const PK_BODY_remove_from_parents_o_t *options     --- options
)


This function removes the given child bodies from their parents.


Specific Errors:
    PK_ERROR_unsuitable_entity          a given body is not a child body (MILD)


The removed children have the same tags as before, and are in the same
partition as their parents.

The children need not have the same parents. Duplicate children are not
allowed.

A removed child will be exactly the same as it was before it was added to the
compound body, including node-ids, groups, and attributes, provided it was not
modified while in the compound body; with the following exceptions:

    - node ids of geometric entities may not be the same as before
    - attributes on geometric entities may not be the same as before

If a geometric entity needs to be unshared (i.e. copied), then all its
attributes will also be copied. No attribute callbacks are called as a result
of copying these attributes.