R: Translate a vector of strings

translateStrings {alakazam} | R Documentation

## Translate a vector of strings

### Description

`translateStrings` modifies a character vector by substituting one or more strings with a replacement string.

### Usage

    translateStrings(strings, translation)

### Arguments

`strings` | vector of character strings to modify.
`translation` | named character vector or a list of character vectors specifying the strings to replace (values) and their replacements (names).

### Details

Does not perform partial replacements. Each translation value must match a complete `strings` value or it will not be replaced. Values that do not have a replacement named in the `translation` parameter will not be modified.

Replacement is accomplished using gsub.

### Value

A modified `strings` vector.

### See Also

See gsub for single value replacement in the base package.

### Examples

    # Using a vector translation
    strings <- LETTERS[1:5]
    translation <- c("POSITION1"="A", "POSITION5"="E")
    translateStrings(strings, translation)

    # Using a list translation
    strings <- LETTERS[1:5]
    translation <- list("1-3"=c("A","B","C"), "4-5"=c("D","E"))
    translateStrings(strings, translation)

[Package alakazam version 0.3.0 Index]