PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.
#OnExit |
This command allows you to register some text which after all other processing is itself processed as if it were read from a file as well as specifying a command to be executed after ppwizard has successfully processed the file.
This command is useful in standard header files where rather than requiring a user to use a macro before exiting it can be done automatically. An example of this might be in a common html header file where you use this command to automatically generate a standard footer at the end of your html.
The processing does not occur if a fatal error was detected.
Syntax |
[WhiteSpace]#OnExit [#Slot] TheText
The "Slot" parameter should be:
The slot information can't contain macro references etc, however if the supplied information is not an integer (for example it was "#SlotNumber") then PPWIZARD will first look for a rexx variable then a macro of that name and its contents is expected to be a valid slot number.
The "TheText" parameter can contain macro references but its meaning depends on the slot parameter:
If you require a specific slot number in code that others might use I suggest that the slot number be configurable. Any change and all risks are then up to the user.
EXAMPLE |
The following is used in one of my header files:
;--- Register checking macro --- #OnExit <$NestingCheck>
The following would generate an error as slot 1 is being reused:
;--- Register checking macro --- #OnExit #1 <$NestingCheck1> #OnExit #1 <$NestingCheck2>