# extractSubList: Extracts a named element from a list of lists. In berndbischl/BBmisc: Miscellaneous Helper Functions for B. Bischl

## Description

Extracts a named element from a list of lists.

## Usage

 ```1 2``` ```extractSubList(xs, element, element.value, simplify = TRUE, use.names = TRUE) ```

## Arguments

 `xs` [`list`] A list of named lists. `element` [`character`] Name of element(s) to extract from the list elements of `xs`. What happens is this: `x\$el1\$el2....`. `element.value` [any] If given, `vapply` is used and this argument is passed to `FUN.VALUE`. Note that even for repeated indexing (if length(element) > 1) you only pass one value here which refers to the data type of the final result. `simplify` [`logical(1)` | character(1)] If `FALSE` `lapply` is used, otherwise `sapply`. If “cols”, we expect the elements to be vectors of the same length and they are arranged as the columns of the resulting matrix. If “rows”, likewise, but rows of the resulting matrix. Default is `TRUE`. `use.names` [`logical(1)`] If `TRUE` and `xs` is named, the result is named as `xs`, otherwise the result is unnamed. Default is `TRUE`.

## Value

[`list` | simplified `vector` | `matrix`]. See above.

## Examples

 ```1 2 3``` ```xs = list(list(a = 1, b = 2), list(a = 5, b = 7)) extractSubList(xs, "a") extractSubList(xs, "a", simplify = FALSE) ```

berndbischl/BBmisc documentation built on Nov. 29, 2017, 5:10 a.m.