Add Nested Message

Convenience Method

Declaration

TibrvStatus addMsg(
    const char*           fieldName,
    const TibrvMsg&       msg,
    tibrv_u16             fieldId=0);

Purpose

Add a field containing a nested submessage.

Remarks

This method adds only the data portion of the nested message (value); it does not include any address information or certified delivery information.

Parameter

Description

fieldName

Create the new field with this name.

msg

Add a new field that contains this submessage.

The method copies the data into the new field.

fieldId

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 NULL field name, and a non-zero field identifier.