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

 creat()                 Create a New File

 #include   <io.h>                       Required for declarations only
 #include   <sys\stat.h>

 int        creat(pathname, pmode);
 const char *pathname;                   Path name of new file
 int        pmode;                       Permission setting

    creat() either creates a new file or opens and truncates an existing
    file. If the file specified by 'pathname' does not exist, a new file
    is created and opened for writing. If the file already exists and its
    permission setting allows writing, the file is first truncated to
    zero length (destroying the previous contents) and then is opened for
    writing.

    'pmode' applies to newly created files only; the newly created file
    has the indicated permission set when it is closed. 'pmode' contains
    one or both of the constants S_IWRITE and S_IREAD.  The value of
    these constants are:

                S_IWRITE                Writing permitted
                S_IREAD                 Reading permitted
                S_IREAD | S_IWRITE      Reading and writing permitted


       Returns:     A handle for the new file, if successful. On error,
                    -1 is returned and 'errno' is set to one of the
                    following:

                    EACCES      Path name specifies a read only file, or
                                a directory
                    EMFILE      Too many open files.
                    ENOENT      Path name not found.

         Notes:     A call to open() with the O_CREATE and O_TRUNC values
                    specified in the 'oflag' argument is equivalent to
                    creat().

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

    The following statements open a file for reading and writing and
    print an error message if unsuccessful.

           #include <sys\stat.h>            /* constants defined*/
           #include <io.h>
           #include <stdlib.h>              /* perror declared*/

           int hndl;

           main()
           {
                 hndl = creat("data",S_IREAD | S_IWRITE);
                 if (hndl == -1)
                    perror("error opening data file");
           }