PK_PART_ask_attribs_cb

PK_ERROR_code_t                   PK_PART_ask_attribs_cb
(
--- received arguments ---
PK_PART_t                         part,       --- part within which to select
                                              --- attributes
PK_ATTRIB_cb_f_t                  callback,   --- attribute selection callback
                                              --- function
PK_POINTER_t                      context,    --- context for callback function
const PK_PART_ask_attribs_cb_o_t *options,    --- options

--- returned arguments ---
int                        *const n_attribs,  --- number of attributes (>= 0)
PK_ATTRIB_t               **const attribs,    --- attributes
PK_ENTITY_t               **const owners      --- owning entities
)


This function returns selected attributes and their owners from entities
within the given 'part', using the 'callback' function to select attributes
from their definition and field values.


Specific Errors:
    PK_ERROR_child_body             (MILD) 'part' is a child body


If the 'callback' is non-null, it will be called for each attribute with the
standard form definition, field value information and 'context' as arguments.
Each attribute for which it returns PK_LOGICAL_false will be rejected.
If the 'part' is an assembly, only the attributes directly attached to the
assembly and its instances are passed to the 'callback' function. Further
subsetting of attributes passed can be specified in 'options'.

The function returns the selected attributes and their respective owning
entities if specified in 'options'. If the arrays 'attribs' and 'owners' are
non-null, then they will be of length 'n_attribs'.

See Using a callback function to select attributes from a part for
more information.