PK_BODY_ask_components

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

--- returned arguments ---
int          *const n_components,      --- number of components (>= 1)
PK_SHELL_t  **const components         --- components (optional)
)


This function returns the components 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 components of the standard 'body'

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

    PK_BODY_config_child_c         all components of the child 'body'

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

See Data structure enquiries for related functions.