← C 语言标准库函数 - atol() C 语言库函数 - isalpha() →

C 语言标准库函数 - rename()

C 语言标准库 <stdio.h> 函数 rename() 把 old_filename 所指向的文件名改为 new_filename

头文件

#include <stdio.h>

函数原型

下面是 rename() 函数的原型

int rename(const char *old_filename, const char *new_filename)

参数

old_filename ：这是 C 字符串，包含了要被重命名/移动的文件名称。
new_filename ：这是 C 字符串，包含了文件的新名称。

返回值

如果成功，则返回 0
如果错误，则返回 -1，并设置 errno。

范例

下面的范例演示了 rename() 函数的用法

/**
 * file: main.c
 * author: 简单教程(www.twle.cn)
 *
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
 */

#include <stdio.h>

int main ()
{
   int ret;
   char oldname[] = "demo.txt";
   char newname[] = "newfile.txt";

   ret = rename(oldname, newname);

   if(ret == 0) 
   {
      printf("文件重命名成功");
   }
   else 
   {
      printf("错误：不能重命名该文件");
   }

   return(0);
}

假设存在文件 demo.txt

编译运行以上范例，输出结果如下

$ gcc main.c && ./a.out
文件重命名成功

同时发现，原来的文件 demo.txt 被重命名为 newfile.txt 文件了

返回上一级

← C 语言标准库函数 - atol() C 语言库函数 - isalpha() →