TipcMsgUpdateNamedReal16Array

TipcMsgUpdateNamedReal16Array — update a field containing an array of REAL16 fields in a message with new data

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

msg — message to update field in

name — name of the field

value — value of the field

size — number of elements in the field

TRUE if the update was successful, FALSE otherwise.

If TipcMsgUpdateNamedReal16Array 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 — the message 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

TipcMsgUpdateNamedReal16Array updates a field containing an array of REAL16 fields in a message, associating that field with a name.


	Not all platforms fully support the REAL16 type. While some platforms can manipulate them as uninterpreted bytes, they can neither manipulate nor interpret them as numbers.

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

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