PK_ATTRIB_ask_named_axes

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

--- returned arguments ---
int            *const n_axes,       --- number of axes (>=0)
PK_AXIS1_sf_t **const axes          --- axes (optional)
)


This function returns the array of axes 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 an axis field


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

See Attribute processing for more information.

See Using named fields for information using named attributes.