Get a copy of the PPS name of the given topic
Synopsis:
#include <pips/publication.h>
char* pips_topic_dup_pps_name(pips_topic_t *const topic)
Arguments:
- topic
- A pointer to the topic whose PPS name is requested
Library:
pips-client
Description:
This function allocates a string buffer and stores a copy of the PPS name of the given topic in it. The PPS name is formatted as follows:
'@' <topic name> '<' <provider_name> '::' <topic type> '>'
Returns:
On success, a pointer to a string buffer containing the current topic's PPS name. The buffer becomes owned by the caller, who is responsible for deleting it. On error, NULL (errno is set).
Errors:
- EINVAL: The given topic is invalid.
- ENODEV: The provider associated with the topic is invalid.
- ENOMEM: The framework couldn't allocate the buffer to hold the topic's PPS name.