append_column: Add a (Named) Vector as a Column

In tesselle/arkhe: Tools for Cleaning Rectangular Data

Add a (Named) Vector as a Column

Description

Add a (Named) Vector as a Column

Usage

append_column(x, ...)

## S4 method for signature 'data.frame'
append_column(x, column, after = 0, var = ".col")

Arguments

x	A data.frame.
...	Currently not used.
column	A (named) vector.
after	A length-one numeric vector specifying a subscript, after which the new column is to be appended.
var	A character string giving the name of the new column.

Details

If column is named, names will be matched to the row names of x. Only the first match is retained, and elements of column without a match are removed. This allows to add as a column a vector whose length is less than the number of rows in x (NAs will be inserted).

Value

A data.frame.

Author(s)

N. Frerebeau

See Also

Other data preparation tools: append_rownames(), assign(), compact(), count(), detect(), discard(), get(), keep(), seek()

Examples

X <- data.frame(
  x = 1:5,
  y = 6:10,
  row.names = LETTERS[1:5]
)

Y <- c(D = 44, B = 55, Z = 22)

append_column(X, Y, after = 3)

tesselle/arkhe documentation built on Feb. 1, 2025, 9:24 a.m.