phobos ~master (2023-10-10T16:11:09Z)

translate

std string

Replaces the characters in str which are keys in transTable with their corresponding values in transTable. transTable is an AA where its keys are dchar and its values are either dchar or some type of string. Also, if toRemove is given, the characters in it are removed from str prior to translation. str itself is unaltered. A copy with the changes is returned.

  1. C1[] translate(C1[] str, dchar[dchar] transTable, const(C2)[] toRemove)
    @safe pure
    C1[]
    translate
    (
    C1
    C2 = immutable char
    )
    (
    C1[] str
    ,
    in dchar[dchar] transTable
    ,
    const(C2)[] toRemove = null
    )
    if (
    isSomeChar!C1 &&
    isSomeChar!C2
    )
  2. C1[] translate(C1[] str, S[dchar] transTable, const(C2)[] toRemove)
  3. void translate(const(C1)[] str, dchar[dchar] transTable, const(C2)[] toRemove, Buffer buffer)
  4. void translate(C1[] str, S[dchar] transTable, const(C2)[] toRemove, Buffer buffer)
  5. C[] translate(const(char)[] str, const(char)[] transTable, const(char)[] toRemove)
  6. void translate(const(char)[] str, const(char)[] transTable, const(char)[] toRemove, Buffer buffer)

Parameters

str C1[]

The original string.

transTable dchar[dchar]

The AA indicating which characters to replace and what to replace them with.

toRemove const(C2)[]

The characters to remove from the string.

Examples

dchar[dchar] transTable1 = ['e' : '5', 'o' : '7', '5': 'q'];
assert(translate("hello world", transTable1) == "h5ll7 w7rld");

assert(translate("hello world", transTable1, "low") == "h5 rd");

string[dchar] transTable2 = ['e' : "5", 'o' : "orange"];
assert(translate("hello world", transTable2) == "h5llorange worangerld");

See Also

tr, std.array.replace, std.algorithm.iteration.substitute

Meta

Source

See Implementation

std string aliasesclassesfunctions

Page generated by adrdox