pips_topic_dup_pps_name()

Updated: October 26, 2022

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.