bit (version 4.0.5)

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 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. integer 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