Template::Plugin::Assert(3pm)

Template::Plugin::Assert3pm

Trap undefined values

Usage

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

Overview

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

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

Author

Andy Wardley <[email protected]> <http://wardley.org/>

From perl-template-toolkit 3.106-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.