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

creatnew()               Create a New File

 #include   <dos.h>

 int        creatnew(filename,attrib);
 char       *filename;                   Name of new file
 int        attrib;                      Attribute word

    creatnew() creates a new file associated with the name 'filename'.
    creatnew() is identical to _creat() except that, if the file exists,
    creatnew() returns an error and leaves the file untouched.

    _creatnew() accepts 'attrib' (an MS-DOS attribute word).  Any
    attribute bits may be set in this call.  The file is always opened in
    binary mode.  If successfully opened, the file pointer is set to the
    beginning of the file.  The file is opened for both reading and
    writing. 'attrib' must be one of the following constants (defined in
    <dos.h>):
                FA_RDONLY     Read only attribute
                FA_HIDDEN     Hidden file
                FA_SYSTEM     System file

    Returns:    If successfully created, the new file handle is returned.
                The file handle must be non-negative.  On error, -1 is
                returned and 'errno' (defined in <stdlib.h>) is set to one
                of the following:

                ENOENT        Path or file name not found
                EMFILE        Too many open files
                EACCES        Permission denied