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:

• A number from 1 to 100
  A slot (except the special slot 50) can not be reused. It is used to enable you to tell PPWIZARD the order that 'TheText' should be executed. To have your exit processing occur first use slot 1, to have your processing last use slot 100. Processing occurs in order of slot number and in the case of slot 50 in the order they were specified.

• Omitted
  If not supplied a slot number of 50 is used.

• The text "EXEC"
  This is a ppwizard command which performs exactly the same function as the /Validate switch.

The "TheText" parameter can contain macro references but it's meaning depends on the slot parameter:

• "EXEC" was used
  Any macros are immediately expanded and information stored. Format is as specified for the /Validate switch.

• Normal Processing
  Any macros and parameters etc are not expanded until exit processing occurs.

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>
    

PPWIZARD Manual

Thursday January 17 2002 at 6:27pm