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

GetIdPrepare()

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 used to prepare a handle for use in the GetId() routine.

The function takes 2 parameters:

1. The handle to be used in GetId() and SetId().

2. An optional parameter which if 'Y' means that you wish unique IDs generated by GetId() for what are probably non-unique values (or keys). When you specify unique IDs you are only allowed to use SetId() with a key of '' otherwise you are contradicting yourself!

   Normally when GetId() is called you pass it a unique key for which you wish a unique ID generated. If you ask for an ID for the same key at some later stage the original ID is returned.

   When 'Y' is used you intend to pass non-unique keys but YOU ensure or know that each time GetId() is called it is for a different entity even if the key looks identical! GetId() will generate a unique ID each time it is called and will not remember it. This mode can generate "prettier" IDs (at least until the key is duplicated) and without tricky code. The "FTPLIKE.IH" add-on uses the "unique" mode.

PPWIZARD Manual

Thursday January 17 2002 at 6:27pm