htp on-line reference : WHILE

table of contents
  Introduction
  Usage
  Files
  Concepts
  HTP Tags
   ALTTEXT
   BLOCK
   BLOCKDEF
   DEF
   FILE
   IF
   INC
   IMG
   OPT
   OUTPUT
   QUOTE
   SET
   UNDEF
   UNSET
   USE, $
   WHILE
   <!---
  History
  Wish list
  Bugs

syntax

<WHILE [NOT] conditional >
    block
</WHILE>

synopsis

WHILE is the building block for repeated processing. The basic form is shown above.

"Conditional" is either a "compare" or "is defined" operation. A compare operator is a test of the value of a macro against a literal string:

    <WHILE name="Jim">

and a defined operator is a test of a macro's existance:

    <WHILE name>

If the NOT tag is present in the WHILE markup, the evaluation of the conditional is reversed.

If the condition is true, the block is evaluated and afterwards the WHILE tag is evaluated again. If the '$'-operator is used in the WHILE tag it is also reevaluated on each iteration.

A loop block must be closed with the /WHILE tag.

htp project

htp homepage

hosted by
SourceForge.net Logo

htp on-line reference / http://htp.sourceforge.net/ref/
Authors: Jim Nelson, Jochen Hoenicke, Michael Möller.
Maintainers: Jochen Hoenicke, Michael Möller.

Copyright © 1995-96 Jim Nelson.
Copyright © 2001-2002 Jochen Hoenicke, Michael Möller.
Permission to reproduce and distribute this hypertext document granted according to terms described in the Introduction

last updated Mon May 27, 2002