A Simple S3 Class for Representing Vectors of Binary Data ('BLOBS')

R's raw vector is useful for storing a single binary object. What if you want to put a vector of them in a data frame? The 'blob' package provides the blob object, a list of raw vectors, suitable for use as a column in data frame.


Lifecycle:stable rcc CRAN_Status_Badge CoverageStatus

blob

Overview

The goal of blob is to provide a simple S3 class to represent a vector of binary objects, aka blobs. The blob class is a lightweight wrapper around a list of raw vectors, suitable for inclusion in a data frame.

In most cases you will not need to use this package explicitly: it will be used transparently by packages that need to load BLOB columns from databases or binary file formats.

Installation

# The easiest way to get blob is to install the whole tidyverse:
install.packages("tidyverse")

# Alternatively, install just blob:
install.packages("blob")

# Or the development version from GitHub:
# install.packages("pak")
pak::pak("tidyverse/blob")

Example

To create a blob, use blob(), new_blob() or as_blob():

library(blob)

x1 <- charToRaw("Good morning")
x2 <- as.raw(c(0x48, 0x65, 0x6c, 0x6c, 0x6f))

new_blob(list(x1, x2))
#> <blob[2]>
#> [1] blob[12 B] blob[5 B]
blob(x1, x2)
#> <blob[2]>
#> [1] blob[12 B] blob[5 B]

as_blob(c("Good morning", "Good evening"))
#> <blob[2]>
#> [1] blob[12 B] blob[12 B]

Please note that the ‘blob’ project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("blob")

1.3.0 by Kirill Müller, 9 months ago


https://blob.tidyverse.org, https://github.com/tidyverse/blob


Report a bug at https://github.com/tidyverse/blob/issues


Browse source code at https://github.com/cran/blob


Authors: Hadley Wickham [aut] , Kirill Müller [cre] , RStudio [cph, fnd]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports methods, rlang, vctrs

Suggests covr, crayon, pillar, testthat


Imported by DBItest, RMariaDB, RPostgres, RSQLite, Rparadox, dbplyr, odbc, ragnar, tfevents.

Suggested by DBI, GeoTox, arrow, b32, b64, bcputility, bigrquery, bigrquerystorage, dbx, ipaddress, nanoarrow, nanoparquet, sf, tibble.


See at CRAN