rename-c和c++标准函数

C&C++标准库

rename

函数 <cstdio>

int rename ( const char * oldname, const char * newname );
重命名文件
将oldname指定的文件或目录的名称更改为newname。
这是直接在文件上执行的操作;操作中不涉及流。
如果oldname和newname指定不同的路径，并且系统支持这一点，则将文件移动到新的位置。
如果newname命名了一个现有文件，该函数可能会失败或覆盖现有文件，这取决于特定的系统和库实现。

应有相应的文件访问权限.

☲ 参数

oldname
C字符串，包含要重命名和/或移动的现有文件的名称。
它的值应遵循运行环境的文件名规范.并且可以包含路径（如果系统支持）.

newname
包含文件的新名称的C字符串。
它的值应遵循运行环境的文件名规范.并且可以包含路径（如果系统支持）.

☉ 返回值

如果文件重命名成功，则返回零值。
失败时，返回一个非零值.
在大多数库实现中,errno变量还设置为失败时系统特定的错误代码.

☣ 示例

/* rename example */
#include <stdio.h>

int main ()
{
  int result;
  char oldname[] ="oldname.txt";
  char newname[] ="newname.txt";
  result= rename( oldname , newname );
  if ( result == 0 )
    puts ( "File successfully renamed" );
  else
    perror( "Error renaming file" );
  return 0;
}

如果oldname.txt文件可以成功重命名为newname.txt，则以下消息将被写入stdout:
File successfully renamed
否则，类似于此的消息将被写入stderr:
Error renaming file: Permission denied

🍄 另请参阅

remove

删除文件 (function )