forcats (version 0.5.2)

fct_match: Test for presence of levels in a factor

Description

Do any of lvls occur in f? Compared to %in%, this function validates lvls to ensure that they're actually present in f. In other words, x %in% "not present" will return FALSE, but fct_match(x, "not present") will throw an error.

Usage

fct_match(f, lvls)

Value

A logical vector

Arguments

f

A factor (or character vector).

lvls

A character vector specifying levels to look for.

Examples

table(fct_match(gss_cat$marital, c("Married", "Divorced")))

# Compare to %in%, misspelled levels throw an error
table(gss_cat$marital %in% c("Maried", "Davorced"))
if (FALSE) {
table(fct_match(gss_cat$marital, c("Maried", "Davorced")))
}