Drop columns of a DataFrame

Source code

Description

Drop columns of a DataFrame

Usage

<DataFrame>$drop(..., strict = TRUE)

Arguments

…	Characters of column names to drop. Passed to pl$col().
strict	Validate that all column names exist in the schema and throw an exception if a column name does not exist in the schema.

Value

DataFrame

Examples

library("polars")

as_polars_df(mtcars)$drop(c("mpg", "hp"))

#> shape: (32, 9)
#> ┌─────┬───────┬──────┬───────┬───┬─────┬─────┬──────┬──────┐
#> │ cyl ┆ disp  ┆ drat ┆ wt    ┆ … ┆ vs  ┆ am  ┆ gear ┆ carb │
#> │ --- ┆ ---   ┆ ---  ┆ ---   ┆   ┆ --- ┆ --- ┆ ---  ┆ ---  │
#> │ f64 ┆ f64   ┆ f64  ┆ f64   ┆   ┆ f64 ┆ f64 ┆ f64  ┆ f64  │
#> ╞═════╪═══════╪══════╪═══════╪═══╪═════╪═════╪══════╪══════╡
#> │ 6.0 ┆ 160.0 ┆ 3.9  ┆ 2.62  ┆ … ┆ 0.0 ┆ 1.0 ┆ 4.0  ┆ 4.0  │
#> │ 6.0 ┆ 160.0 ┆ 3.9  ┆ 2.875 ┆ … ┆ 0.0 ┆ 1.0 ┆ 4.0  ┆ 4.0  │
#> │ 4.0 ┆ 108.0 ┆ 3.85 ┆ 2.32  ┆ … ┆ 1.0 ┆ 1.0 ┆ 4.0  ┆ 1.0  │
#> │ 6.0 ┆ 258.0 ┆ 3.08 ┆ 3.215 ┆ … ┆ 1.0 ┆ 0.0 ┆ 3.0  ┆ 1.0  │
#> │ 8.0 ┆ 360.0 ┆ 3.15 ┆ 3.44  ┆ … ┆ 0.0 ┆ 0.0 ┆ 3.0  ┆ 2.0  │
#> │ …   ┆ …     ┆ …    ┆ …     ┆ … ┆ …   ┆ …   ┆ …    ┆ …    │
#> │ 4.0 ┆ 95.1  ┆ 3.77 ┆ 1.513 ┆ … ┆ 1.0 ┆ 1.0 ┆ 5.0  ┆ 2.0  │
#> │ 8.0 ┆ 351.0 ┆ 4.22 ┆ 3.17  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 4.0  │
#> │ 6.0 ┆ 145.0 ┆ 3.62 ┆ 2.77  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 6.0  │
#> │ 8.0 ┆ 301.0 ┆ 3.54 ┆ 3.57  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 8.0  │
#> │ 4.0 ┆ 121.0 ┆ 4.11 ┆ 2.78  ┆ … ┆ 1.0 ┆ 1.0 ┆ 4.0  ┆ 2.0  │
#> └─────┴───────┴──────┴───────┴───┴─────┴─────┴──────┴──────┘

# equivalent
as_polars_df(mtcars)$drop("mpg", "hp")

#> shape: (32, 9)
#> ┌─────┬───────┬──────┬───────┬───┬─────┬─────┬──────┬──────┐
#> │ cyl ┆ disp  ┆ drat ┆ wt    ┆ … ┆ vs  ┆ am  ┆ gear ┆ carb │
#> │ --- ┆ ---   ┆ ---  ┆ ---   ┆   ┆ --- ┆ --- ┆ ---  ┆ ---  │
#> │ f64 ┆ f64   ┆ f64  ┆ f64   ┆   ┆ f64 ┆ f64 ┆ f64  ┆ f64  │
#> ╞═════╪═══════╪══════╪═══════╪═══╪═════╪═════╪══════╪══════╡
#> │ 6.0 ┆ 160.0 ┆ 3.9  ┆ 2.62  ┆ … ┆ 0.0 ┆ 1.0 ┆ 4.0  ┆ 4.0  │
#> │ 6.0 ┆ 160.0 ┆ 3.9  ┆ 2.875 ┆ … ┆ 0.0 ┆ 1.0 ┆ 4.0  ┆ 4.0  │
#> │ 4.0 ┆ 108.0 ┆ 3.85 ┆ 2.32  ┆ … ┆ 1.0 ┆ 1.0 ┆ 4.0  ┆ 1.0  │
#> │ 6.0 ┆ 258.0 ┆ 3.08 ┆ 3.215 ┆ … ┆ 1.0 ┆ 0.0 ┆ 3.0  ┆ 1.0  │
#> │ 8.0 ┆ 360.0 ┆ 3.15 ┆ 3.44  ┆ … ┆ 0.0 ┆ 0.0 ┆ 3.0  ┆ 2.0  │
#> │ …   ┆ …     ┆ …    ┆ …     ┆ … ┆ …   ┆ …   ┆ …    ┆ …    │
#> │ 4.0 ┆ 95.1  ┆ 3.77 ┆ 1.513 ┆ … ┆ 1.0 ┆ 1.0 ┆ 5.0  ┆ 2.0  │
#> │ 8.0 ┆ 351.0 ┆ 4.22 ┆ 3.17  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 4.0  │
#> │ 6.0 ┆ 145.0 ┆ 3.62 ┆ 2.77  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 6.0  │
#> │ 8.0 ┆ 301.0 ┆ 3.54 ┆ 3.57  ┆ … ┆ 0.0 ┆ 1.0 ┆ 5.0  ┆ 8.0  │
#> │ 4.0 ┆ 121.0 ┆ 4.11 ┆ 2.78  ┆ … ┆ 1.0 ┆ 1.0 ┆ 4.0  ┆ 2.0  │
#> └─────┴───────┴──────┴───────┴───┴─────┴─────┴──────┴──────┘