 |
PK_ATTRIB_ask_string |
|
PK_ERROR_code_t PK_ATTRIB_ask_string
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
int field_no, --- field number (>= 0)
--- returned arguments ---
char **const string --- pointer to character string
--- (possibly NULL)
)
This function returns the character string stored in field number 'field_no'
of the given attribute.
Specific Errors:
PK_ERROR_bad_field_number The attribute does not have a field with
this number
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.