sxp(x) is similar to .Internal(inspect(x)), recursing into the C data
structures underlying any R object. The main difference is the output is a
little more compact, it recurses fully, and avoids getting stuck in infinite
loops by using a depth-first search. It also returns a list that you can
compute with, and carefully uses colour to highlight the most important
details.
Usage
sxp(x, expand = character(), max_depth = 5L)Arguments
- x
Object to inspect
- expand
Optionally, expand components of the true that are usually suppressed. Use:
"character" to show underlying entries in the global string pool.
"environment" to show binding components without any side effects (e.g. promises or active bindings).
"altrep" to show the underlying data.
"call" to show the full AST (but
ast()is usually superior)"bytecode" to show generated bytecode.
- max_depth
Maximum depth to recurse. Use
max_depth = Inf(with care!) to recurse as deeply as possible. Skipped elements will be shown as....`
Details
The name sxp comes from SEXP, the name of the C data structure that
underlies all R objects.
Examples
x <- list(
TRUE,
1L,
runif(100),
"3"
)
sxp(x)
#> [1:0x591c499e2438] <VECSXP[4]> (refs:2+)
#> [2:0x591c48823740] <LGLSXP[1]> (refs:2+)
#> [3:0x591c48823900] <INTSXP[1]> (refs:2+)
#> [4:0x591c494e8c30] <REALSXP[100]> (refs:1)
#> [5:0x591c488243b8] <STRSXP[1]> (refs:2+)
# Expand "character" to see underlying CHARSXP entries in the global
# string pool
x <- c("banana", "banana", "apple", "banana")
sxp(x)
#> [1:0x591c49323f08] <STRSXP[4]> (refs:2+)
sxp(x, expand = "character")
#> [1:0x591c49323f08] <STRSXP[4]> (refs:2+)
#> [2:0x591c48f47b78] <CHARSXP> (refs:2+)
#> [2:0x591c48f47b78]
#> [3:0x591c48f47c20] <CHARSXP> (refs:2+)
#> [2:0x591c48f47b78]
# Expand altrep to see underlying data
x <- 1:10
sxp(x)
#> [1:0x591c47085350] <INTSXP[10]> (altrep refs:2+)
sxp(x, expand = "altrep")
#> [1:0x591c47085350] <INTSXP[10]> (altrep refs:2+)
#> _class [2:0x591c431c2580] <RAWSXP[144]> (refs:2+)
#> _attrib [3:0x591c46f44f00] <LISTSXP> (refs:1)
#> [4:0x591c431f81c8] <SYMSXP: compact_intseq> (refs:2+)
#> [5:0x591c431c3c20] <SYMSXP: base> (refs:2+)
#> [6:0x591c431f6a88] <INTSXP[1]> (refs:2+)
#> _data1 [7:0x591c49247ff8] <REALSXP[3]> (refs:1)
#> _data2 <NILSXP>
# Expand environments to see promise expressions without forcing
e <- new.env(parent = emptyenv())
delayedAssign("x", 1 + 1, assign.env = e)
sxp(e)
#> [1:0x591c46c04788] <ENVSXP> (refs:2+)
#> x <PROMSXP>
#> _enclos [2:0x591c431c4f28] <ENVSXP: empty> (refs:2+)
sxp(e, expand = "environment")
#> [1:0x591c46c04788] <ENVSXP> (refs:2+)
#> x <PROMSXP>
#> _code [2:0x591c4763fb10] <LANGSXP> (refs:2+)
#> ...
#> _env [3:0x591c4760e970] <ENVSXP> (refs:2+)
#> x [4:0x591c47085350] <INTSXP[10]> (altrep refs:2+)
#> e [1:0x591c46c04788]
#> _enclos [5:0x591c47ff0ad0] <ENVSXP> (refs:2+)
#> DONTSHOW [6:0x591c47ff0f68] <CLOSXP> (refs:1)
#> _formals [7:0x591c46a75730] <LISTSXP> (refs:2+)
#> ...
#> _body [8:0x591c46a756f8] <BCODESXP> (refs:2+)
#> ...
#> _env [9:0x591c48036238] <ENVSXP> (refs:2+)
#> ...
#> TESTONLY [10:0x591c47ff0fd8] <CLOSXP> (refs:1)
#> _formals [11:0x591c46a75458] <LISTSXP> (refs:2+)
#> ...
#> _body [12:0x591c46a75420] <BCODESXP> (refs:2+)
#> ...
#> _env [9:0x591c48036238]
#> _enclos [13:0x591c48035fd0] <ENVSXP> (refs:2+)
#> _enclos [14:0x591c459bca00] <ENVSXP> (refs:2+)
#> ...
#> _enclos [15:0x591c431c4f28] <ENVSXP: empty> (refs:2+)