R: Replace string using regular expression

regexprep {pracma} | R Documentation

## Replace string using regular expression

### Description

Replace string using regular expression.

### Usage

    regexprep(s, expr, repstr, ignorecase = FALSE, once = FALSE)

### Arguments

`s` | Single character string.
`expr` | Regular expression to be matched.
`repstr` | String that replaces the matched substring(s).
`ignorecase` | logical, whether to ignore case.
`once` | logical, shall only the first or all occurences be replaced.

### Details

Matches the regular expression against the string and replaces the first or all non-overlapping occurrences with the replacement string.

The syntax for regular expression has to be PERL-like.

### Value

String with substrings replaced.

### Note

The Matlab/Octave variant allows a character vector. This is not possible here as it would make the return value quite complicated.

### See Also

`gsub`

### Examples

    s <- "bat cat can car COAT court cut ct CAT-scan"
    pat <-  'c[aeiou]+t'
    regexprep(s, pat, '---')
    regexprep(s, pat, '---', once = TRUE)
    regexprep(s, pat, '---', ignorecase = TRUE)

[Package pracma version 2.0.4 Index]