PURPOSE

To provide conditional execution of children nodes

NODE NAME

\s-1IF\s0

INHERITANCE

\s-1CONTAINER\s0

ATTRIBUTES

  • \s-1NAME\s0 This is the name of the parameter to test. It is resolved like any other parameter name. (q.v. \s-1VAR\s0 for more info.)

  • \s-1VALUE\s0 If \s-1VALUE\s0 is set, then a comparison operation is done. The value of \s-1NAME\s0 is compared to \s-1VALUE\s0 using the value of \s-1OP\s0.

  • \s-1OP\s0 If \s-1VALUE\s0 is set, then this is checked. If it isn't present, then '==' (numeric equality) is assumed. \s-1OP\s0 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 < or <=. This is to make sure it will parse with XML::Parser. You should not need to use > or >= instead of > and >=, respectively.

  • \s-1IS\s0 If \s-1VALUE\s0 is not set, then \s-1IS\s0 is checked. \s-1IS\s0 is allowed to be either \*(L"\s-1TRUE\s0\*(R" or \*(L"\s-1FALSE\s0\*(R". The boolean value of \s-1NAME\s0 is checked against \s-1IS\s0.

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 \s-1LOOP\s0 node) is false. So, for all even iterations.

AUTHOR

Rob Kinyon ([email protected])

RELATED TO Excel::Template::Container::Conditional…

\s-1LOOP\s0, \s-1VAR\s0