TipcMsgGetNamedReal16

Name

TipcMsgGetNamedReal16 — get a field with a REAL16 value from a message, using a name

Synopsis

T_BOOL TipcMsgGetNamedReal16(msg, name, value_return) 
T_IPC_MSG msg; 
T_STR name; 
T_REAL16 *value_return;

Arguments

msg — message to append field onto

name — name of the field

value_return — pointer to value of the field

Return Values

TRUE if the get was successful, FALSE otherwise.

Diagnostics

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

T_ERR_NULL_PTR — msg was null or name was null

T_ERR_MSG_INVALID — msg was not a valid message

Description

TipcMsgGetNamedReal16 gets the field specified by the name. The function fails if:

No field by this name exists.

The field associated with this name is not a REAL16 field.

The field associated with this name is unknown. See the TIBCO SmartSockets User’s Guide for more information on unknown field values.

Caution

If TipcMsgGetNamedReal16 returns FALSE, it does not store a value in value_return.

Do not modify the value in value_return. It points directly into an internal data structure.


	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.

Examples

This example gets a REAL16 field from an existing message:

T_IPC_MSG msg; 
T_BOOL status; 
T_REAL16 value; 
 
status = TipcMsgGetNamedReal16(msg, "foo", &value); 
if (status == FALSE) { 
  return;  /* error */ 
}