C語言 rename用法及代碼示例

C語言stdio頭文件(stdio.h)中rename函數的用法及代碼示例。

用法:

int rename ( const char * oldname, const char * newname );

重新命名文件

更改由指定的文件或目錄的名稱舊名至新名字。

這是直接在文件上執行的操作；該操作不涉及任何流。

如果舊名和新名字指定不同的路徑，這是係統支持的，文件將移動到新位置。

如果新名字命名現有文件後，該函數可能失敗或覆蓋現有文件，具體取決於特定的係統和庫的實現。

正確的文件訪問應可用。

參數

oldname: C字符串，包含要重命名和/或移動的現有文件的名稱。
其值應遵循運行環境的文件名規範，並且可以包含路徑(如果係統支持)。
newname: 包含文件新名稱的C字符串。
其值應遵循運行環境的文件名規範，並且可以包含路徑(如果係統支持)。

返回值

如果文件被成功重命名，則返回零值。
失敗時，將返回非零值。
在大多數庫實現中，errno變量也會在失敗時設置為system-specific錯誤代碼。

示例

/* rename example */
#include <stdio.h>

int main ()
{
  int result;
  char oldname[] ="oldname.txt";
  char newname[] ="newname.txt";
  result= rename( oldname , newname );
  if ( result == 0 )
    puts ( "File successfully renamed" );
  else
    perror( "Error renaming file" );
  return 0;
}

如果文件oldname.txt可以成功重命名為newname.txt以下消息將被寫入stdout：

File successfully renamed

否則，與此類似的消息將被寫入stderr：

Error renaming file: Permission denied

相關用法

注：本文由純淨天空篩選整理自C標準庫大神的英文原創作品 C rename function。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。