Add String
Convenience Function
Declaration
tibrv_statustibrvMsg_AddString
(
tibrvMsg message,
const char* fieldName,
const char* value);
tibrv_statustibrvMsg_AddStringEx
(
tibrvMsg message,
const char* fieldName,
const char* value,
tibrv_u16 fieldId);
Purpose
Add a field containing a string.
Remarks
The string cannot contain interior NULL
bytes, because this function expects a NULL
-terminated string. To add a string with interior NULL
bytes, use the generic function tibrvMsg_AddField().
Parameter |
Description |
|
Add the new field to this message. |
|
Create the new field with this name. |
|
Add a new field that contains this string (which may be a literal or stored in a variable). The function copies the data into the new field. |
|
Create the new field with this identifier. Zero is a special value that signifies no field identifier. All non-zero field identifiers must be unique within each message. It is illegal to add a field that has both a |