 |
PK_ATTRIB_cb_f_t |
|
typedef PK_LOGICAL_t (*PK_ATTRIB_cb_f_t)
(
--- received arguments ---
const PK_ATTDEF_sf_2_t *attdef_sf, --- attribute definition standard
--- form
const int lengths[], --- attribute field lengths
const PK_ATTRIB_field_values_t values[], --- attribute field values
PK_POINTER_t context --- context
);
This is the type definition for the external callback functions expected by
PK_PART_ask_attribs_cb in determining whether to select attributes. The
functions themselves are to be provided by the application.
Used in:
PK_ATTRIB_cb_t
PK_PART_ask_attribs_cb
The function receives four arguments: the standard form of the attribute
definition, the length of each array of attribute field values, the arrays of
attribute field values, and any context information originally given to
PK_PART_ask_attribs_cb.
The size of the field length and value arrays is the number of fields given in
PK_ATTDEF_sf_2_t. For each field length, the corresponding value will be an
array of that size. If the number of fields is 0, the arrays will be NULL. If
any field is empty, its length will be 0 and its corresponding value will be
NULL.
The function returns PK_LOGICAL_true if the attribute matches the application's
selection criteria, and PK_LOGICAL_false otherwise.