TipcMsgUpdateNamedBoolArrayPtr

Name

TipcMsgUpdateNamedBoolArrayPtr — update a pointer to a named BOOL_ARRAY field in a message with new data

Synopsis

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

Arguments

msg — message to update field in

name — name of the field

value — new 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 update was successful, FALSE otherwise.

Diagnostics

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

Description

TipcMsgUpdateNamedBoolArrayPtr updates a BOOL_ARRAY pointer field specified by field name.

Caution

None

Examples

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

T_BOOL *data; 
T_INT4 size; 
if (!TipcMsgUpdateNamedBoolArrayPtr(msg, "data", data, size, 
T_NULL)) { 
  return;  /* error */ 
}