Click above to get retro games delivered to your door ever month!

 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