pips_event_new_topic_handler_t

Updated: April 19, 2023

Prototype of handlers for new topic events

Synopsis:

#include <pips/event.h>
typedef int pips_event_new_topic_handler_t(void *user_data,
                                           const char *topic_name,
                                           const char *topic_type);

Arguments:

user_data
A pointer to the user data that was supplied when the callback was registered
topic_name
A pointer to a string expressing the topic's fully qualified name
topic_type
A pointer to a string expressing the topic's type name

Library:

pips-client

Description:

This data type describes the prototype for callback functions that can be registered by clients to handle new topic events from the PiPS framework.

Returns:

The event framework expects that the handler will return a negative value and set errno if it encounters an error condition, and return a value greater than or equal to zero on success.