PK_ATTRIB_set_named_string   


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.