PK_BODY_ask_first_face

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

--- returned arguments ---
PK_FACE_t *const first_face      --- a face (possibly PK_ENTITY_null)
)


This function returns a face in the given body, if one exists, otherwise
PK_ENTITY_null.


Specific Errors:
    PK_ERROR_unsuitable_entity     'body' is a child body


This function should be used in conjunction with PK_FACE_ask_next_in_body
to scan the faces in a body.

See Data structure enquiries for related functions.