当前位置： C语言 -- 标准库 -- <stdio.h> -- rename

rename函数

概要：

#include <stdio.h>
int rename(const char *old, const char *new);

描述：

该函数给文件重命名，将参数old指向的文件名重命名为参数new指向的文件名。

如果重命名后的文件与现有文件重名，函数行为将由实现定义。

如果重命名成功，将不能使用原文件名访问文件。如果重命名不成功，并且调用rename函数前文件已经存在，这种情况下仍可以使用原文件名访问文件。实现可能导致rename函数调用失败的原因包括:重命名时文件处于打开状态，重命名必须复制文件内容等等。

参数：

const char *old

char类型指针，指向字符串表示重命名前的文件名(如果实现支持，文件名可以包含路径。)。

const char *new

char类型指针，指向字符串表示重命名后的文件名(如果实现支持，文件名可以包含路径。)。

返回值：

如果重命名成功，函数返回0；否则函数返回一个非0值。

范例：

/*函数rename范例*/

#include <stdio.h>

int main(void)
{
    const char oldName[] = "gch.txt";
    const char newName[] = "test.txt";

    if(rename(oldName, newName))
        puts("Fail to rename file.");
    else
        puts("File renamed successfully.");

    return 0;
}

结果：

如果重命名成功，将输出：

File renamed successfully.

如果不成功，将输出：

Fail to rename file.