ds.bind_rows: Bind multiple data frames by row.

View source: R/ds.bind_rows.R

ds.bind_rowsR Documentation

Bind multiple data frames by row.

Description

DataSHIELD implementation of dplyr::bind_rows.

Usage

ds.bind_rows(to_combine = NULL, .id = NULL, newobj = NULL, datasources = NULL)

Arguments

to_combine

Data frames to combine. Each argument can either be a data frame, a list that could be a data frame, or a list of data frames. Columns are matched by name, and any missing columns will be filled with NA.

.id

The name of an optional identifier column. Provide a string to create an output column that identifies each input. The column will use names if available, otherwise it will use positions.

newobj

Character specifying name for new server-side data frame.

datasources

datashield connections object.

Value

No return value, called for its side effects. A data frame with the name specified by newobj and the same type as the first element of to_combine is created on the server.

Examples

## Not run: 
## First log in to a DataSHIELD session with mtcars dataset loaded.

ds.bind_rows(
  to_combine = list(mtcars, mtcars),
  newobj = "test",
  datasources = conns
)

## Refer to the package vignette for more examples.

## End(Not run)

dsTidyverseClient documentation built on April 12, 2025, 1:55 a.m.