pips_entity_parent()

Get the parent namespace of an entity

Synopsis:

#include <pips/publication.h>

pips_namespace_t* pips_entity_parent(pips_entity_t *const entity)

Arguments:

entity: A pointer to the entity whose parent namespace is being retrieved

Library:

pips-client

Description:

This function gets a handle to the namespace that's the immediate parent of the current entity. This can be used to navigate to the entity's root namespace.

Returns:

On success, a handle (which is a pointer to pips_namespace_t object) to the parent namespace. On error, NULL (errno is set).

Errors:

EINVAL: The entity is invalid.
ESPIPE: The entity is already at the root namespace.