Ruby 2.3.0 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Fileクラス > rename

singleton method File.rename

rename(from, to) -> 0[permalink][rdoc]

ファイルの名前を変更します。ディレクトリが異なる場合には移動も行い ます。rename(2) を参照してください。移動先のファ イルが存在する時には上書きされます。

ファイルの移動に成功した場合 0 を返します。失敗した場合は例外 Errno::EXXX が発生します。

[PARAM] from:
ファイルの名前を文字列で与えます。
[PARAM] to:
新しいファイル名を文字列で与えます。
[EXCEPTION] Errno::EXXX:
失敗した場合に発生します。

例:

begin
  File.rename("testfile", "testfile.bak")   # => 0
  File.rename("testfile", "testfile.bak")
rescue
  # 2回目の rename 時にすでに testfile が存在しないため例外が発生する
  $! # => #<Errno::ENOENT: No such file or directory @ rb_file_s_rename - (testfile, testfile.bak)>
end