Function rcl_subscription_set_content_filter

• Defined in File subscription.h

Function Documentation

rcl_ret_t rcl_subscription_set_content_filter(const rcl_subscription_t *subscription, const rcl_subscription_content_filter_options_t *options)

Set the filter expression and expression parameters for the subscription.

This function will set a filter expression and an array of expression parameters for the given subscription.

Attribute	Adherence
Allocates Memory	No
Thread-Safe	No
Uses Atomics	Maybe [1]
Lock-Free	Maybe [1]

Parameters:

• subscription – [in] The subscription to set content filter options.

• options – [in] The rcl content filter options.

Returns:

RCL_RET_OK if the query was successful, or

Returns:

RCL_RET_INVALID_ARGUMENT if subscription is NULL, or

Returns:

RCL_RET_INVALID_ARGUMENT if options is NULL, or

Returns:

RCL_RET_UNSUPPORTED if the implementation does not support content filter topic, or

Returns:

RCL_RET_ERROR if an unspecified error occurs.