TipcMsgExistsNamed

Name

TipcMsgExistsNamed — determines if a field exists in a message, using a name

Synopsis

T_BOOL TipcMsgExistsNamed(msg, name, exists) 
T_IPC_MSG msg; 
T_STR name; 
T_BOOL *exists; 

Arguments

msg — message to check

name — name of the field

exists — pointer to a boolean indicating whether or not the field exists

Return Values

TRUE if the get was successful, FALSE otherwise.

Diagnostics

None

Description

TipcMsgExistsNamed checks to see if the field indicated by the name exists in the message. The exists return value is set to TRUE if the field exists, FALSE otherwise.

Examples

This example checks to see if a field named "foo" exists in the message:

T_BOOL status; 
T_BOOL exists; 
 
status = TipcMsgExistsNamed(msg, "foo", &exists); 
if (status == FALSE) { 
  return;  /* error */ 
}  
 
if (exists == TRUE) { 
  /* field exists */ 
}