TipcMsgAddNamedReal16ArrayPtr

Name

TipcMsgAddNamedReal16ArrayPtr — add a field containing an array of REAL16 fields to a message using a name, and a pointer to the field value, rather than a copy

Synopsis

T_BOOL TipcMsgAddNamedReal16ArrayPtr(msg, name, value, size, field_return) 
T_IPC_MSG msg; 
T_STR name; 
T_REAL16 *value; 
T_INT4 size; 
T_IPC_MSG_FIELD *field_return; 

Arguments

msg — message to add field to

name — name of the field

value — value of the field

size — number of elements in the field

field_return — optional value to return field (use NULL if not needed)

Return Values

TRUE if the addition was successful, FALSE otherwise.

Diagnostics

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

Description

TipcMsgAddNamedReal16ArrayPtr adds a field containing an array of REAL16 fields 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. The value given is used as a pointer to the value, so the copy is made when the message is actually sent, not when the call is made. You must ensure that the data pointed to remains valid until the message is sent.

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

TipcMsgAppendReal16ArrayPtr, TipcMsgUpdateNamedReal16ArrayPtr, TipcMsgFieldUpdateReal16ArrayPtr

Examples

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

T_IPC_MT mt; 
T_IPC_MSG msg; 
T_REAL16 data[10]; 
T_IPC_MSG_FIELD field; 
 
#define USER_MT_REAL16_ARRAY_TEST 100 
mt = TipcMtCreate("real16_array_test", USER_MT_REAL16_ARRAY_TEST, 
                  "real16_array"); 
if (mt == NULL) { 
  return;  /* error */ 
} 
 
msg = TipcMsgCreate(mt); 
if (msg == NULL) { 
  return;  /* error */ 
} 
 
if (!TipcMsgAddNamedReal16ArrayPtr(msg, "named_real16_array", 
data, 0, 
                                   &field)) { 
  return;  /* error */ 
} 
 
data[0] = 1e1000; 
data[1] = 2e1000; 
if (!TipcMsgFieldSetSize(field, 2)) { 
  return;  /* error */ 
}