在<stdio.h>头文件下

以下内容来自：http://www.cplusplus.com/reference/cstdio/rename/?kw=rename

rename

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

Rename file

Changes the name of the file or directory specified by oldname to newname.

This is an operation performed directly on a file; No streams are involved in the operation.

If oldname and newname specify different paths and this is supported by the system, the file is moved to the new location.

If newname names an existing file, the function may either fail or override the existing file, depending on the specific system and library implementation.

Proper file access shall be available.

Parameters

• oldname

  C string containing the name of an existing file to be renamed and/or moved. Its value shall follow the file name specifications of the running environment and can include a path (if supported by the system).

• newname

  C string containing the new name for the file. Its value shall follow the file name specifications of the running environment and can include a path (if supported by the system).

Return value

If the file is successfully renamed, a zero value is returned. On failure, a nonzero value is returned. On most library implementations, the errno variable is also set to a system-specific error code on failure.

Example

/* 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;
}

If the file oldname.txt could be successfully renamed to newname.txt the following message would be written to stdout:

File successfully renamed

Otherwise, a message similar to this will be written to stderr:

Error renaming file: Permission denied

rename

更改文件或路径的名字，由 oldname 改成 newname 。

这是直接在文件上执行的操作；操作中不涉及任何流。

如果 oldname 和 newname 指定不同的路径，并且系统支持的话，则文件将移到新位置。

如果 newname 为已经存在的文件名字，则该函数可能会失败或覆盖现有文件，这取决于特定的系统和库实现。

应提供适当的文件访问。

参数

• oldname

  包含要重命名和/或移动的现有文件的名称的字符串。它的值应该遵循运行环境的文件名规范，并且可以包括一个路径(如果系统支持的话)。

• newname

  包含文件新名称的字符串。它的值应该遵循运行环境的文件名规范，并且可以包括一个路径(如果系统支持的话)。

返回值

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