HTP

htp on-line reference : WHILE

Table of Contents
  Introduction
  License
  Tutorial
  Usage
  HTP Tags
    ALTTEXT
    BLOCK
    BLOCKDEF
    DEF
    FILE
    IF
    INC
    IMG
    IMAGEURL
    OPT
    OUTPUT
    QUOTE
    SET
    UNDEF
    UNSET
    USE, $
  > WHILE
    <!---
  History
  Wish list
  Bugs

syntax

<[ref]use macroname [parameters ...] [noexpand]>
<... $macroname ...>
<... ${macroname} ...>

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. If the NOT tag is present in the WHILE markup, the evaluation of the conditional is reversed:

<[ref]block stuff>
  <a href=$email>send email</a>
<[ref]/block>

<[ref]set morestuff=$email>

This works:     <[ref]use stuff email="jnelson@crl.com">
But this fails: <[ref]use email>
And this fails: <[ref]use morestuff email="jnelson@crl.com">

Just as with [ref]IF you can also check for a macro's existance:

<a href="mailto:$email">mailto hyperlink</a>
<a href="http://$domain/~${username}/">another hyperlink</a>

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.

  page source
  htp project
  htp homepage
hosted by
Sourceforge
HTML coding Powered by htp
htp on-line reference / http://htp.sourceforge.net/ref/
Authors: Jim Nelson, Jochen Hoenicke, Michael Möller.
Maintainers: Jochen Hoenicke.

Copyright © 1995–96 Jim Nelson.
Copyright © 2001–2014 Jochen Hoenicke.
Permission to reproduce and distribute this hypertext document granted according to terms described in the License section.

last updated Sat May 16, 2015