Subset rows using their positions

DataSHIELD implentation of dplyr::slice.

ds.slice(
  df.name = NULL,
  expr = NULL,
  .by = NULL,
  .preserve = FALSE,
  newobj = NULL,
  datasources = NULL
)

Arguments

df.name

Character specifying a serverside data frame or tibble.

expr

Provide either positive values to keep, or negative values to drop. The values provided must be either all positive or all negative. Indices beyond the number of rows in the input are silently ignored.

.by

Optionally, a selection of columns to group by for just this operation, functioning as an alternative to dplyr::group_by

.preserve

Relevant when the .data input is grouped. If .preserve = FALSE (the default), the grouping structure is recalculated based on the resulting data, otherwise the grouping is kept as is.

newobj

Character specifying name for new server-side data frame.

datasources

DataSHIELD connections object.

Value

An object with the name specified by the newobj argument is written serverside.

Examples

if (FALSE) {
ds.slice(
df.name = "mtcars",
expr = list(1:10),
.by = "cyl",
newobj = "sliced_df")
}