Description:
This function
searches the supplied provenance structure for root ancestors, and returns information about them.
An ancestor is a root ancestor if it does not itself have any ancestors.
Invocation
AstKeyMap
∗ndgRootProv(
NdgProvenance ∗prov,
int ∗status
)
Arguments
prov
An identifier for a structure holding the provenance information as returned by
ndgReadProv or ndgReadVotProv.
status
The global status.
Returned Value
A pointer to an
AST KeyMap containing an entry for each root ancestor. The key associated with each entry is the
path to the NDF and the value of the entry is an integer that gives the position of the root ancestor
within the list of all ancestors. This integer value can be supplied to ndgGetProv in order to get
further information about the root ancestor. The first ancestor NDF has an index of one.
An index of zero refers to the NDF from which the provenance information was read.
Copyright © 2000 Council for the Central Laboratory of the Research Councils