pips_namespace_narrow()

Narrow a PiPS entity to a PiPS namespace

Synopsis:

#include <pips/publication.h>
pips_namespace_t* pips_namespace_narrow(pips_entity_t *const entity)

Arguments:

entity
A pointer to the pips_entity_t instance to narrow

Library:

pips-client

Description:

This function narrows the definition of the given pips_entity_t instance, expressing it as a pips_namespace_t instance. Runtime type information is used to ensure that the entity can be expressed as a namespace.

Returns:

A pointer to the current PiPS entity expressed as a namespace. If the runtime constraints aren't satisfied, the operation fails and the function returns NULL.