検索結果

FileUtils (132019.0)

• 2.4.0

• モジュール

基本的なファイル操作を集めたモジュールです。

基本的なファイル操作を集めたモジュールです。


===[a:options] オプションの説明

引数 options で使用できるオプションの説明です。
メソッドごとに使用できるオプションは決まっています。
不正なオプションを与えると ArgumentError が発生します。

: :noop
真を指定すると実際の処理は行いません。
: :preserve
真を指定すると更新時刻と、可能なら所有ユーザ・所有グループもコピーします。
: :verbose
真を指定すると詳細を出力します。
: :mode
パーミッションを8進数で指定します。
: :force
真を指定す...

• ArgumentError
• StandardError
• Time

FileUtils.#copy_file(src, dest, preserve = false, dereference_root = true) -> () (90304.0)

• 2.4.0

• モジュール関数

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

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

@param src コピー元。

@param dest コピー先。

@param preserve preserve が真のときは更新時刻と、
可能なら所有ユーザ・所有グループもコピーします。

@param dereference_root dereference_root が真のときは src についてだけシンボリックリンクの指す
内容をコピーします。偽の場合はシンボリックリンク自体をコピーします。

• FileUtils

FileUtils.#remove_file(path, force = false) -> () (90304.0)

• 2.4.0

• モジュール関数

ファイル path を削除します。

ファイル path を削除します。

@param path 削除するファイル。

@param force 真のときは削除中に発生した StandardError を無視します。

• FileUtils
• StandardError

FileUtils.#compare_file(file_a, file_b) -> bool (82108.0)

• 2.4.0

• モジュール関数

ファイル file_a と file_b の内容が同じなら真を返します。

ファイル file_a と file_b の内容が同じなら真を返します。

@param file_a ファイル名。

@param file_b ファイル名。

//emlist[][ruby]{
require 'fileutils'
FileUtils.cmp('somefile', 'somefile') #=> true
FileUtils.cmp('/dev/null', '/dev/urandom') #=> false
//}

• FileUtils

FileUtils.#cmp(file_a, file_b) -> bool (72808.0)

• 2.4.0

• モジュール関数

ファイル file_a と file_b の内容が同じなら真を返します。

ファイル file_a と file_b の内容が同じなら真を返します。

@param file_a ファイル名。

@param file_b ファイル名。

//emlist[][ruby]{
require 'fileutils'
FileUtils.cmp('somefile', 'somefile') #=> true
FileUtils.cmp('/dev/null', '/dev/urandom') #=> false
//}

• FileUtils

絞り込み条件を変える

FileUtils.#identical?(file_a, file_b) -> bool (72808.0)

• 2.4.0

• モジュール関数

ファイル file_a と file_b の内容が同じなら真を返します。

ファイル file_a と file_b の内容が同じなら真を返します。

@param file_a ファイル名。

@param file_b ファイル名。

//emlist[][ruby]{
require 'fileutils'
FileUtils.cmp('somefile', 'somefile') #=> true
FileUtils.cmp('/dev/null', '/dev/urandom') #=> false
//}

• FileUtils

FileUtils.#copy(src, dest, options = {}) -> () (72199.0)

• 2.4.0

• モジュール関数

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

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

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

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

@param src コピ...

• Errno::ENOTDIR
• FileUtils

FileUtils.#cp(src, dest, options = {}) -> () (72199.0)

• 2.4.0

• モジュール関数

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

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

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

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

@param src コピ...

• Errno::ENOTDIR
• FileUtils

FileUtils.#chmod(mode, list, options = {}) -> Array (72163.0)

• 2.4.0

• モジュール関数

ファイル list のパーミッションを mode に変更します。

ファイル list のパーミッションを mode に変更します。

@param mode パーミッションを8進数(absolute mode)か文字列(symbolic
mode)で指定します。

@param list ファイルのリストを指定します。 対象のファイルが一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop と :verbose が指定可能です。
c:FileUtils#options

@return list を配列として返しま...

• FileUtils

FileUtils.#chown_R(user, group, list, options = {}) -> Array (72127.0)

• 2.4.0

• モジュール関数

list 以下のファイルの所有ユーザと所有グループを user と group へ再帰的に変更します。

list 以下のファイルの所有ユーザと所有グループを
user と group へ再帰的に変更します。

user, group に nil または -1 を渡すとその項目は変更しません。

@param user ユーザー名か uid を指定します。nil/-1 を指定すると変更しません。

@param group グループ名か gid を指定します。nil/-1 を指定すると変更しません。

@param list ファイルのリストを指定します。対象のファイルが一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param opti...

• FileUtils

絞り込み条件を変える

FileUtils.#cp_r(src, dest, options = {}) -> () (72127.0)

• 2.4.0

• モジュール関数

src を dest にコピーします。src がディレクトリであったら再帰的に コピーします。その際 dest がディレクトリなら dest/src にコピーします。

src を dest にコピーします。src がディレクトリであったら再帰的に
コピーします。その際 dest がディレクトリなら dest/src にコピーします。

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

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

@param options :preserve, :noop, :verbose, :dereference_root, :remove_destination が指定できます。
c:FileU...

• FileUtils

FileUtils.#rm_r(list, options = {}) -> () (72127.0)

• 2.4.0

• モジュール関数

ファイルまたはディレクトリ list を再帰的に消去します。

ファイルまたはディレクトリ list を再帰的に消去します。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :force, :noop, :verbose, :secure が指定できます。
c:FileUtils#options

=== 注意

このメソッドにはローカル脆弱性が存在します。
この脆弱性を回避するには :secure オプションを使用してください。
詳しくは FileUtils.#remove_entry_secure...

• FileUtils

FileUtils.#link(src, dest, options = {}) -> () (72109.0)

• 2.4.0

• モジュール関数

src へのハードリンク dest を作成します。

src へのハードリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのハードリンク dest/src[0]、src[1] への
ハードリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param...

• FileUtils

FileUtils.#ln(src, dest, options = {}) -> () (72109.0)

• 2.4.0

• モジュール関数

src へのハードリンク dest を作成します。

src へのハードリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのハードリンク dest/src[0]、src[1] への
ハードリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param...

• FileUtils

FileUtils.#move(src, dest, options = {}) -> () (72109.0)

• 2.4.0

• モジュール関数

ファイル src を dest に移動します。

ファイル src を dest に移動します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは src を dest/src へ移動します。
dest がすでに存在しディレクトリでないときは src は dest を上書きします。

src が複数の場合、
src[0] を dest/src[0]、src[1] を dest/src[1] へ移動します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param src 元のファイル。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列...

• FileUtils

絞り込み条件を変える

FileUtils.#mv(src, dest, options = {}) -> () (72109.0)

• 2.4.0

• モジュール関数

ファイル src を dest に移動します。

ファイル src を dest に移動します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは src を dest/src へ移動します。
dest がすでに存在しディレクトリでないときは src は dest を上書きします。

src が複数の場合、
src[0] を dest/src[0]、src[1] を dest/src[1] へ移動します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param src 元のファイル。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列...

• FileUtils

FileUtils.#ln_s(src, dest, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

src へのシンボリックリンク dest を作成します。

src へのシンボリックリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのシンボリックリンク dest/src[0]、src[1] への
シンボリックリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します...

• FileUtils

FileUtils.#mkdir(dir, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

ディレクトリ dir を作成します。

ディレクトリ dir を作成します。

@param dir 作成するディレクトリ。

@param options :mode, :noop, :verbose が指定できます。
c:FileUtils#options


//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir('test')
FileUtils.mkdir(%w( tmp data ))
FileUtils.mkdir('notexist', noop: true) # does not create really
//}

• FileUtils

FileUtils.#remove(list, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

list で指定された対象を消去します。

list で指定された対象を消去します。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :force, :noop, :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.rm('junk.txt')
FileUtils.rm(Dir.glob('*~'))
FileUtils.rm('NotExistFile', f...

• FileUtils

FileUtils.#rm(list, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

list で指定された対象を消去します。

list で指定された対象を消去します。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :force, :noop, :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.rm('junk.txt')
FileUtils.rm(Dir.glob('*~'))
FileUtils.rm('NotExistFile', f...

• FileUtils

絞り込み条件を変える

FileUtils.#rm_rf(list, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

ファイルまたはディレクトリ list を再帰的に消去します。

ファイルまたはディレクトリ list を再帰的に消去します。

rm_r(list, force: true) と同じです。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop, :verbose, :secure が指定できます。
c:FileUtils#options

=== 注意

このメソッドにはローカル脆弱性が存在します。
この脆弱性を回避するには :secure オプションを使用してください。
詳しくは FileUt...

• FileUtils

FileUtils.#rmdir(dir, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

ディレクトリ dir を削除します。

ディレクトリ dir を削除します。

ディレクトリにファイルが残っていた場合は削除に失敗します。

@param dir 削除するディレクトリを指定します。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :parents, :noop, :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.rmdir('somedir')
FileUtils.rmdir(%...

• FileUtils

FileUtils.#rmtree(list, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

ファイルまたはディレクトリ list を再帰的に消去します。

ファイルまたはディレクトリ list を再帰的に消去します。

rm_r(list, force: true) と同じです。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop, :verbose, :secure が指定できます。
c:FileUtils#options

=== 注意

このメソッドにはローカル脆弱性が存在します。
この脆弱性を回避するには :secure オプションを使用してください。
詳しくは FileUt...

• FileUtils

FileUtils.#symlink(src, dest, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

src へのシンボリックリンク dest を作成します。

src へのシンボリックリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのシンボリックリンク dest/src[0]、src[1] への
シンボリックリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します...

• FileUtils

FileUtils.#touch(list, options = {}) -> () (72091.0)

• 2.4.0

• モジュール関数

list で指定されたファイルの最終変更時刻 (mtime) と アクセス時刻 (atime) を変更します。

list で指定されたファイルの最終変更時刻 (mtime) と
アクセス時刻 (atime) を変更します。

list で指定されたファイルが存在しない場合は空のファイルを作成します。

@param list 対象のファイル。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :mtime, :nocreate, :noop, :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils...

• FileUtils

絞り込み条件を変える

FileUtils.#rm_f(list, options = {}) -> () (72085.0)

• 2.4.0

• モジュール関数

FileUtils.rm(list, force: true) と同じです。

FileUtils.rm(list, force: true) と同じです。

c:FileUtils#options

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop, :verbose が指定できます。
:force がセットされた場合は作業中すべての StandardError を無視します。

@see FileUtils.#rm

• FileUtils

FileUtils.#safe_unlink(list, options = {}) -> () (72085.0)

• 2.4.0

• モジュール関数

FileUtils.rm(list, force: true) と同じです。

FileUtils.rm(list, force: true) と同じです。

c:FileUtils#options

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop, :verbose が指定できます。
:force がセットされた場合は作業中すべての StandardError を無視します。

@see FileUtils.#rm

• FileUtils

FileUtils#safe_ln(*args) (72073.0)

• 2.4.0

• インスタンスメソッド

安全にリンクを作成します。

安全にリンクを作成します。

リンクの作成に失敗した場合はファイルをコピーします。

@param args FileUtils.#cp, FileUtils.#ln に渡す引数を指定します。

@see FileUtils.#cp, FileUtils.#ln

• FileUtils

FileUtils.#chmod_R(mode, list, options = {}) -> Array (72073.0)

• 2.4.0

• モジュール関数

ファイル list のパーミッションを再帰的に mode へ変更します。

ファイル list のパーミッションを再帰的に mode へ変更します。

@param mode パーミッションを8進数(absolute mode)か文字列(symbolic
mode)で指定します(FileUtils.#chmod 参照)。

@param list ファイルのリストを指定します。対象のファイルが一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop と :verbose が指定可能です。
c:FileUtils#options...

• FileUtils

FileUtils.#chown(user, group, list, options = {}) -> Array (72073.0)

• 2.4.0

• モジュール関数

ファイル list の所有ユーザと所有グループを user と group に変更します。

ファイル list の所有ユーザと所有グループを user と group に変更します。

user, group に nil または -1 を渡すとその項目は変更しません。

@param user ユーザー名か uid を指定します。nil/-1 を指定すると変更しません。

@param group グループ名か gid を指定します。nil/-1 を指定すると変更しません。

@param list ファイルのリストを指定します。対象のファイルが一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :n...

• FileUtils

絞り込み条件を変える

FileUtils.#install(src, dest, options = {}) -> () (72073.0)

• 2.4.0

• モジュール関数

src と dest の内容が違うときだけ src を dest にコピーします。

src と dest の内容が違うときだけ src を dest にコピーします。

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

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

@param options :preserve, :noop, :verbose, :mode, :owner, :group が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUti...

• FileUtils

FileUtils.#remove_entry(path, force = false) -> () (72073.0)

• 2.4.0

• モジュール関数

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

このメソッドにはローカル脆弱性が存在します。
詳しくは FileUtils.#remove_entry_secure の項を参照してください。

@param path 削除するパス。

@param force 真のときは削除中に発生した StandardError を無視します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.remove_entry '/tmp/ruby.tmp.08883'
//}

@see FileUtils.#remove_e...

• FileUtils
• StandardError

FileUtils.#remove_entry_secure(path, force = false) -> () (72073.0)

• 2.4.0

• モジュール関数

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

FileUtils.#rm_r および FileUtils.#remove_entry には
TOCTTOU (time-of-check to time-of-use)脆弱性が存在します。
このメソッドはそれを防ぐために新設されました。
FileUtils.#rm_r および FileUtils.#remove_entry は以下の条件が
満たされるときにはセキュリティホールになりえます。

* 親ディレクトリが全ユーザから書き込み可能 (/tmp を含む)
* path 以下のいずれかのディレク...

• FileUtils
• StandardError

FileUtils.#cd(dir, options = {}) -> nil (72055.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

@param options :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#cd(dir, options = {}) {|dir| .... } -> nil (72055.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

@param options :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

絞り込み条件を変える

FileUtils.#chdir(dir, options = {}) -> nil (72055.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

@param options :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#chdir(dir, options = {}) {|dir| .... } -> nil (72055.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

@param options :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#makedirs(list, options = {}) -> Array (72055.0)

• 2.4.0

• モジュール関数

ディレクトリ dir とその親ディレクトリを全て作成します。

ディレクトリ dir とその親ディレクトリを全て作成します。

例えば、
//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir_p('/usr/local/lib/ruby')
//}

は以下の全ディレクトリを (なければ) 作成します。

* /usr
* /usr/local
* /usr/local/bin
* /usr/local/bin/ruby

@param list 作成するディレクトリ。一つの場合は文字列でも指定できます。
二つ以上指定する場合は配列で指定します。

@param...

• FileUtils

FileUtils.#mkdir_p(list, options = {}) -> Array (72055.0)

• 2.4.0

• モジュール関数

ディレクトリ dir とその親ディレクトリを全て作成します。

ディレクトリ dir とその親ディレクトリを全て作成します。

例えば、
//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir_p('/usr/local/lib/ruby')
//}

は以下の全ディレクトリを (なければ) 作成します。

* /usr
* /usr/local
* /usr/local/bin
* /usr/local/bin/ruby

@param list 作成するディレクトリ。一つの場合は文字列でも指定できます。
二つ以上指定する場合は配列で指定します。

@param...

• FileUtils

FileUtils.#mkpath(list, options = {}) -> Array (72055.0)

• 2.4.0

• モジュール関数

ディレクトリ dir とその親ディレクトリを全て作成します。

ディレクトリ dir とその親ディレクトリを全て作成します。

例えば、
//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir_p('/usr/local/lib/ruby')
//}

は以下の全ディレクトリを (なければ) 作成します。

* /usr
* /usr/local
* /usr/local/bin
* /usr/local/bin/ruby

@param list 作成するディレクトリ。一つの場合は文字列でも指定できます。
二つ以上指定する場合は配列で指定します。

@param...

• FileUtils

絞り込み条件を変える

FileUtils#sh(*cmd) {|result, status| ... } (72037.0)

• 2.4.0

• インスタンスメソッド

与えられたコマンドを実行します。

与えられたコマンドを実行します。

与えられた引数が複数の場合、シェルを経由しないでコマンドを実行します。

@param cmd 引数の解釈に関しては Kernel.#exec を参照してください。


例:
sh %{ls -ltr}

sh 'ls', 'file with spaces'

# check exit status after command runs
sh %{grep pattern file} do |ok, res|
if ! ok
puts "pattern not found (status = #...

• FileUtils

FileUtils.#ln_sf(src, dest, options = {}) -> () (72037.0)

• 2.4.0

• モジュール関数

src へのシンボリックリンク dest を作成します。

src へのシンボリックリンク dest を作成します。

ln_s(src, dest, force: true) と同じです。

@param src リンク元。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param dest リンク作成先のファイルかディレクトリです。

@param options :force, :noop, :verbose が指定できます。
c:FileUtils#options

@raise Errno::ENOTDIR src が複数で dest がディレクトリでな...

• FileUtils

FileUtils.#uptodate?(newer, older_list, options = nil) -> bool (72037.0)

• 2.4.0

• モジュール関数

newer が、older_list に含まれるすべてのファイルより新しいとき真。 存在しないファイルは無限に古いとみなされます。

newer が、older_list に含まれるすべてのファイルより新しいとき真。
存在しないファイルは無限に古いとみなされます。

@param newer ファイルを一つ指定します。

@param older_list ファイル名の配列を指定します。

@param options どのようなオプションも指定することはできません。

@raise ArgumentError options にオプションを指定した場合に発生します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.uptodate?('hello.o', ['hello....

• FileUtils

FileUtils.collect_method(opt) -> Array (72037.0)

• 2.4.0

• 特異メソッド

与えられたオプションを持つメソッド名の配列を返します。

与えられたオプションを持つメソッド名の配列を返します。

@param opt オプション名をシンボルで指定します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.collect_method(:preserve) # => ["cp", "cp_r", "copy", "install"]
//}

• FileUtils

FileUtils.commands -> Array (72037.0)

• 2.4.0

• 特異メソッド

何らかのオプションを持つメソッド名の配列を返します。

何らかのオプションを持つメソッド名の配列を返します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.commands # => ["chmod", "cp", "cp_r", "install", ...]
//}

• FileUtils

絞り込み条件を変える

FileUtils.options -> Array (72037.0)

• 2.4.0

• 特異メソッド

オプション名の配列を返します。

オプション名の配列を返します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.options
# => ["noop", "verbose", "force", "mode", "parents", "owner", "group", "preserve", "dereference_root", "remove_destination", "secure", "mtime", "nocreate"]
//}

• FileUtils

FileUtils.options_of(mid) -> Array (72037.0)

• 2.4.0

• 特異メソッド

与えられたメソッド名で使用可能なオプション名の配列を返します。

与えられたメソッド名で使用可能なオプション名の配列を返します。

@param mid メソッド名を指定します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.options_of(:rm) # => ["noop", "verbose", "force"]
//}

• FileUtils

FileUtils#ruby(*args) {|result, status| ... } (72001.0)

• 2.4.0

• インスタンスメソッド

与えられた引数で Ruby インタプリタを実行します。

与えられた引数で Ruby インタプリタを実行します。

@param args Ruby インタプリタに与える引数を指定します。

例:
ruby %{-pe '$_.upcase!' <README}

@see Kernel.#sh

• FileUtils

FileUtils#split_all(path) -> Array (72001.0)

• 2.4.0

• インスタンスメソッド

与えられたパスをディレクトリごとに分割します。

与えられたパスをディレクトリごとに分割します。

@param path 分割するパスを指定します。

例:
split_all("a/b/c") # => ['a', 'b', 'c']

• FileUtils

FileUtils.#compare_stream(io_a, io_b) -> bool (72001.0)

• 2.4.0

• モジュール関数

IO オブジェクト io_a と io_b の内容が同じなら真を返します。

IO オブジェクト io_a と io_b の内容が同じなら真を返します。

@param io_a IO オブジェクト。

@param io_b IO オブジェクト。

• FileUtils
• IO

絞り込み条件を変える

FileUtils.#copy_entry(src, dest, preserve = false, dereference_root = false) -> () (72001.0)

• 2.4.0

• モジュール関数

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

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

src が普通のファイルでない場合はその種別まで含めて完全にコピーします。
src がディレクトリの場合はその中身を再帰的にコピーします。

@param src コピー元。

@param dest コピー先。

@param preserve preserve が真のときは更新時刻と、
可能なら所有ユーザ・所有グループもコピーします。

@param dereference_root dereference_root が真のときは src についてだけシンボリックリンクの指す
...

• FileUtils

FileUtils.#copy_stream(src, dest) -> () (72001.0)

• 2.4.0

• モジュール関数

src を dest にコピーします。 src には read メソッド、dest には write メソッドが必要です。

src を dest にコピーします。
src には read メソッド、dest には write メソッドが必要です。

@param src read メソッドを持つオブジェクト。

@param dest write メソッドを持つオブジェクト。

• FileUtils

FileUtils.#getwd -> String (72001.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを文字列で返します。

プロセスのカレントディレクトリを文字列で返します。

• FileUtils

FileUtils.#pwd -> String (72001.0)

• 2.4.0

• モジュール関数

プロセスのカレントディレクトリを文字列で返します。

プロセスのカレントディレクトリを文字列で返します。

• FileUtils

FileUtils.#remove_dir(path, force = false) -> () (72001.0)

• 2.4.0

• モジュール関数

ディレクトリ path を削除します。

ディレクトリ path を削除します。

@param path 削除するディレクトリ。

@param force 真のときは削除中に発生した StandardError を無視します。

• FileUtils
• StandardError

絞り込み条件を変える

FileUtils.have_option?(mid, opt) -> bool (72001.0)

• 2.4.0

• 特異メソッド

mid というメソッドが opt というオプションを持つ場合、真を返します。 そうでない場合は、偽を返します。

mid というメソッドが opt というオプションを持つ場合、真を返します。
そうでない場合は、偽を返します。

@param mid メソッド名を指定します。

@param opt オプション名を指定します。

• FileUtils

FileUtils::METHODS -> Array (72001.0)

• 2.4.0

• 定数

このモジュールで定義されている公開メソッドの配列を返します。

このモジュールで定義されている公開メソッドの配列を返します。

• FileUtils

FileUtils::OPT_TABLE -> Hash (72001.0)

• 2.4.0

• 定数

内部で使用します。

内部で使用します。

• FileUtils

RakeFileUtils (36103.0)

• 2.4.0

• モジュール

カスタムバージョンの FileUtils のメソッドを提供します。

カスタムバージョンの FileUtils のメソッドを提供します。

FileUtils で定義されているメソッドのうち、:verbose, :noop の二つの
オプションのいずれかに反応するメソッドの動作を変更します。

このモジュールはトップレベルでインクルードされます。
その際、FileUtils, RakeFileUtils に定義されているメソッドの
可視性はプライベートに変更されます。

@see FileUtils

• FileUtils
• RakeFileUtils

fileutils (36001.0)

• 2.4.0

• ライブラリ

再帰的な削除などの基本的なファイル操作を行うためのライブラリです。

再帰的な削除などの基本的なファイル操作を行うためのライブラリです。

• FileUtils
• FileUtils::DryRun
• FileUtils::NoWrite
• FileUtils::Verbose

絞り込み条件を変える

RakeFileUtils.nowrite_flag -> bool (18055.0)

• 2.4.0

• 特異メソッド

この値が真の場合、実際のファイル書き込みをともなう操作は行いません。 そうでない場合、ファイル書き込みを行います。

この値が真の場合、実際のファイル書き込みをともなう操作は行いません。
そうでない場合、ファイル書き込みを行います。

//emlist[][ruby]{
# Rakefile での記載例とする
task default: :sample_file_task

file :sample_file_task do |t|
RakeFileUtils.nowrite_flag # => false
end
//}

• RakeFileUtils

RakeFileUtils.nowrite_flag=(flag) (18055.0)

• 2.4.0

• 特異メソッド

実際に動作を行うかどうか設定します。

実際に動作を行うかどうか設定します。

@param flag 実際に動作を行うかどうかを指定します。真を指定すると動作を実行しません。

//emlist[][ruby]{
# Rakefile での記載例とする

task default: :sample_file_task

file :sample_file_task do |t|
RakeFileUtils.nowrite_flag # => false
RakeFileUtils.nowrite_flag = true
RakeFileUtils.nowrite_flag # => true
end
//}

• RakeFileUtils

RakeFileUtils.verbose_flag -> bool (18055.0)

• 2.4.0

• 特異メソッド

この値が真の場合、詳細を表示します。

この値が真の場合、詳細を表示します。

//emlist[][ruby]{
# Rakefile での記載例とする

task default: :sample_file_task

file :sample_file_task do |t|
# --verbose で rake を実行する
RakeFileUtils.verbose_flag # => true
end
//}

• RakeFileUtils

RakeFileUtils.verbose_flag=(flag) (18055.0)

• 2.4.0

• 特異メソッド

詳細を表示するかどうか設定します。

詳細を表示するかどうか設定します。

@param flag 詳細を表示するかどうか指定します。真を指定すると詳細を表示します。


//emlist[][ruby]{
# Rakefile での記載例とする

task default: :sample_file_task

file :sample_file_task do |t|
# --verbose で rake を実行する
p RakeFileUtils.verbose_flag # => true
RakeFileUtils.verbose_flag = false
p RakeFileUtils.verbose...

• RakeFileUtils

FileUtils::DryRun (18049.0)

• 2.4.0

• モジュール

FileUtils と同じメソッドが定義されていますが、 実際にファイルを変更する操作は実行せず、操作を表示します。

FileUtils と同じメソッドが定義されていますが、
実際にファイルを変更する操作は実行せず、操作を表示します。

絞り込み条件を変える

FileUtils::NoWrite (18049.0)

• 2.4.0

• モジュール

FileUtils と同じメソッドが定義されていますが、 実際にファイルを変更する操作は実行しません。

FileUtils と同じメソッドが定義されていますが、
実際にファイルを変更する操作は実行しません。

FileUtils::Verbose (18049.0)

• 2.4.0

• モジュール

FileUtils と同じメソッドが定義されており全く同じ動作をしますが、 しようとしていることを実行前に表示します。

FileUtils と同じメソッドが定義されており全く同じ動作をしますが、
しようとしていることを実行前に表示します。

Gem::FileOperations (18049.0)

• 2.4.0

• クラス

このクラスは FileUtils のラッパーです。

このクラスは FileUtils のラッパーです。

ロギングの機能を追加しています。

• FileUtils

RakeFileUtils#nowrite(value = nil) { ... } (18001.0)

• 2.4.0

• インスタンスメソッド

ファイルを書き込むかどうかを制御します。

ファイルを書き込むかどうかを制御します。

@param value 真を指定するとファイルを書き込みません。

例:
nowrite # 現在の状態を返します。
nowrite(v) # 与えられた状態に変更します。
nowrite(v) { code } # ブロックを評価する間だけ与えられた状態に変更します。
# ブロックの評価が終わると元の値に戻します。

• RakeFileUtils

RakeFileUtils#verbose(value = nil) { ... } (18001.0)

• 2.4.0

• インスタンスメソッド

詳細を出力するかどうかを制御します。

詳細を出力するかどうかを制御します。

@param value 真を指定すると詳細を出力します。

例
verbose # 現在の状態を返します。
verbose(v) # 与えられた状態に変更します。
verbose(v) { code } # ブロックを評価する間だけ与えられた状態に変更します。
# ブロックの評価が終わると元の値に戻します。

• RakeFileUtils

絞り込み条件を変える

RakeFileUtils#when_writing(msg = nil) { ... } (18001.0)

• 2.4.0

• インスタンスメソッド

RakeFileUtils.nowrite_flag が真である場合与えられたブロックを実行せずに、 与えられたメッセージを表示します。

RakeFileUtils.nowrite_flag が真である場合与えられたブロックを実行せずに、
与えられたメッセージを表示します。

そうでない場合は、与えられたブロックを実行します。

@param msg 表示するメッセージを指定します。

例:
when_writing("Building Project") do
project.build
end

• RakeFileUtils

FileTest.#setuid?(file) -> bool (9394.0)

• 2.4.0

• モジュール関数

ファイルが setuid(2) されている時に真を返 します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルが setuid(2) されている時に真を返
します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

@param file ファイル名を表す文字列か IO オブジェクトを指定します。

@raise IOError 指定された IO オブジェクト file が既に close されていた場合に発生します。

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("u+s", "testfile")
FileTe...

• FileTest

FileTest.#setgid?(file) -> bool (9376.0)

• 2.4.0

• モジュール関数

ファイルが setgid(2) されている時に真を返 します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルが setgid(2) されている時に真を返
します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

@param file ファイル名を表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("g+s", "testfile")
FileTest.setgid?("testfile") # => true
FileUtils.chmod("g-s", "...

• FileTest

FileTest.#sticky?(file) -> bool (9376.0)

• 2.4.0

• モジュール関数

ファイルの sticky ビット(chmod(2) 参照)が 立っている時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルの sticky ビット(chmod(2) 参照)が
立っている時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

@param file ファイル名を表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("o+t", "testfile")
FileTest.sticky?("testfile") # => true
FileUtils....

• FileTest

File::Stat#symlink? -> false (9139.0)

• 2.4.0

• インスタンスメソッド

シンボリックリンクである時に真を返します。 ただし、File::Statは自動的にシンボリックリンクをたどっていくので 常にfalseを返します。

シンボリックリンクである時に真を返します。
ただし、File::Statは自動的にシンボリックリンクをたどっていくので
常にfalseを返します。

//emlist[][ruby]{
require 'fileutils'
outfile = $0 + ".ln"
FileUtils.ln_s($0, outfile)
p File::Stat.new(outfile).symlink? #=> false
p File.lstat(outfile).symlink? #=> true
p FileTest.symlink?(outfile) #=> true
//}

...

• File::Stat

絞り込み条件を変える

1.6.8から1.8.0への変更点(まとめ) (1117.0)

• 2.4.0

• 文書

1.6.8から1.8.0への変更点(まとめ) * ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/文法の変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/正規表現>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Marshal>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Windows 対応>)) * ((<1.6.8から1.8.0への変更点(まとめ)/廃止された(される予定の)機能>)) * ((<1.6.8から1.8.0への変更点(まとめ)/ライブラリ>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張ライブラリAPI>)) * ((<1.6.8から1.8.0への変更点(まとめ)/バグ修正>)) * ((<1.6.8から1.8.0への変更点(まとめ)/サポートプラットフォームの追加>))

1.6.8から1.8.0への変更点(まとめ)
* ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>))
* ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>))
* ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>))...

ruby 1.8.4 feature (1045.0)

• 2.4.0

• 文書

ruby 1.8.4 feature ruby 1.8.4 での ruby 1.8.3 からの変更点です。

ruby 1.8.4 feature
ruby 1.8.4 での ruby 1.8.3 からの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

# * カテゴリ
# * [ruby]: ruby インタプリタの変更
# * [api]: 拡張ライブラリ API
# * [lib]: ライブラリ
* レベル
* [bug]: バグ修正
* [new]: 追加され...

ruby 1.8.3 feature (415.0)

• 2.4.0

• 文書

ruby 1.8.3 feature *((<ruby 1.8 feature>)) *((<ruby 1.8.2 feature>))

ruby 1.8.3 feature
*((<ruby 1.8 feature>))
*((<ruby 1.8.2 feature>))

ruby 1.8.2 から ruby 1.8.3 までの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ...

Kernel#rm_f(*files) -> () (385.0)

• 2.4.0

• インスタンスメソッド

FileUtils.#rm_f のラッパーメソッドです。

FileUtils.#rm_f のラッパーメソッドです。

@param files ファイルのリストか、Dir.globで利用できる glob パターンを指定します。
最後の要素が Hash の場合は FileUtils.#rm_f の第二引数になります。

@see FileUtils.#rm_f, Dir.glob

• Kernel

Kernel#rm_rf(*files) -> () (385.0)

• 2.4.0

• インスタンスメソッド

FileUtils.#rm_rf のラッパーメソッドです。

FileUtils.#rm_rf のラッパーメソッドです。

@param files ファイルのリストか、Dir.globで利用できる glob パターンを指定します。
最後の要素が Hash の場合は FileUtils.#rm_f の第二引数になります。

@see FileUtils.#rm_rf, Dir.glob

• Kernel

絞り込み条件を変える

ruby 1.9 feature (379.0)

• 2.4.0

• 文書

ruby 1.9 feature ruby version 1.9.0 は開発版です。 以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。 1.9.1 以降は安定版です。 バグ修正がメインになります。

ruby 1.9 feature
ruby version 1.9.0 は開発版です。
以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。
1.9.1 以降は安定版です。
バグ修正がメインになります。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
* [parser]: 文法の変更
* [regexp]: 正規表現の機能拡張
* [marshal]: Marshal ファイルのフォーマット変更
* ...

NEWS for Ruby 2.0.0 (199.0)

• 2.4.0

• 文書

NEWS for Ruby 2.0.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.0.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 1.9.3 以降の変更

=== 言語仕様の変更

* キーワード引数を追加しました
* %i, %I をシンボルの配列作成のために追加しました。(%w, %W に似ています)
* デフォルトのソースエンコーディングを US-ASCI...

• ARGF.class
• ArgumentError
• Array
• Bignum
• ENV
• Enumerable
• Enumerator
• Enumerator::Lazy
• Fiber
• File
• Fixnum
• Float
• GC
• GC::Profiler
• Hash
• IO
• Kernel
• LoadError
• Module
• Mutex
• ...

ruby 1.8.2 feature (127.0)

• 2.4.0

• 文書

ruby 1.8.2 feature ruby 1.8.2 での ruby 1.8.1 からの変更点です。

ruby 1.8.2 feature
ruby 1.8.2 での ruby 1.8.1 からの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

*カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
*レベル
* [bug]: バグ修正
* [new]: 追加されたクラス／メソッドなど
* [compat]: 変更されたクラス／...

Dir.mktmpdir(prefix_suffix = nil, tmpdir = nil) -> String (73.0)

• 2.4.0

• 特異メソッド

一時ディレクトリを作成します。

一時ディレクトリを作成します。

作成されたディレクトリのパーミッションは 0700 です。

ブロックが与えられた場合は、ブロックの評価が終わると
作成された一時ディレクトリやその配下にあったファイルを
FileUtils.#remove_entry を用いて削除し、ブロックの値をかえします。
ブロックが与えられなかった場合は、作成した一時ディレクトリのパスを
返します。この場合、このメソッドは作成した一時ディレクトリを削除しません。

@param prefix_suffix nil の場合は、'd' をデフォルトのプレフィクスとして使用します。サフィックスは付きません。
...

• Dir

Dir.mktmpdir(prefix_suffix = nil, tmpdir = nil) {|dir| ... } -> object (73.0)

• 2.4.0

• 特異メソッド

一時ディレクトリを作成します。

一時ディレクトリを作成します。

作成されたディレクトリのパーミッションは 0700 です。

ブロックが与えられた場合は、ブロックの評価が終わると
作成された一時ディレクトリやその配下にあったファイルを
FileUtils.#remove_entry を用いて削除し、ブロックの値をかえします。
ブロックが与えられなかった場合は、作成した一時ディレクトリのパスを
返します。この場合、このメソッドは作成した一時ディレクトリを削除しません。

@param prefix_suffix nil の場合は、'd' をデフォルトのプレフィクスとして使用します。サフィックスは付きません。
...

• Dir

絞り込み条件を変える

Dir.mkdir(path, mode = 0777) -> 0 (55.0)

• 2.4.0

• 特異メソッド

path で指定された新しいディレクトリを作ります。パーミッションは mode で指定された値に umask をかけた値 (mode & ~umask) になります。 mkdir(2) も参照して下さい。 ディレクトリの作成に成功すれば 0 を返します。

path で指定された新しいディレクトリを作ります。パーミッションは
mode で指定された値に umask をかけた値 (mode & ~umask) になります。
mkdir(2) も参照して下さい。
ディレクトリの作成に成功すれば 0 を返します。

@param path ディレクトリのパスを文字列で指定します。

@param mode ディレクトリのモードを整数で与えます。

@raise Errno::EXXX ディレクトリの作成に失敗した場合に発生します。

//emlist[例][ruby]{
p File.umask ...

• Dir