C语言 rename用法及代码示例

C语言stdio头文件(stdio.h)中rename函数的用法及代码示例。

用法:

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

重新命名文件

更改由指定的文件或目录的名称旧名至新名字。

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

如果旧名和新名字指定不同的路径，这是系统支持的，文件将移动到新位置。

如果新名字命名现有文件后，该函数可能失败或覆盖现有文件，具体取决于特定的系统和库的实现。

正确的文件访问应可用。

参数

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

返回值

如果文件被成功重命名，则返回零值。
失败时，将返回非零值。
在大多数库实现中，errno变量也会在失败时设置为system-specific错误代码。

示例

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

相关用法

注：本文由纯净天空筛选整理自C标准库大神的英文原创作品 C rename function。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。