 |
PK_ATTRIB_set_named_ints |
|
PK_ERROR_code_t PK_ATTRIB_set_named_ints
(
--- received arguments ---
PK_ATTRIB_t attrib, --- attribute
const char *field_name, --- field name
int n_ints, --- number of ints (>= 0)
const int ints[] --- ints to set
)
This function copies 'ints' 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 an int 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 'n_ints' is not equal to the
existing field length
The new data replaces any existing data stored in the field.
If 'n_ints' is zero then 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.