> Erlang中文手册 > rename/2 更改文件名字

file:rename/2

更改文件名字

用法:

rename(Source, Destination) -> ok | {error, Reason}

尝试把源文件名 Source 改为目标文件名 Destination,如果操作成功,则返回 ok;也可以用作目录间的文件移动,但是必须制定最终的文件名。例如,rename("foo/bar", "bar") 将返回一个错误,rename("foo/bar", "baz/bar") 可以正常运行。

一些典型的错误:

  • eacces:对源文件或目标文件缺少读或写的权限。
  • eexist:目标文件已经存在。
  • einval:源文件是一个根目录,或目标文件是源文件的一个子目录。
  • eisdir:目标文件是一个目录,源文件不是。
  • enoent:源文件不存在。
  • enotdir:源文件是一个目录,目标文件不是。
  • exdev:源文件和目标文件在不同文件系统上。
file:rename("./test1.txt", "./test2.txt").