charmatch                package:base                R Documentation

_P_a_r_t_i_a_l _S_t_r_i_n_g _M_a_t_c_h_i_n_g

_D_e_s_c_r_i_p_t_i_o_n:

     'charmatch' seeks matches for the elements of its first argument
     among those of its second.

_U_s_a_g_e:

     charmatch(x, table, nomatch = NA)

_A_r_g_u_m_e_n_t_s:

       x: the values to be matched.

   table: the values to be matched against.

 nomatch: the value returned at non-matching positions.

_D_e_t_a_i_l_s:

     Exact matches are preferred to partial matches (those where the
     value to be matched has an exact match to the initial part of the
     target, but the target is longer).

     If there is a single exact match or no exact match and a unique
     partial match then the index of the matching value is returned; if
     multiple exact or multiple partial matches are found then '0' is
     returned and if no match is found then 'NA' is returned.

_A_u_t_h_o_r(_s):

     This function is based on a C function written by Terry Therneau.

_S_e_e _A_l_s_o:

     'pmatch', 'match'.

     'grep' or 'regexpr' for more general (regexp) matching of strings.

_E_x_a_m_p_l_e_s:

     charmatch("", "")                             # returns 1
     charmatch("m",   c("mean", "median", "mode")) # returns 0
     charmatch("med", c("mean", "median", "mode")) # returns 2

