TipcMsgUpdateNamedReal16

TipcMsgUpdateNamedReal16 — update a REAL16 field in a message with new data

T_BOOL TipcMsgUpdateNamedReal16(msg, name, value) 
T_IPC_MSG msg; 
T_STR name; 
T_REAL16 value;

msg — message to update field in

name — name of the field

value — value of the field

TRUE if the update was successful, FALSE otherwise.

If TipcMsgUpdateNamedReal16 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

TipcMsgUpdateNamedReal16 updates a REAL16 field 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; 
if (!TipcMsgUpdateNamedReal16(msg, "data", data)) { 
  return;  /* error */ 
}