cheapr (version 1.4.0)

replace: Fast vector replacement, an alternative to [<-

Description

Fast vector replacement, an alternative to [<-

Usage

replace_(x, where, with, in_place = FALSE, quiet = FALSE)

Value

A vector whose values are replaced with with at locations specified by where.

Arguments

x

A vector.

where

[integer(n)] - Where to assign replacement values. This can be an integer vector of locations, a logical vector (passed to which_()), or a character vector of names.

with

Replacement values. These will be recycled against the resulting where integer locations.

in_place

[logical(1)] - Should assignment be done in-place (no copies)? Default is FALSE. Please note that assignment will occur in-place where possible even if in_place is set to FALSE.

quiet

Should warnings be suppressed when in_place = TRUE and x is shared my multiple objects? Default is FALSE.

Examples

library(cheapr)

x <- set_round(seq_(-2, 2, by = 0.5))

x |>
  replace_(1, with = 100) # Assign value 100 at location 1

# Base R casts to `x` and replacement to a common type
`[<-`(x, x== 0, "42")

# `assign_at` only casts replacement to type of x
x |>
  replace_(x == 0, with = "42") # Assign value 42 where x == 0