rawConversion {base} | R Documentation

## Convert to or from Raw Vectors

### Description

Conversion and manipulation of objects of type `"raw"`.

### Usage

    charToRaw(x)
    rawToChar(x, multiple = FALSE)

    rawShift(x, n)

    rawToBits(x)
    intToBits(x)
    packBits(x, type = c("raw", "integer"))

### Arguments

`x` | object to be converted or shifted.
`multiple` | logical: should the conversion be to a single character string or multiple individual characters?
`n` | the number of bits to shift. Positive numbers shift right and negative numbers shift left: allowed values are `-8 ... 8`.
`type` | the result type.

### Details

`packBits` accepts raw, integer or logical inputs, the last two without any NAs.

### Value

`charToRaw` converts a length-one character string to raw bytes.
`rawToChar` converts raw bytes either to a single character string or a character vector of single bytes. (Note that a single character string could contain embedded nuls.)
`rawToBits` returns a raw vector of 8 times the length of a raw vector with entries 0 or 1. `intToBits` returns a raw vector of 32 times the length of an integer vector with entries 0 or 1. In both cases the unpacking is least-significant bit first.
`packbits` packs its input (using only the lowest bit for raw or integer vectors) least-significant bit first to a raw or integer vector.

### Examples

    x <- "A test string"
    (y <- charToRaw(x))
    is.vector(y) # TRUE

    rawToChar(y)
    rawToChar(y, multiple = TRUE)
    (xx <- c(y, as.raw(0), charToRaw("more")))
    rawToChar(xx)
    xxx <- xx
    xxx[length(y)+1] <- charToRaw("&")
    xxx
    rawToChar(xxx)

    rawShift(y, 1)
    rawShift(y, -2)

    rawToBits(y)

[Package base version 2.3.1 Index]