creatnew

creatnew

Функция            Создает новый файл.

Синтаксис          #include <dos.h>
                   int creatnew(const char * path, int mode);

Файл, содержащий   io.h
прототип

Описание           creatnew идентична функции _creat, за исключением
                   того, что   если   файл   существует,  то  creatnew
                   возвращает ошибку и не изменяет файл.

                   Аргумент mode  в  creatnew  может  быть  одной   из
                   следующих констант (определенных в dos.h):

                     FA_DRONLY   Только чтение.
                     FA_HIDDEN   Скрытый файл.
                     FA_SYSTEM   Системный файл.

Возвращаемое       При успешном завершении creatnew возвращает дескрип-
значение           тор нового файла, неотрицательное число; иначе воз-
                   вращается -1.

                   В случае  ошибки  errno принимает одно из следующих
                   значений:

                     EEXIST - Файл уже существует.
                     ENOENT - Маршрут или имя файла не найдены.
                     EMFILE - Слишком много открытых файлов.
                     EACCES - Отказ доступа.

Переносимость      creatnew уникальна для DOS 3.0 и не работает на
                   более ранних версиях DOS.

Смотрите также     close, _creat, creat, creattemp, dup,
                   _fmode(переменная), open.

Пример:
              
#include<string.h>
#include<stdio.h>
#include<errno.h>
#include<dos.h>
#include<io.h>

int main(void)
{
   int handle;
   char buf[11] = "0123456789";

   /* попытка создать несуществующий файл */
   handle = creatnew("DUMMY.FIL",0);
   if(handle == -1)
      printf("DUMMY.FIL уже существует\n");
   else
   {
      printf("DUMMY.FIL успешно создан\n");
      write(handle,buf,strlen(buf));
      close(handle);
   }
   return 0;
}