coalesce: Find first non-missing element

Description Usage Arguments Details See Also Examples

View source: R/coalesce.R

Description

Given a set of vectors, coalesce() finds the first non-missing value at each position. This is inspired by the SQL COALESCE function which does the same thing for NULLs.

Usage

1

Arguments

...

Vectors. Inputs should be recyclable (either be length 1L or n) and coercible to a common type.

Details

Currently, coalesce() type checking does not take place.

See Also

na_if() to replace specified values to a NA.

replace_na() to replace a NA with a value.

Examples

1
2
3
4
5
6
7
8
# Use a single value to replace all missing vectors
x <- sample(c(1:5, NA, NA, NA))
coalesce(x, 0L)

# Or match together a complete vector from missing pieces
y <- c(1, 2, NA, NA, 5)
z <- c(NA, NA, 3, 4, 5)
coalesce(y, z)

poorman documentation built on March 28, 2021, 5:05 p.m.