PK_ATTRIB_ask_named_string

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

--- returned arguments ---
char    **const string              --- pointer to character string
                                    --- (possibly NULL)
)


This function returns the character string stored in 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 string field


If field number 'field_no' is a character string field containing no
characters, then the character string is set to NULL.

See Attribute processing for more information.

See Using named fields for information using named attributes.