Главная    Разработка ПО    функции языка Си

Описание функций языка Си

" R "

remainder, remainderf, remainderl 

remove 

rename 

rewind 

remquo,remquo,remquo 

round,roundf,roundl 

rint,rintf,rintl 

All | _ | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

rename – переименование файла или каталога.

Синтаксис:

#include < stdio.h >
int rename (const char *old_name, const char *new_name);

Аргументы:

old_name – указатель на строку содержащую текущее маршрутное имя файла или каталога.
new_name - указатель на строку содержащую новое маршрутное имя файла или каталога.

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

0 – при успешном переименовании файла
-1 – если при работе функции возникли ошибки, при этом переменной errno будет присвоен код ошибки. Узнать описание возникшей ошибки можно с помощью функции perror.

Описание:

Функция переименовывает файл или каталог. Если оба аргумента функции совпадают и указывают на один и тот же файл или каталог, то функция не будет производить никаких действий и вернет признак успешного завершения.

Если файл или каталог с именем new_name уже существует, то он будет удален, а файл или каталог с именем old_name будет переименован в new_name.

Если переименовывается каталог, то его новое маршрутное имя должно указывать новый каталог, а не файл. Так же если переименовывается файл, то его новое маршрутное имя должно указывать на файл, а не на каталог.

Маршрутное имя new_name не должно содержать префикса, именующего old_name. Например, если переименовывается каталог “save/newdata”, то новое имя не может содержать префикс “save/newdata”, то есть не может иметь вид, например, save/newdata/cars”

Пример:

В примере переименовывается каталог myfile, располагающейся в директории, из которой запускается программа. Новое название каталога: “mycat”.


#include < stdio.h >  // Для printf, rename

int main (void)
{    
   printf (“Переименование каталога: ”);
   // Переименование каталога
   if (-1 == rename (“myfile”,” mycat”))
      printf (“Ошибка\n”);
   else 
      printf (“Выполнено\n”);

   return 0;
}

Результат:

Вывод на консоль:

Переименование каталога: выполнено



В результате работы программы, в каталоге, из которого запускается программа, вместо папки myfile появилась папка mycat, при этом содержимое папке myfile осталось неизменным и находится в папке mycat.

Смотри так же:

rename
link
remove
rmdir
tmpfile
tmpnam
unlink


Яндекс.Метрика

Рейтинг@Mail.ru