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