PK_ERROR_code_t   PK_ATTRIB_set_named_ustring
(
--- received arguments ---
PK_ATTRIB_t       attrib,       --- attribute
const char       *field_name,   --- field name
const PK_UCHAR_t *string        --- null-terminated string to set
                                --- (possibly NULL or "")
)


This function copies Unicode 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 Unicode 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.

Unicode defines a special 16-bit character (the Byte Order Mark: U+FEFF)
which is used to signal the byte serialization used by a particular
computer architecture. If a Unicode string is presented to Parasolid
with this marker reversed (ie, the first element is the sequence U+FFFE)
then Parasolid will reverse the byte order of the given string;
subsequent enquiries will receive a correctly ordered sequence for the
current machine.