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

  Name:     freadlong() - read in a long integer from a file
  Usage:    <integer> = freadlong(<handle>)
  Params:   integer <handle> - handle from a previous fopen()
  Returns:  unsigned integer equal to a long (4 bytes read), -1 for error

 ---------------------------------- Example ---------------------------------

                 handle = fopen("test.txt")
                 numarray[1] = freadlong(handle)
                 numarray[2] = freadlong(handle)

  Note:     The file pointer is moved ahead 4 bytes. If an error
            occurs a -1 is returned. A long value is in the range
            0 to 4,294,967,295 and occupies 4 bytes in the file
            in low byte/high byte notation. freadlong() should
            only be used to read in long integers written by
            fwritelong() or other programs that write longs in low
            byte/high byte notation Like 'C'. Using freadint() or

            freadlong() eliminates the need to use the fread() and
            bin2i() or bin2l() functions to convert a string to an integer.