TipcMsgUpdateNamedUtf8Array

TipcMsgUpdateNamedUtf8Array — update a named UTF8_ARRAY field in a message with new data

T_BOOL TipcMsgUpdateNamedUtf8Array(msg, name, *value, size) 
T_IPC_MSG msg; 
T_STR name; 
T_STR *value; 
T_INT4 size;

msg — message to update field in

name — name of the field

value — new value of the field

size — number of elements in the field

TRUE if the update was successful, FALSE otherwise.

If TipcMsgUpdateNamedUtf8Array fails, it returns FALSE and sets the global SmartSockets error number to one of:

T_ERR_NULL_PTR — msg, name or value is null

T_ERR_MSG_INVALID — msg was not a valid message

T_ERR_FT_MISMATCH — the message type grammar did not match the fields in the message

T_ERR_READ_ONLY — msg was marked read-only. This happens if the message is a field in another message.

T_ERR_VALUE_INVALID — value was not a valid value

TipcMsgUpdateNamedUtf8Array updates a UTF8_ARRAY field specified by field name.

This example changes the value of the named field "data":

T_STR *data; 
T_INT4 size; 
if (!TipcMsgUpdateNamedUtf8Array(msg, "data", data, size)) { 
  return;  /* error */ 
}