C 庫函數 - rename()

C 標準庫 - <stdio.h> C 標準庫 - <stdio.h>

描述

C 庫函數 int rename(const char *old_filename, const char *new_filename) 把 old_filename 所指向的檔案名改為 new_filename。

聲明

下麵是 rename() 函數的聲明。

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

參數

  • old_filename -- 這是 C 字串，包含了要被重命名/移動的檔案名稱。
  • new_filename -- 這是 C 字串，包含了檔的新名稱。

返回值

如果成功，則返回零。如果錯誤，則返回 -1，並設置 errno。

實例

下麵的實例演示了 rename() 函數的用法。

#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("錯誤：不能重命名該檔");
   }

   return(0);
}

假設我們有一個文本檔 file.txt，它的內容如下。我們將使用上面的程式來重命名該檔。讓我們編譯並運行上面的程式，這將生成下麵的消息，且檔被重命名為 newfile.txt 檔。

檔重命名成功

C 標準庫 - <stdio.h> C 標準庫 - <stdio.h>