match                  package:base                  R Documentation

_V_a_l_u_e _M_a_t_c_h_i_n_g

_D_e_s_c_r_i_p_t_i_o_n:

     `match': If `x[i]' is found to equal `table[j]' then the value
     returned in the `i'-th position of the return value is `j'.  If no
     match is found, the value is `nomatch'.

     `%in%': A utility function, currently defined as 
     `"%in%" <- function(x, table) match(x, table, nomatch = 0) > 0'
     allowing an intuitive usage and returning a logical vector of
     length `length(x)'.

_U_s_a_g_e:

     match(x, table, nomatch=NA)
     x %in% table

_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 to be returned in the case when no match is found.

_S_e_e _A_l_s_o:

     `pmatch' and `charmatch' for (partial) string matching,
     `match.arg', etc for function argument matching.

_E_x_a_m_p_l_e_s:

     ## The intersection of two sets :
     intersect <- function(x, y) y[match(x, y, nomatch = 0)]
     intersect(1:10,7:20)

     1:10 %in% c(1,3,5,9)
     sstr <- c("c","ab","B","bba","c","@","bla","a","Ba","%")
     sstr[sstr %in% c(letters,LETTERS)]

     "%w/o%" <- function(x,y) x[!x %in% y] #--  x without y
     (1:10) %w/o% c(3,7,12)

