PC Extra Super CD 1998 January/PCPLUS131.iso/DJGPP/V2/DJLSR201.ZIP/src/libc/dos/compat/d_creatn.txh

Text File | 1995-10-09 | 1.1 KB | 57 lines

@node _dos_creatnew, dos
@subheading Syntax

@example
#include <dos.h>

unsigned int _dos_creatnew(const char *filename, unsigned short attr, int *handle);
@end example

@subheading Description

This is a direct connection to the MS-DOS create unique function call
(%ah = 0x5B). This function creates the given file with the given
attribute and puts file handle into @var{handle} if creating is successful.
This function will fail if the specified file exists. Meaning of
@var{attr} parameter is the following:

@table @code

@item _A_NORMAL (0x00)

Normal file (no read/write restrictions)

@item _A_RDONLY (0x01)

Read only file

@item _A_HIDDEN (0x02)

Hidden file

@item _A_SYSTEM (0x04)

System file

@item _A_ARCH (0x20)

Archive file

@end table

@xref{_dos_open}. @xref{_dos_creat}. @xref{_dos_read}.
@xref{_dos_write}. @xref{_dos_close}

@subheading Return Value

Returns 0 if successful or DOS error code on error (and sets @var{errno}).

@subheading Example

@example
int handle;

if ( !_dos_creatnew("FOO.DAT", _A_NORMAL, &handle) )
   puts("Creating was successful !");
@end example