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               (MILD) The attribute does not have a field
                                           with this name
    PK_ERROR_field_of_wrong_type    (MILD) The field is not a string field
    PK_ERROR_bad_value              (MILD) The field data is in some way
                                           invalid for the intended field.
    PK_ERROR_not_same_length        (MILD) The 'attrib' is a no-roll attribute
                                           and the length of 'string' is not
                                           equal to the existing field length


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.

See here for more information about attribute processing.

See here for more information about using named attribute fields.