PPWIZARD is a free preprocessor for HTML, REXX, Visual Basic or any text files.

SetId()

This is a rexx function provided by PPWIZARD. This routine (like all PPWIZARD extensions) can be used with any operating system supported by PPWIZARD.

This function is useful if you wish to ensure that when GetId() is called a specific value for an ID is used. An example of where this might be useful is if you have external entry points into a set of generated html pages. You normally would not care what they are called as long as all the links work, however as soon as you wish externally generated html to link to specific pages you must do something to ensure that the links name does not change.

The function takes 3 parameters as follows:

1. A handle that was previously prepared with GetIdPrepare().

2. The value (KEY) for which you are specifying an ID This is case sensitive, to make case insensitive simply convert your value to either upper or lower case before calling this routine.

   There is one situation where you may wish to pass a empty key ('') and that is when you specified unique ID mode on GetIdPrepare(). You would do this to pass an ID that you never want returned by GetId().

3. The ID you wish to give to the value (KEY). Note that this is not validated in any way. It is up to you to ensure it's correct.

Example

    #evaluate ''   ^call GetIdPrepare 'PPW'^
    #evaluate ''   ^call SetId 'PPW', '#define', "HashDef"^       ;;Set preferred ID
    #evaluate ''   ^say GetId('PPW', 'MAXCHARS', 'define')^
    #evaluate ''   ^say GetId('PPW', 'MAXCHARS', '#define')^
    

PPWIZARD Manual

Thursday January 17 2002 at 6:27pm