pips_namespace_find

Find an entity in the current namespace

Synopsis:

#include <pips/publication.h>

pips_entity_t* pips_namespace_find_entity(pips_namespace_t *const nmspace,
                                          const char *name)

Arguments:

nmspace: A pointer to the namespace to search
name: The name of the entity to find

Library:

pips-client

Description:

This function searches the list of entities managed by the current namespace to find the specified entity. Only the immediate children of the current namespace are searched; sub-namespaces aren't searched recursively.

Returns:

On success, a pointer to the named entity whose parent is the current namespace. If no such entity is found or an error occurs in the search, this function returns NULL and sets errno.

Errors:

EINVAL: The namespace or the entity name is invalid.
ENOENT: The named entity was not found in the current namespace.