Update Scalar
Convenience Functions
Declaration
tibrv_statustibrvMsg_Update
scalar_type
(
tibrvMsg message,
const char* fieldName,
scalar_type
value);
tibrv_statustibrvMsg_Update
scalar_type
Ex
(
tibrvMsg message,
const char* fieldName,
scalar_type
value,
tibrv_u16 fieldId);
Purpose
Update a field containing a scalar value.
Remarks
Each convenience function in this family locates a field (by name or identifier) and updates its data.
The type of the existing field (within the message) and the type of the updating value
must match.
Function Name |
Value Type |
Type Description |
|
|
boolean scalar |
|
|
8-bit integer |
|
|
8-bit unsigned integer |
|
|
16-bit integer |
|
|
16-bit unsigned integer |
|
|
32-bit integer |
|
|
32-bit unsigned integer |
|
|
64-bit integer |
|
|
64-bit unsigned integer |
|
|
32-bit floating point |
|
|
64-bit floating point |
|
|
4-byte IP address |
|
|
2-byte IP port |
Parameter |
Description |
|
Update the specified field of this message. |
|
Update a field with this name. |
|
Update the message field to this value (which may be a literal or stored in a variable). The function copies the value into the new message field. |
|
Update the field with this identifier. Zero is a special value that signifies no field identifier. It is illegal to add a field that has both a |