PK_LOOP_ask_first_fin

PK_ERROR_code_t PK_LOOP_ask_first_fin
(
--- received arguments ---
PK_LOOP_t       loop,        --- a loop

--- returned arguments ---
PK_FIN_t *const first_fin    --- the first fin (possibly PK_ENTITY_null)
)


This function returns the first fin in the given loop.


If the loop is an isolated loop, and so has no fins, then PK_ENTITY_null will
be returned.

This function should be used in conjunction with PK_FIN_ask_next_of_loop to
scan the fins of a loop.