serializeJSON: serialize R objects to JSON

Description Usage Arguments Note Examples

View source: R/serializeJSON.R

Description

The serializeJSON and unserializeJSON functions convert between R objects to JSON data. Instead of using a class based mapping like toJSON and fromJSON, the serialize functions base the encoding schema on the storage type, and capture all data and attributes from any object. Thereby the object can be restored almost perfectly from its JSON representation, but the resulting JSON output is very verbose. Apart from environments, all standard storage types are supported.

Usage

1
2
3
serializeJSON(x, digits = 8, pretty = FALSE)

unserializeJSON(txt)

Arguments

x

an R object to be serialized

digits

max number of digits (after the dot) to print for numeric values

pretty

add indentation/whitespace to JSON output. See prettify

txt

a JSON string which was created using serializeJSON

Note

JSON is a text based format which leads to loss of precision when printing numbers.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
jsoncars <- serializeJSON(mtcars)
mtcars2 <- unserializeJSON(jsoncars)
identical(mtcars, mtcars2)

set.seed('123')
myobject <- list(
  mynull = NULL,
  mycomplex = lapply(eigen(matrix(-rnorm(9),3)), round, 3),
  mymatrix = round(matrix(rnorm(9), 3),3),
  myint = as.integer(c(1,2,3)),
  mydf = cars,
  mylist = list(foo='bar', 123, NA, NULL, list('test')),
  mylogical = c(TRUE,FALSE,NA),
  mychar = c('foo', NA, 'bar'),
  somemissings = c(1,2,NA,NaN,5, Inf, 7 -Inf, 9, NA),
  myrawvec = charToRaw('This is a test')
);
identical(unserializeJSON(serializeJSON(myobject)), myobject);

Example output

[1] TRUE
[1] TRUE

jsonlite documentation built on May 2, 2019, 7:10 a.m.