PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.
[Bottom][Contents][Search][Prev]: <?QuestionMark>[Next]: <?RexxSkip>
\ -> Standard Definitions -> <?RestartLine>

<?RestartLine>

This symbol causes symbol replacement on a line to be restarted, some possible reasons for doing this are:

  1. By the time PPWIZARD macro replacement has taken place it is already decided that the line does not contain a PPWIZARD command. If you wish to dynamically generate PPWIZARD commands, you need to use this variable at the start of every command (you could have more than one).

  2. PPWIZARD expands definitions in a single pass from left to right. This means that you could not build up a reference to a variable from components unless you include this define.

  3. If you use "<??Variable>" to expand a rexx variable containing references to other symbols you may need to use this symbol (other things might force restart anyway).

PPWIZARD will stop replacement of macros, etc. as soon as it has expanded the first define of this type on the line, so its position on a line can greatly affect the way expansion occurs. The use of this variable could cause other unwanted affects; it is up to you to test to ensure you are obtaining the results you require.

This is a Standard Definition which always exists (you don't need to #define it). Note that you can create your own variations or completely new ones (see the examples).

Example

In this example the intention is to create the macro variable "X":

;--- "Command" contains the command we want executed ---
#define Command  #define X XXXXXXXXXXXXXXXXXXXXX

Attempt 1 - Fails
~~~~~~~~~~~~~~~~~
<$Command>

Attempt 2 - Works
~~~~~~~~~~~~~~~~~
<?RestartLine><$Command>

Test Definition
~~~~~~~~~~~~~~~
Number of x's ==> <$X>


email me  any feedback, additional information or corrections.
See this page online (look for updates)

[Top][Contents][Search][Prev]: <?QuestionMark>[Next]: <?RexxSkip>


PPWIZARD Manual
My whole website and this manual itself was developed using PPWIZARD (free preprocessor written by Dennis Bareis)
Sunday November 05 2017 at 10:00am