# GT_NEWFLAG()

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. ll flags are set to FLSE.

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 in 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.

    See Also

    GT_SETFLAG() GT_CLRFLAG() GT_ISFLAG()