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.

Source: BITFLAGS.C

Author: Dave Pearson