PK_ERROR_code_t PK_ATTRIB_set_string
(
--- received arguments ---
PK_ATTRIB_t     attrib,             --- attribute
int             field_no,           --- field number (>= 0)
const char     *string              --- null-terminated string to set
                                    --- (possibly NULL or "")
)


This function copies string into 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


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.