vec_compare: Compare two vectors

View source: R/compare.R

vec_compareR Documentation

Compare two vectors


Compare two vectors


vec_compare(x, y, na_equal = FALSE, .ptype = NULL)


x, y

Vectors with compatible types and lengths.


Should NA values be considered equal?


Override to optionally specify common type


An integer vector with values -1 for x < y, 0 if x == y, and 1 if x > y. If na_equal is FALSE, the result will be NA if either x or y is NA.

S3 dispatch

vec_compare() is not generic for performance; instead it uses vec_proxy_compare() to create a proxy that is used in the comparison.


  • vec_cast_common() with fallback

  • vec_recycle_common()

  • vec_proxy_compare()


vec_compare(c(TRUE, FALSE, NA), FALSE)
vec_compare(c(TRUE, FALSE, NA), FALSE, na_equal = TRUE)

vec_compare(1:10, 5)
vec_compare(runif(10), 0.5)
vec_compare(letters[1:10], "d")

df <- data.frame(x = c(1, 1, 1, 2), y = c(0, 1, 2, 1))
vec_compare(df, data.frame(x = 1, y = 1))

vctrs documentation built on April 20, 2023, 1:34 a.m.