Create a new bit flag string. ──────────────────────────────────────────────────────────────────────────────
Syntax
GT_NewFlag(<nFlagCount>) --> cFlagString
Arguments:
<nFlagCount> is the number of flags you wish to store.
Returns:
A string to hold the bit flags. All flags are set to FALSE.
Description:
GT_NewFlag() is used to construct a bit flag string. The bit flag functions can be used for storing a large number of logical values is a small space.
To create a bit flag string you need to pass GT_NewFlag() a value that is equal to or greater than the number of flags required (you may want to allow for future expansion). Each character in the string returned from GT_NewFlag() will hold 8 logical values.
Examples:
cFlags := GT_NewFlag(20) // Create a bit flag string for 20 // logical values.