Excel::Template::Container::Conditional(3) Excel::Template::Container::Conditional

PURPOSE

To provide conditional execution of children nodes

NODE NAME

IF

INHERITANCE

CONTAINER

ATTRIBUTES

  • NAME

    This is the name of the parameter to test. It is resolved like any other parameter name. (q.v. VAR for more info.)

  • VALUE

    If VALUE is set, then a comparison operation is done. The value of NAME is compared to VALUE using the value of OP.

  • OP

    If VALUE is set, then this is checked. If it isn't present, then '==' (numeric equality) is assumed. OP must be one of Perl the numeric comparison operators or the string comparison operators. All 6 of each kind is supported.

    Note: If you want to use < or <=, you must instead use &lt; or &lt;=. This is to make sure it will parse with XML::Parser. You should not need to use &gt; or &gt;= instead of > and >=, respectively.

  • IS

    If VALUE is not set, then IS is checked. IS is allowed to be either ``TRUE'' or ``FALSE''. The boolean value of NAME is checked against IS.

CHILDREN

None

EFFECTS

None

DEPENDENCIES

None

USAGE

  <if name="__ODD__" is="false">
    ... Children here
  </if>

In the above example, the children will be executed if the value of __ODD__ (which is set by the LOOP node) is false. So, for all even iterations.

AUTHOR

Rob Kinyon ([email protected])