creatnew

Remonter à Io.h - Index

Header File

io.h

Category

Input/output Routines

Prototype

int creatnew(const char *path, int mode);

Description

Creates a new file.

creatnew is identical to _rtl_creat with one exception: If the file exists, creatnew returns an error and leaves the file untouched.

The mode argument to creatnew can be zero or an OR-combination of any one of the following constants (defined in dos.h):

FA_HIDDEN	Hidden file
FA_RDONLY	Read-only attribute
FA_SYSTEM	System file

Return Value

Upon successful completion, creatnew returns the new file handle, a nonnegative integer; otherwise, it returns -1.

In the event of error, the global variable errno is set to one of the following values:

EACCES	Permission denied
EEXIST	File already exists
EMFILE	Too many open files
ENOENT	Path or file name not found

Example

 #include <string.h>
 #include <stdio.h>
 #include <errno.h>
 #include <io.h>
 int main(void)
 {
    int handle;
    char buf[11] = "0123456789";
    /* attempt to create a file that doesn't already exist */
    handle = creatnew("DUMMY.FIL", 0);
 if (handle == -1)
       printf("DUMMY.FIL already exists.\n");
    else
    {
       printf("DUMMY.FIL successfully created.\n");
       write(handle, buf, strlen(buf));
       close(handle);
    }
    return 0;
 }

Portability

POSIX	Win32	ANSI C	ANSI C++
	+