TipcMsgAddNamedReal16

Name

TipcMsgAddNamedReal16 — add a REAL16 field to a message using a name

Synopsis

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

Arguments

msg — message to add field to

name — name of the field

value — value of the field

Return Values

TRUE if the addition was successful, FALSE otherwise.

Diagnostics

If TipcMsgAddNamedReal16 fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMsgAddNamedReal16 adds a REAL16 field to a message, associating that field with a name. If the name already exists in the message, this fails, and the field is not added to the message.

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.

See Also

TipcMsgAppendReal16, TipcMsgUpdateNamedReal16, TipcMsgGetNamedReal16

Examples

This example creates a message and adds a REAL16 value to it:

T_IPC_MSG msg; 
T_BOOL status; 
 
msg = TipcMsgCreate(TipcMtLookupByNum(T_MT_INFO)); 
if (msg == NULL) { 
  return;  /* error */ 
} 
 
status = TipcMsgAddNamedReal16(msg, "foo", (T_REAL16)5.0); 
if (status == FALSE) { 
  return;  /* error */ 
}