pips_provider_find_namespace()

Find a namespace from its fully qualified name

Synopsis:

#include <pips/pips.h>
pips_namespace_t* pips_provider_find_namespace(const pips_provider_t *provider,
                                               const char *path,
                                               const char *opt_separator)

Arguments:

provider
A pointer to the current provider
path
The path, relative to the provider's root namespace, designating the sub-namespace to retrieve
opt_separator
An optional string used to separate the elements of the fully qualified path

Library:

pips-client

Description:

This convenience function searches the current provider's root namespace for the named entity, and returns that entity if it's a namespace instance. This function is the equivalent to the following:
   pips_namespace_narrow( pips_provider_find_entity( ... ) )

Returns:

On success, a pointer to the sub-namespace in the provider's root namespace designated by the fully qualified path. On error, NULL (errno is set).

Errors:

  • EINVAL: The path specification or the separator is invalid.
  • ENODEV: The provider is invalid.
  • ENOENT: The root namespace does not contain the sub-namespace designated by the given path.
  • ENOTDIR: The path designates an entity nested within a topic.