is_subset: Determine whether one vector is a subset of another

In nuggets: Extensible Framework for Data Pattern Exploration

Determine whether one vector is a subset of another

Description

Check if all elements of x are also contained in y. This is equivalent to testing whether setdiff(x, y) is empty.

Usage

is_subset(x, y)

Arguments

x	The first vector.
y	The second vector.

Details

• If x is empty, the result is always TRUE (the empty set is a subset of any set).

• If y is empty and x is not, the result is FALSE.

• Duplicates in x are ignored; only set membership is tested.

• NA values are treated as ordinary elements. In particular, NA in x is considered a subset element only if NA is also present in y.

Value

A logical scalar. Returns TRUE if x is a subset of y, i.e. all elements of x are also elements of y. Returns FALSE otherwise.

Author(s)

Michal Burda

See Also

generics::setdiff(), generics::intersect(), generics::union()

Examples

is_subset(1:3, 1:5)               # TRUE
is_subset(c(2, 5), 1:4)           # FALSE
is_subset(numeric(0), 1:5)        # TRUE
is_subset(1:3, numeric(0))        # FALSE
is_subset(c(1, NA), c(1, 2, NA))  # TRUE
is_subset(c(NA), 1:5)             # FALSE

nuggets documentation built on Nov. 5, 2025, 6:25 p.m.