\Header{charmatch}{Partial String Matching}
\keyword{character}{charmatch}
\begin{Usage}
\begin{verbatim}
charmatch(x, table, nomatch = NA)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{x}] the values to be matched.
\item[\texttt{table}] the values to be matched against.
\item[\texttt{nomatch}] the value returned at non-matching positions.
\end{ldescription}
\end{Arguments}
\begin{Description}
\texttt{charmatch} seeks matches for the elements of its first argument
among those of its second.  If there is a unique match then the index
of the matching value is returned; if multiple matches are found then
\texttt{0} is returned and if no match is found then \texttt{NA} is
returned.

This function is based on a C function written by Terry Therneau.\end{Description}
\begin{SeeAlso}
\texttt{\Link{match}} \texttt{\Link{pmatch}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
charmatch("", "")                             # returns 1
charmatch("m",   c("mean", "median", "mode")) # returns 0
charmatch("med", c("mean", "median", "mode")) # returns 2
\end{ExampleCode}
\end{Examples}

