matchup: matchup()
In jakesherman/jakemisc: A set of misc. functions from Jake Sherman.

Description Usage Arguments Details Examples

Created as a quick way to match two variables that have a 1:1 relationship. If more than two matches are found for an input, only the first one is returned (to get around this, use merge() or a similar, more proper function).

1	matchup(require_matches, matching_data, match_this, to_this)

`require_matches`	a character vector of elements that need to be matched
`matching_data`	a data frame containing columns matching two things, i.e. the column names you are inputting in the match_this and to_this arguments.
`match_this`	column name of what you want matched (ex. state initials)...
`to_this`	...column name of what you want the above matched to (ex. state names)

Another function of mine, createMatchup(), creates closures based on this function, which can be useful for creating reuseable matching functions on the fly.

This function works by taking a data frame ("matching data") and the column names of

Imagine that we have a vector of state initials ("MA", "CA", "NY"), and we
want to get state names for those initials. Because there is a 1:1
relationship between state initials and names, matchup() will do the trick.
Supply the matchup() function 1) your vector of state initials, 2) a data
frame containing a column of state initials and a matching column of state
names, 3) the column name of state initials, and 4) the column name of state
names. Below is the code to do so:

matchup(vector_of_state_initials, us_states, "state", "state_name")

And the result is a vector: ("Massachusetts", "Califorina", "New York")