PK_MVERTEX_ask_mvertices_ring

PK_ERROR_code_t      PK_MVERTEX_ask_mvertices_ring
(
--- received arguments ---
PK_MVERTEX_t         mvertex,          --- the 'mvertex'

--- returned arguments ---
int           *const n_mvertices_ring, --- the number of mvertices
PK_MVERTEX_t **const mvertices_ring    --- the mvertices (optional)
)


This function returns the ring of mvertices around the given 'mvertex'.


The ring of mvertices contains all mvertices which are at the other end of an
mfin which has 'mvertex' at one end.
The output array 'mvertices_ring' is optional.  If it is set to NULL,
the function will only compute the number of mvertices in the ring.