CL_MATCHED - number of times an option matched on command line.

Usage:

#include <cl.h>
number = cl_matched(cl,index);    /* MACRO */

Where:

CL_PARSED *cl;

points to a parsed command line structure, as returned by "cl_cparse" or a related routine.

int index;

tells the table entry that you want to check on.

int number;

is the number of times the specified option appeared on the command line.

Description:

The "cl_matched" macro returns the number of times the parsing routines found an argument matching a given Options Table entry. If the "cl" data structure was created by "cl_ceparse", this will be either the number of occurrences in the scanned environment variable or in the parsed command line; if the command line overrides the environment variable, "cl_matched" returns the number of occurrences in the command line but not the environment variable.

See Also:

expl c internal parser

for an overview of the parser routines.

expl c internal parser macros

for macros used in creating an Options Table.

Copyright © 1996, Thinkage Ltd.