C 庫(kù)函數(shù) - rename()

C 標(biāo)準(zhǔn)庫(kù) - <stdio.h> C 標(biāo)準(zhǔn)庫(kù) - <stdio.h>

描述

C 庫(kù)函數(shù) int rename(const char *old_filename, const char *new_filename) 把 old_filename 所指向的文件名改為 new_filename。

聲明

下面是 rename() 函數(shù)的聲明。

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

參數(shù)

  • old_filename -- 這是 C 字符串，包含了要被重命名/移動(dòng)的文件名稱。
  • new_filename -- 這是 C 字符串，包含了文件的新名稱。

返回值

如果成功，則返回零。如果錯(cuò)誤，則返回 -1，并設(shè)置 errno。

實(shí)例

下面的實(shí)例演示了 rename() 函數(shù)的用法。

#include <stdio.h>

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

   if(ret == 0) 
   {
      printf("文件重命名成功");
   }
   else 
   {
      printf("錯(cuò)誤：不能重命名該文件");
   }
   
   return(0);
}

假設(shè)我們有一個(gè)文本文件 file.txt，它的內(nèi)容如下。我們將使用上面的程序來(lái)重命名該文件。讓我們編譯并運(yùn)行上面的程序，這將生成下面的消息，且文件被重命名為 newfile.txt 文件。

文件重命名成功

C 標(biāo)準(zhǔn)庫(kù) - <stdio.h> C 標(biāo)準(zhǔn)庫(kù) - <stdio.h>