R: Combine many vectors into one vector

vec_c {vctrs} | R Documentation

## Combine many vectors into one vector

### Description

Combine all arguments into a new vector of common type.

### Usage

    vec_c(
      ...,
      .ptype = NULL,
      .name_spec = NULL,
      .name_repair = c("minimal", "unique", "check_unique", "universal")
    )

### Arguments

`...` | Vectors to coerce.
`.ptype` | If `NULL`, the default, the output type is determined by computing the common type across all elements of `...`. Alternatively, you can supply `.ptype` to give the output known type. If `getOption("vctrs.no_guessing")` is `TRUE` you must supply this value: this is a convenient way to make production code demand fixed types.
`.name_spec` | A name specification for combining inner and outer names. This is relevant for inputs passed with a name, when these inputs are themselves named, like `outer = c(inner = 1)`, or when they have length greater than 1: `outer = 1:2`. By default, these cases trigger an error. You can resolve the error by providing a specification that describes how to combine the names or the indices of the inner vector with the name of the input. This specification can be: A function of two arguments. The outer name is passed as a string to the first argument, and the inner names or positions are passed as second argument. An anonymous function as a purrr-style formula. A glue specification of the form `"{outer}_{inner}"`. See the name specification topic.
`.name_repair` | How to repair names, see `repair` options in `vec_as_names()`.

### Value

A vector with class given by `.ptype`, and length equal to the sum of the `vec_size()` of the contents of `...`.

The vector will have names if the individual components have names (inner names) or if the arguments are named (outer names). If both inner and outer names are present, an error is thrown unless a `.name_spec` is provided.

### Invariants

- `vec_size(vec_c(x, y)) == vec_size(x) + vec_size(y)`

- `vec_ptype(vec_c(x, y)) == vec_ptype_common(x, y)`.

### See Also

`vec_cbind()`/`vec_rbind()` for combining data frames by rows or columns.

### Examples

    vec_c(FALSE, 1L, 1.5)
    vec_c(FALSE, 1L, "x", .ptype = character())

    # Date/times --------------------------
    c(Sys.Date(), Sys.time())
    c(Sys.time(), Sys.Date())

    vec_c(Sys.Date(), Sys.time())
    vec_c(Sys.time(), Sys.Date())

    # Factors -----------------------------
    c(factor("a"), factor("b"))
    vec_c(factor("a"), factor("b"))

    # By default, named inputs must be length 1:
    vec_c(name = 1)
    try(vec_c(name = 1:3))

    # Pass a name specification to work around this:
    vec_c(name = 1:3, .name_spec = "{outer}_{inner}")

    # See `?name_spec` for more examples of name specifications.

[Package vctrs version 0.2.2 Index]