PK_LBALL_ask_lballs_adj_r_t

struct PK_LBALL_ask_lballs_adj_r_s
    {
    int         r_t_version;        --- version number of return structure
    int         n_lballs_adj;       --- number of adjacent lballs
    PK_LBALL_t *lballs_adj;         --- adjacent lballs
    };
typedef struct PK_LBALL_ask_lballs_adj_r_s PK_LBALL_ask_lballs_adj_r_t;


A structure packaging the adjacent lballs of the given 'lball'.

Used in:

PK_LBALL_ask_lballs_adj
PK_LBALL_ask_lballs_adj_r_f

The structure has the following fields:

'n_lballs_adj'     The number of adjacent lballs to the 'lball'.

'lballs_adj'       An array of length 'n_lballs_adj', each element holding an
                   lball.

The output array 'lballs_adj' is optional.  If the option 'want_lballs' is set
to PK_LOGICAL_false, the function will only compute the number of adjacent
lballs to the 'lball'.

The function PK_LBALL_ask_lballs_adj_r_f may be used to free associated
memory.