Описание функций C (Си) / C++ - rename

Описание функций C (Си) / C++ - rename


#include требуется только для объявления
функции
#include использует либо , либо


int rename (oldname,newname);
char *oldname; указатель на старое имя
char *newname; указатель на новое имя

Описание.

Функция rename переименовывает файл или директорий, опреде-
ляемый по имени newname. Oldname должно задавать path-имя сущест-
вующего файла или директория. Newname не определяет имя уже су-
ществующего файла или директория. Функцию rename можно использо-
вать для перемещения файла из одного директория в другой, если
задать другое path-имя в аргументе newname. Однако, файлы не мо-
гут быть перемещены с одного устройства на другое (например, с
дисковода А на дисковод В). Директории можно переименовывать и
нельзя перемещать.

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

Функция rename возвращает 0, если она выполнена успешно. В
случае ошибки возвращается ненулевое значение и errno устанавли-
вается в одно из следующих значений:


Значение Его смысл

EACCES Файл или директорий, заданный по
newname, существует или не может быть
создан (неверный path), или oldname
является директорием и newname
определяет другой path.


ENOENT Файл или path-имя, заданные по oldname,
не найдены.

EXDEV Попытка перемещения файла на другое
устройство.


См.также create, fopen, open.


Замечание. Нужно заметить, что порядок аргументов в rename
для Microsoft C 4.0 противоположен порядку rename для ранних вер-
сий. Это изменение было сделано в соответствии со
стандартом ANSI.

Пример:

#include

int result;

/* следующий оператор изменяет имя файла "input" ** на имя
"data" */

result = rename("input", "data");






Опубликовал admin
11 Мар, Вторник 2008г.
Вентиляционные решетки. Купить решетки eksno.ru.


Программирование для чайников.