Convert a text file to an array
──────────────────────────────────────────────────────────────────────────────

 Syntax

        GT_File2a(<cFile>,[<aData>]) -> aData

 Arguments:

      <cFile> is the name (including any path and
      extension) of the text file to read from.

      <aData> is an array to use to put the data into
      added.

 Returns:

      GT_File2a() returns an array.

 Description:

      To read a text file in line by line and build an
      array of the text, one line for each array element.

 Examples:

      // Build a new array
      aData := GT_File2a('C:\Import.txt')

      // And add some more ....
      aData := GT_File2a('C:\Import2.txt',aData)

 Source: GT_FILE2.PRG

 Author:  Martin Bryant