NAME

App::vaporcalc::FormatString - Templated string formatter

SYNOPSIS

my $things = "some very special";
my $formatted = format_str( "My %string% with %this% var",
  this   => $things,
  string => "cool string",
);  ## -> My cool string with some very special var

DESCRIPTION

A tiny string formatter.

Exports a single function: "format_str"

format_str

Takes a string and a hash (or hash reference) mapping template variables to replacement strings.

The replacement variables can be coderefs returning a string:

format_str( "My string with %code",
  code => sub {
    my ($match, $orig, $callback) = @_;
    . . .
    return "Some string replacing variable $match"
  },
);

The code reference will receive the matching variable ("code"), the original matched string ("%code" in the above example), and itself as its respective arguments.

AUTHOR

Jon Portnoy <avenj@cobaltirc.org>