PiPS Client APIpips_namespace_t Parent topic: pips_namespace_t

pips_namespace_create_namespace()

Updated: October 28, 2024

Create a sub-namespace in a given namespace

Synopsis:

#include <pips/publication.h>
pips_namespace_t* pips_namespace_create_namespace(pips_namespace_t *parent,
                                                  const char *name)

Arguments:

parent
A pointer to the parent namespace in which the new sub-namespace will be created as a child entity
name
The name to associate with the sub-namespace

Library:

pips-client

Description:

This function creates a namespace with the given name as a child of the specified parent namespace.

Returns:

On success, a pointer to the newly created sub-namespace. On error, NULL (errno is set).

Errors:

  • EINVAL: The sub-namespace name is invalid.
  • ENODEV: The parent namespace is invalid or has no associated provider.
  • EALREADY: An entity with the given name already exists in the parent namespace.
Parent topic: pips_namespace_t