PK_LATTICE_do_for_all_lballs

PK_ERROR_code_t     PK_LATTICE_do_for_all_lballs
(
--- received arguments ---
PK_LATTICE_t        lattice,            --- a lattice
PK_LBALL_cb_f_t     cb_fn,              --- the callback function
PK_POINTER_t        data,               --- application data
PK_LOGICAL_t        thread_safe         --- whether the callback function is
                                        --- thread safe
)


This function calls the given callback function for every lball in the given
'lattice'.


Specific Errors:
    PK_ERROR_callback_failed    the callback function failed. (MILD)


'data' is a pointer to application data that may be used to communicate
between the application and its callback function.

The argument 'thread_safe' specifies whether the callback function may be
called from more than one thread simultaneously. If set to PK_LOGICAL_true,
and SMP is enabled within Parasolid, then the callback function may be called
from multiple threads, and it is the application's responsiblity to ensure that
the function is thread-safe. If set to PK_LOGICAL_false, then Parasolid will
ensure that the callback function is not called from multiple threads, even
when SMP is switched on in Parasolid.