.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "MATCH_TOKEN" "9" "09 October 2005" "" ""

.SH NAME
match_token \- Find a token (and optional args) in a string
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int match_token  (char * \fIs\fB, match_table_t \fItable\fB, substring_t \fIargs[]\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIs\fB\fR
the string to examine for token/argument pairs
.TP
\fB\fItable\fB\fR
match_table_t describing the set of allowed option tokens and the
arguments that may be associated with them. Must be terminated with a
&struct match_token whose pattern is set to the NULL pointer.
.TP
\fB\fIargs[]\fB\fR
array of MAX_OPT_ARGS &substring_t elements. Used to return match
locations.
.SH "DESCRIPTION"
.PP
Detects which if any of a set of token strings has been passed
to it. Tokens can include up to MAX_OPT_ARGS instances of basic c-style
format identifiers which will be taken into account when matching the
tokens, and whose locations will be returned in the \fIargs\fR array.