cdds_newer - find newer definition, given alias list

SYNOPSIS

#include "cdds.h"

const char * cdds_newer(alias);

const char *alias

DESCRIPTION

This function finds the next newer definition in the "scanned" dictionaries (see cdds_dict). The various scan routines can then be used to retrieve the definition's value(s). After a call to cdds_dict, cdds_newer will start from the beginning of the dictionary (or first dictionary of several).

INPUT

alias is a list of definition names to search. If the list is empty, then the very next definition is found.

OUTPUT

The name of the definition found will be returned. If alias is empty, it will be the name of the next definition. If alias contains multiple definitions to search, name will be the name of the specific definition found. A NULL value is returned if the alias definition is not found.

EXAMPLES

          
            const char *defn, *value;
            ...
            cdds_dict(in_dict, "scan");
            defn = cdds_newer("cmd_title cmd_name");
            if (defn) cdds_scanv("", &value);
            ...
            defn = cdds_newer("");
            if (defn) fprintf(stderr, "defn=%s\n", defn);
            ...

SEE ALSO

      cdds_dict  Select DDS Dictionary and mode

AUTHOR

Jerry Ehlers, BP America (May 2003)