getByLevel-list-method: Get By Level (list)

In rappster/listr: Extended list functionality

Description

Get By Level (list)

Usage

## S4 method for signature 'list'
getByLevel(input, value, outer = FALSE, resolve = FALSE,
  strict = c(0, 1, 2), ...)

Arguments

input	list.
value	character. Level as found in return value of getStructure.
outer	logical. TRUE: use oindex instead of index to retrieve the outer element values (i.e., outer list structure is preserved); FALSE: use index to retrieve the inner element values (i.e. outer list structure is not preserved).
resolve	logical. TRUE: resolve path to basename component as names for return value; FALSE: use path as names for return value.
strict	numeric. 0: ignore without warning 1: ignore with Warning 2: stop with error
...	Further arguments to be passed to subsequent functions/methods.

Value

list.

See generic

getByLevel

Author(s)

Janko Thyson [e-mail]

References

http://github.com/rappster/listr

See Also

getByLevel, getStructure

Examples

## Not run: 

input <- list(
  x1 = list(x11 = list(x111 = list(x1111 = 1, x1112 = 2), x112 = 1), 
    x12 = list(x121 = 1, x122 = 1)),
  x2 = list(x21 = "x21"),
  x3 = list("x31"),
  x4 = "x4",
  x5 = list(1:3),
  list(list(1, 2), list(3, 4)),
  list(1:3),
  "char 1",
  "char 2",
  letters[1:3],
  c(1,3,5),
  TRUE,
  new.env(),
  data.frame(x = 1:3, y = 1:3)
)

## Inspect structure //
(struc <- getStructure(input))

getByLevel(input, value = 1)
getByLevel(input, value = 1, resolve = TRUE)

getByLevel(input, value = 2)
getByLevel(input, value = 2, resolve = TRUE)

getByLevel(input, value = 3)
getByLevel(input, value = 3, resolve = TRUE)

getByLevel(input, value = 4)
getByLevel(input, value = 4, resolve = TRUE)

## Condition handling //
getByLevel(input, value = 5)
try(getByLevel(input, value = 5, strict = 1))
try(getByLevel(input, value = 5, strict = 2))


## End(Not run)

rappster/listr documentation built on May 26, 2019, 11:21 p.m.