---
layout: doc
title: filesystem / rename
---
# rename

### 名称

    rename() - 重命名一个文件

### 语法

    int rename( string src, string dst );

### 描述

    修改文件 `src` 的文件名为 `dst`

### 返回值

    rename() 改名成功返回 0 ，失败返回非零值。

### 参考

    rm(3), rmdir(3), cp(3), link(3)

### 翻译

    雪风(i@mud.ren)
