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

  Name:     fcreatef() - DOS 3.00 create file function
  Usage:    <integer> = fcreatef(<filename>,[<attrib>])
  Params:   string <filename> - file to create
            integer <attrib> - optional, attribute to use when
            opening the file, default is 0. Valid attributes are:

                 0    -    normal
                 1    -    read only
                 2    -    hidden
                 4    -    system

            or any combination of the above.

  Returns:  an integer to be used as the handle, or -1 for error

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

                 handle = fcreatef("a:test.txt")
                 if (ferror() != 0)
                      @ 0,0 say "File error "+str(ferror())+"..."
                 else
                      string = fwriteline(handle,memvar)
                 endif

  Note:     Fcreatef() functions identical to fcreate() except that
            if a file by the same name exists already it is not
            truncated to zero bytes. Instead, fcreatef() will return
            a -1 (error). fcreatef() will only work under DOS 3.00 and
            greater. If you try to use fcreatef() on a machine running
            a version of DOS less than 3.00, than a -1 (error) is
            always returned.