module function FileUtils.#copy

ファイル src を dest にコピーします。

src にファイルが一つだけ与えられた場合、 dest がディレクトリならdest/src にコピーします。 dest が既に存在ししかもディレクトリでないときは上書きします。

src にファイルが複数与えられた場合、 file1 を dest/file1 にコピー、file2 を dest/file2 にコピー、というように、ディレクトリ dest の中にファイル file1、file2 …を同じ名前でコピーします。dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

[PARAM] src:

コピー元。一つの場合は文字列でも指定可能です。二つ以上指定する場合は配列で指定します。

[PARAM] dest:

コピー先のファイルかディレクトリです。

[PARAM] options:

:preserve, :noop, :verbose が指定できます。 FileUtils/オプションの説明

[EXCEPTION] Errno::ENOTDIR:

src が複数のファイルかつ、dest がディレクトリでない場合に発生します。

例:

require 'fileutils'
FileUtils.cp 'eval.c', 'eval.c.org'
FileUtils.cp(['cgi.rb', 'complex.rb', 'date.rb'], '/usr/lib/ruby/1.8')
FileUtils.cp(%w(cgi.rb complex.rb date.rb), '/usr/lib/ruby/1.8', {:verbose => true})