Template::Plugin::Assert - trap undefined values


Template-Toolkit documentation  | view source Contained in the Template-Toolkit distribution.

Index


NAME

Top

Template::Plugin::Assert - trap undefined values

SYNOPSIS

Top

    [% USE assert %]

    # throws error if any undefined values are returned
    [% object.assert.method %]
    [% hash.assert.key %]
    [% list.assert.item %]

DESCRIPTION

Top

This plugin defines the assert virtual method that can be used to automatically throw errors when undefined values are used.

For example, consider this dotop:

    [% user.name %]

If user.name is an undefined value then TT will silently ignore the fact and print nothing. If you USE the assert plugin then you can add the assert vmethod between the user and name elements, like so:

    [% user.assert.name %]

Now, if user.name is an undefined value, an exception will be thrown:

    assert error - undefined value for name

AUTHOR

Top

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

COPYRIGHT

Top

SEE ALSO

Top

Template::Plugin


Template-Toolkit documentation  | view source Contained in the Template-Toolkit distribution.