pips_topic_narrow()

Narrow a PiPS entity to a PiPS topic

Synopsis:

#include <pips/publication.h>

pips_topic_t* pips_topic_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_topic_t instance. Runtime type information is used to ensure that the entity can be expressed as a topic.

Returns:

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