pips_create_group()

Create a group topic

Synopsis:

#include <pips/publication.h>
pips_group_t* pips_create_group(const char *const group_name)

Arguments:

group_name
The name to assign to the group topic

Library:

pips-client

Description:

This function creates a group topic with the given name. Other topics can be added to the group using pips_group_add_member(). The group topic can be used just like a regular topic, except that write operations aren't supported.

Returns:

On success, a pointer to the pips_group_t structure representing the new group. The caller owns the group topic and hence, is responsible for deleting its memory using pips_delete_topic(). On error, this function returns NULL and sets errno.

Errors:

  • EINVAL: The group's name is invalid.
  • ENOMEM: There was not enough system memory to allocate the group.