PK_BODY_ask_regions

PK_ERROR_code_t     PK_BODY_ask_regions
(
--- received arguments ---
PK_BODY_t           body,           --- a body

--- returned arguments ---
int          *const n_regions,      --- number of regions (>= 1)
PK_REGION_t **const regions         --- regions (optional)
)


This function returns the regions of the given body.


Depending upon the configuration of the 'body' ( see PK_BODY_ask_config ) this
function returns:
    PK_BODY_config_standard_c      all regions of the standard 'body'

    PK_BODY_config_compound_c      all regions of all children of the
                                   compound 'body'

    PK_BODY_config_child_c         all regions of the child 'body'

The body's infinite region will always be the first one in the array.

The output array 'regions' is optional. If it is set to NULL, the function
will only compute the number of regions in the body.

See Data structure enquiries for related functions.