# Template::Constants - phpMan

## NAME
    [Template::Constants] - Defines constants for the Template Toolkit

## SYNOPSIS
        use [Template::Constants] qw( :status :error :all );

## DESCRIPTION
    The "[Template::Constants]" modules defines, and optionally exports into
    the caller's namespace, a number of constants used by the Template
    package.

    Constants may be used by specifying the "[Template::Constants]" package
    explicitly:

        use [Template::Constants];
        print [Template::Constants::STATUS_DECLINED];

    Constants may be imported into the caller's namespace by naming them as
    options to the "use [Template::Constants]" statement:

        use [Template::Constants] qw( STATUS_DECLINED );
        print STATUS_DECLINED;

    Alternatively, one of the following tagset identifiers may be specified
    to import sets of constants: '":status"', '":error"', '":all"'.

        use [Template::Constants] qw( :status );
        print STATUS_DECLINED;

    Consult the documentation for the "Exporter" module for more information
    on exporting variables.

## EXPORTABLE TAG SETS
    The following tag sets and associated constants are defined:

        :status
            STATUS_OK             # no problem, continue
            STATUS_RETURN         # ended current block then continue (ok)
            STATUS_STOP           # controlled stop (ok)
            STATUS_DONE           # iterator is all done (ok)
            STATUS_DECLINED       # provider declined to service request (ok)
            STATUS_ERROR          # general error condition (not ok)

        :error
            ERROR_RETURN          # return a status code (e.g. 'stop')
            ERROR_FILE            # file error: I/O, parse, recursion
            ERROR_UNDEF           # undefined variable value used
            ERROR_PERL            # error in [% PERL %] block
            ERROR_FILTER          # filter error
            ERROR_PLUGIN          # plugin error

        :chomp                  # for PRE_CHOMP and POST_CHOMP
            CHOMP_NONE            # do not remove whitespace
            CHOMP_ONE             # remove whitespace to newline
            CHOMP_ALL             # old name for CHOMP_ONE (deprecated)
            CHOMP_COLLAPSE        # collapse whitespace to a single space
            CHOMP_GREEDY          # remove all whitespace including newlines

        :debug
            DEBUG_OFF             # do nothing
            DEBUG_ON              # basic debugging flag
            DEBUG_UNDEF           # throw undef on undefined variables
            DEBUG_VARS            # general variable debugging
            DEBUG_DIRS            # directive debugging
            DEBUG_STASH           # general stash debugging
            DEBUG_CONTEXT         # context debugging
            DEBUG_PARSER          # parser debugging
            DEBUG_PROVIDER        # provider debugging
            DEBUG_PLUGINS         # plugins debugging
            DEBUG_FILTERS         # filters debugging
            DEBUG_SERVICE         # context debugging
            DEBUG_ALL             # everything
            DEBUG_CALLER          # add caller file/line info
            DEBUG_FLAGS           # bitmap used internally

        :all
            All the above constants.

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

## COPYRIGHT
    Copyright (C) 1996-2007 Andy Wardley. All Rights Reserved.

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

## SEE ALSO
    Template, "Exporter"