Функция remove

Прототип функции remove:

int remove( const char * fname );

Заголовочный файл

Описание

Функция remove удаляет файл, имя которого указано в параметре fname. Эта операция производится непосредственно с файлом, нет потоков, участвующих в операции удаления.

Параметры:

• fname
  Cи-строка, содержащая имя файла, который необходимо удалить. Этот параметр должен соответствовать правилам именования файлов в используемой системе, и может включать в себя путь, если система поддерживает его.

Возвращаемое значение

Если файл успешно удален, функция возвращает нулевое значение.
В случае ошибки, возвращается ненулевое значение и макрос ERRNO инициализируется соответствующим кодом ошибки.

Строка, интерпретирующая это значение может быть выведена на стандартный поток ошибок при вызове функции perror.

Пример: исходный код программы

// пример использования функции: remove для удаления файла file.txt

#include <iostream>                             // для оператора cout
#include <cstdio>                               // для функции remove

int main ()
{
  if( remove( "file.txt" ) != 0 )             // удаление файла file.txt
      std::cout << "Ошибка удаления файлаn";
  else
      std::cout << "Файл успешно удалёнn";
  return 0;
}

Пример работы программы

Если файл file.txt существовал до запуска программы, то файл будет удален, и это сообщение будет записано в стандартный вывод:

В противном случае, сообщение, похожее на это будет записано на стандартный вывод: