#NAME

Template::Namespace::Constants - Compile time constant folding

#SYNOPSIS

# easy way to define constants
use Template;

my $tt = Template->new({
    CONSTANTS => {
        pi => 3.14,
        e  => 2.718,
    },
});

# nitty-gritty, hands-dirty way
use Template::Namespace::Constants;

my $tt = Template->new({
    NAMESPACE => {
        constants => Template::Namespace::Constants->new({
            pi => 3.14,
            e  => 2.718,
        },
    },
});

#DESCRIPTION

The Template::Namespace::Constants module implements a namespace handler which is plugged into the Template::Directive compiler module. This then performs compile time constant folding of variables in a particular namespace.

#METHODS

#new(\%constants)

The new() constructor method creates and returns a reference to a new Template::Namespace::Constants object. This creates an internal stash to store the constant variable definitions passed as arguments.

my $handler = Template::Namespace::Constants->new({
    pi => 3.14,
    e  => 2.718,
});

#ident(\@ident)

Method called to resolve a variable identifier into a compiled form. In this case, the method fetches the corresponding constant value from its internal stash and returns it.

#AUTHOR

Andy Wardley <abw@wardley.org> http://wardley.org/

#COPYRIGHT

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

#SEE ALSO

Template::Directive

CONTENTS