PK_ERROR_code_t PK_ATTRIB_set_named_string
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
const char *field_name, --- field name
const char *string --- null-terminated string to set
--- (possibly NULL or "")
)
This function copies string into 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
The new data replaces any existing data stored in the field.
If a zero length string ("") or NULL is given as the string argument,
the field is set to be empty.