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

In cheapr: Simple Functions to Save Time and Memory

Fast vector replacement, an alternative to ⁠[<-⁠

Description

Fast vector replacement, an alternative to ⁠[<-⁠

Usage

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

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.

Value

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

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

cheapr documentation built on Nov. 28, 2025, 5:06 p.m.