replaceFromAA

Replaces space-separated tokens (that begin with a token character) in a string with values from a supplied associative array.

The AA values are of some type of function or delegate returning strings.

@safe

auto

replaceFromAA

(

char tokenCharacter = '$'

)

(

const string line

const Fn[string] aa

)

Parameters

tokenCharacter: What character to use to denote tokens, defaults to '$' but may be any char.
line string: String to replace tokens in.
aa Fn[string]: Associative array of token keys and replacement callable values.

Return Value

Type: auto

A new string with occurrences of any passed tokens replaced, or the original string as-is if there were no changes made.

Examples

const @safe string delegate()[string] aa =
[
    "$foo"  : () => "bar",
    "$baz"  : () => "quux"
    "$now"  : () => Clock.currTime.toISOExtString(),
    "$rng"  : () => uniform(0, 100).to!string,
    "$hirr" : () => 10.to!string,
];

immutable line = "first $foo second $baz third $hirr end";
enum expected = "first bar second quux third 10 end";
immutable actual = line.replaceFromAA(aa);
assert((actual == expected), actual);

static auto echo(const string what) { return what; }

immutable hello = "hello";

@safe string delegate()[string] aa =
[
    "$foo" : () => hello,
    "$bar" : () => echo("I was one"),
    "$baz" : () => "BAZ",
];

enum line = "I thought what I'd $foo was, I'd pretend $bar of those deaf-$baz";
enum expected = "I thought what I'd hello was, I'd pretend I was one of those deaf-BAZ";
immutable actual = line.replaceFromAA(aa);
assert((actual == expected), actual);