rename : 重命名文件

概要

#include <stdio.h>
int rename(const char *old, const char *new);
int _rename_r(void *reent, const char *old, const char *new);
```### 描述

使用 rename 为当前由 old 处的字符串所指定的文件建立一个新名称（new 处的字符串）。成功执行 rename 后，将无法再通过 old 处的字符串访问该文件。

如果 rename 失败，名为 *old 的文件不受影响。失败的条件取决于主机操作系统。

备用函数 _rename_r 是一个可重入版本。额外的参数 reent 是一个指向可重入结构的指针。### 返回值

结果为 0（成功时）或 -1（无法重命名文件时）。

---

**权威来源**: BUSMASTER DITA help source `rename.dita`, compiled into `BUSMASTER.CHM` with the application.