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

_creat()                 Create a New File

 #include   <dos.h>

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

    _creat() creates a new file or rewrites an existing file associated
    with the name 'filename'.  The file is created in the translation mode
    specified by the global variable '_fmode'.  ('_fmode' can either be
    set to O_TEXT or O_BINARY.)    To create a file in a particular mode,
    assign a value to '_fmode', or call open() with the O_CREAT and
    O_TRUNC option ORed with the translation mode desired.

    _creat() 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