Skip to contents

Bitwise AND

Source: R/api.R, R/api-generics.R
nv_and.Rd

Element-wise bitwise AND – a logical AND on a boolean input, and a bit-by-bit one on an integer. You can also use the & operator, which expects bool inputs, however.

Usage

nv_and(lhs, rhs)

Arguments

lhs, rhs

(arrayish)
Two inputs with a common data type. Can be any integerish data type. Scalars are broadcast, and R values assume the other operand's data type within their data type category, otherwise falling back to their default data type and being converted to the common data type.

Value

(arrayish)
Has the inputs' broadcast shape and common data type.

The & operator

& is logical, like in base R. Unlike base R it only accepts booleans and does not auto-convert non-booleans by comparing them with 0.

See also

prim_and() for the underlying primitive.

Examples

x <- nv_array(c(TRUE, FALSE, TRUE))
y <- nv_array(c(TRUE, TRUE, FALSE))
x & y
#> AnvlArray
#>  1
#>  0
#>  0
#> [ CPUbool{3} ] 

# different data types are promoted to their common one
nv_and(nv_scalar(12L, "i32"), nv_scalar(10L, "i64"))
#> AnvlArray
#>  8
#> [ CPUi64{} ] 

# a scalar is broadcast
x & TRUE
#> AnvlArray
#>  1
#>  0
#>  1
#> [ CPUbool{3} ]