rename() - C語言庫函式


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字串,其中包含該檔案的新名稱。

返回值

成功則返回0。錯誤則返回-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("File renamed successfully");
   }
   else 
   {
      printf("Error: unable to rename the file");
   }
   
   return(0);
}

假設我們有一個文字檔案file.txt 一些內容。我們將重新命名此檔案。讓我們編譯和執行上面的程式,這將產生以下訊息,檔案將被更名到newfile.txt檔案。

File renamed successfully