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.