Open topic with navigation

TIBCO Rendezvous® 8.8.0

# tibrvMsg_RemoveFieldInstance()

Function

## Declaration

    tibrv_status tibrvMsg_RemoveFieldInstance(
        tibrvMsg         message,
        const char*      fieldName,
        tibrv_u32        instance);

## Purpose

Remove a specified instance of a field from a message.

## Remarks

When a message contains several field instances with the same field name, remove a specific instance by number (for example, remove the `i` th field named `foo`). Programs can use this function in a loop that examines every field with a specified name.

The argument `1` denotes the first instance of the named field.

If the specified instance does not exist, the function returns TIBRV_NOT_FOUND.

Pointer data (such as strings, arrays, submessages, opaque byte sequences or XML data) previously extracted from the field remains valid even after removing the field from the message.

Parameter | Description
`message` | Remove the specified field from this message.
`fieldName` | Remove the field with this name.
`instance` | Remove this instance of the field. The argument `1` specifies the first instance of the named field.

## See Also

tibrvMsg_RemoveField()

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2025. Cloud Software Group, Inc. All Rights Reserved.