bit (version 4.6.0)

Extract: Extract or replace part of an boolean vector

Description

Operators acting on bit() or bitwhich() objects to extract or replace parts.

Usage

# S3 method for bit
[[(x, i)
# S3 method for bit
[[(x, i) <- value
# S3 method for bit
[(x, i)
# S3 method for bit
[(x, i) <- value
# S3 method for bitwhich
[[(x, i)
# S3 method for bitwhich
[[(x, i) <- value
# S3 method for bitwhich
[(x, i)
# S3 method for bitwhich
[(x, i) <- value

Value

The extractors [[ and [ return a logical scalar or vector. The replacment functions return an object of class(x).

Arguments

x

a bit() or bitwhich() object

i

preferrably a positive integer subscript or a ri(), see text

value

new logical or integer values

Author

Jens Oehlschlägel

Details

The typical usecase for '[' and '[<-' is subscripting with positive integers, negative integers are allowed but slower, as logical subscripts only scalars are allowed. The subscript can be given as a bitwhich() object. Also ri() can be used as subscript.

Extracting from bit() and bitwhich() is faster than from logical() if positive subscripts are used. Unteger subscripts make sense. Negative subscripts are converted to positive ones, beware the RAM consumption.

See Also

bit(), `Extract``

Examples

  x <- as.bit(c(FALSE, NA, TRUE))
  x[] <- c(FALSE, NA, TRUE)
  x[1:2]
  x[-3]
  x[ri(1, 2)]
  x[as.bitwhich(c(TRUE, TRUE, FALSE))]
  x[[1]]
  x[] <- TRUE
  x[1:2] <- FALSE
  x[[1]] <- TRUE