assert_all_are_email_addresses {}R Documentation

Does the character vector contain email addresses?


Checks that the input contains email addresses. (It does not check the the address exists, merely that the string is in a suitable format.)


assert_all_are_email_addresses(x, method = c("simple", "rfc5322"),
  na_ignore = FALSE, severity = getOption("assertive.severity",

assert_any_are_email_addresses(x, method = c("simple", "rfc5322"),
  na_ignore = FALSE, severity = getOption("assertive.severity",

is_email_address(x, method = c("simple", "rfc5322"))



Input to check.


Name of method to check for validity. See notes below.


A logical value. If FALSE, NA values cause an error; otherwise they do not. Like na.rm in many stats package functions, except that the position of the failing values does not change.


How severe should the consequences of the assertion be? Either "stop", "warning", "message", or "none".


A logical vector that is TRUE when the input contains valid email addresses.


Each method specifies a regular expression (see regex) to match against. The simple method matches most email addresses in use, and is quite good at filtering out typos and nonsense. It won't match every email address however. For example, emails from a top level domain longer than 4 characters won't pass. The rfc5322 method implements the official standard for emails. Thus all genuine emails will pass, but since the spec is very broad, it isn't as good at filtering out nonsense.

References contains the regexes used by this function and a good discussion of the pros and cons of each.


addresses <- c(
  ok       = "", 
  no_at    = "", 
  no_dot   = "a@bcom", 
  long_tld = "a@b.comma", 
  punct    = "a!$&", 
  missing  = NA
is_email_address(addresses, method = "rfc5322")

[Package version 0.0-3 Index]