PK_REGION_ask_shells

PK_ERROR_code_t    PK_REGION_ask_shells
(
--- received arguments ---
PK_REGION_t        region,          --- a region

--- returned arguments ---
int         *const n_shells,        --- number of shells (>= 0)
PK_SHELL_t **const shells           --- shells (optional)
)


This function returns the set of shells bounding the given region.


The outer shell of the region (where this is meaningful) is not distinguished.

The output array 'shells' is optional. If it is set to NULL, the function
will only compute the number of shells bounding the region.