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.