rename, _wrename

Переименуйте файл или каталог.

int rename(
   const char *oldname,
   const char *newname 
);
int _wrename(
   const wchar_t *oldname,
   const wchar_t *newname 
);

Параметры

• oldname
  Указатель к старому имени.

• newname
  Указатель к новому имени.

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

Каждая из этих функций возвращает значение 0, если она успешно.При ошибке, функция возвращает ненулевое значение и наборы errno одно из следующих значений:

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

• ENOENT
  Путь к файлу или указанные by oldname не найдено.

• EINVAL
  Имя элемента содержит недопустимые символы.

Для других возможных возвращаемых значений см. в разделе _doserrno, _errno, syserrlist и _sys_nerr.

Заметки

Переименовать функция переименовывает файл или каталог, определенные by oldname имя заданного by newname.Старое имя должно быть путь для существующего файла или каталога.Новое имя не должно совпадать с именем существующего файла или каталога.Можно использовать Переименовать чтобы переместить файл из одного каталога или устройство к другой с передачей в другой путь newname аргумент.Однако нельзя использовать Переименовать переместить каталог.Каталоги можно переименовывать, но нельзя переместить.

_wrename версия расширенных символов _rename; аргументы _wrename характерные черты._wrename и _rename поступайте совпадают, в противном случае.

Сопоставления подпрограммы Родов-Текста

Требования

Дополнительные сведения о совместимости см. Совместимость во введении.

Библиотеки

Все версии Библиотеки времени выполнения C.

Пример

// crt_renamer.c
/* This program attempts to rename a file named
 * CRT_RENAMER.OBJ to CRT_RENAMER.JBO. For this operation
 * to succeed, a file named CRT_RENAMER.OBJ must exist and
 * a file named CRT_RENAMER.JBO must not exist.
 */

#include <stdio.h>

int main( void )
{
   int  result;
   char old[] = "CRT_RENAMER.OBJ", new[] = "CRT_RENAMER.JBO";

   /* Attempt to rename file: */
   result = rename( old, new );
   if( result != 0 )
      printf( "Could not rename '%s'\n", old );
   else
      printf( "File '%s' renamed to '%s'\n", old, new );
}

Output

File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'

Эквивалент в .NET Framework

System:: Ввода-вывода:: файл:: Переместить

См. также

Ссылки

Обработка файла