PK_ATTRIB_ask_named_pointers

PK_ERROR_code_t PK_ATTRIB_ask_named_pointers
(
--- received arguments ---
PK_ATTRIB_t          attrib,              --- attribute
const char          *field_name,          --- field name

--- returned arguments ---
int           *const n_pointers,          --- number of pointers (>=0)
PK_POINTER_t **const pointers             --- pointers (optional)
)


This function returns the array of pointers from field 'field_name'
of the given attribute.


Specific Errors:
    PK_ERROR_bad_name               The attribute does not have a field with
                                    this name
    PK_ERROR_field_of_wrong_type    The field is not a pointer field


The output array 'pointers' is optional.  If it is set to NULL, the function
will only return the number of pointers in the field.

See Attribute processing for more information.

See Using named fields for information using named attributes.