PK_range_result_t

typedef int PK_range_result_t;

Used in:

PK_ENTITY_range_r_t
PK_ENTITY_range_vector_r_t
PK_GEOM_range
PK_GEOM_range_array
PK_GEOM_range_array_vector
PK_GEOM_range_vector
PK_GEOM_range_vector_many
PK_TOPOL_range
PK_TOPOL_range_array
PK_TOPOL_range_array_vector
PK_TOPOL_range_geom
PK_TOPOL_range_geom_array
PK_TOPOL_range_vector

PK_range_result_t has four values:
    PK_range_result_found_c          separation successfully found
    PK_range_result_lower_c          minimum separation less than provided
                                     lower bound
    PK_range_result_upper_c          no separation discovered less than
                                     provided upper bound
    PK_range_result_not_found_c      the identification of the separation
                                     failed

In cases where a range function's option structure allows bounds to be set on
the separation distance, this datatype is used to indicate whether an
allowed solution has been found. The result PK_range_result_not_found_c is
used in those PK functions calculating multiple closest approach queries to
indicate which queries were not successfully completed.