if_else: Vectorised if-else

View source: R/if-else.R

if_elseR Documentation

Vectorised if-else


if_else() is a vectorized if-else. Compared to the base R equivalent, ifelse(), this function allows you to handle missing values in the condition with missing and always takes true, false, and missing into account when determining what the output type should be.


if_else(condition, true, false, missing = NULL, ..., ptype = NULL, size = NULL)



A logical vector

true, false

Vectors to use for TRUE and FALSE values of condition.

Both true and false will be recycled to the size of condition.

true, false, and missing (if used) will be cast to their common type.


If not NULL, will be used as the value for NA values of condition. Follows the same size and type rules as true and false.


These dots are for future extensions and must be empty.


An optional prototype declaring the desired output type. If supplied, this overrides the common type of true, false, and missing.


An optional size declaring the desired output size. If supplied, this overrides the size of condition.


A vector with the same size as condition and the same type as the common type of true, false, and missing.

Where condition is TRUE, the matching values from true, where it is FALSE, the matching values from false, and where it is NA, the matching values from missing, if provided, otherwise a missing value will be used.


x <- c(-5:5, NA)
if_else(x < 0, NA, x)

# Explicitly handle `NA` values in the `condition` with `missing`
if_else(x < 0, "negative", "positive", missing = "missing")

# Unlike `ifelse()`, `if_else()` preserves types
x <- factor(sample(letters[1:5], 10, replace = TRUE))
ifelse(x %in% c("a", "b", "c"), x, NA)
if_else(x %in% c("a", "b", "c"), x, NA)

# `if_else()` is often useful for creating new columns inside of `mutate()`
starwars %>%
  mutate(category = if_else(height < 100, "short", "tall"), .keep = "used")

dplyr documentation built on Nov. 17, 2023, 5:08 p.m.