Create a new file or overwrite an existing file.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <fcntl.h>

int creat(const char *filename, int mode);

Parameters for this facility are:

filename	int	The name of the file being created
mode	int	The open mode

This function creates a file named filename you can write to. If the file does not exist, creat() creates it. If the file already exists, creat() overwrites it. The function ignores the argument mode.

This function call:

is equivalent to this function call:

If it's successful, creat() returns the file description for the created file. If it encounters an error, it returns -1.

"fopen"

"fdopen"

"open"

"close".

#include <stdio.h>
#include <unix.h>

int main(void)
{
	int fd;
	
	fd = creat("Jeff:Documents:mytest", 0);
		/* Creates a new file named mytest in the folder
			Documents on the volume Akbar. */

	write(fd, "Hello world!\n", 13);
	close(fd);
	return 0;
}