How to Use str_replace in R for String Replacement

In R, use str_replace(string, pattern, replacement) from the stringr package to replace the first occurrence of a pattern in a string. It searches for pattern and replaces it with replacement, returning the modified string.

Syntax

The str_replace function has three main parts:

• string: The text where you want to replace something.
• pattern: The part of the text you want to find and replace.
• replacement: The new text that will replace the pattern.

It replaces only the first match found in the string.

r

str_replace(string, pattern, replacement)

Example

This example shows how to replace the first occurrence of "cat" with "dog" in a sentence.

r

library(stringr)

text <- "The cat sat on the cat mat."
new_text <- str_replace(text, "cat", "dog")
print(new_text)

Output

[1] "The dog sat on the cat mat."

Common Pitfalls

One common mistake is expecting str_replace to replace all matches. It only replaces the first one. To replace all, use str_replace_all.

Also, forgetting to load the stringr package causes errors.

r

library(stringr)

text <- "apple apple apple"

# Wrong: only replaces first 'apple'
str_replace(text, "apple", "orange")

# Right: replaces all 'apple'
str_replace_all(text, "apple", "orange")

Output

[1] "orange apple apple"
[1] "orange orange orange"

Quick Reference

Function	Description
str_replace(string, pattern, replacement)	Replace first match of pattern in string
str_replace_all(string, pattern, replacement)	Replace all matches of pattern in string
stringr::str_replace	Use with package prefix if not loaded

Key Takeaways

Use str_replace from stringr to replace the first match of a pattern in a string.

To replace all matches, use str_replace_all instead.

Always load the stringr package with library(stringr) before using str_replace.

str_replace returns a new string; it does not change the original string.

Patterns can be simple text or regular expressions for flexible matching.