検索結果

Digest::Base#file(path) -> self (64006.0)

• 3.4

• インスタンスメソッド

ファイル名 file で指定したファイルの内容を読み込んでダイジェストを更新し、 オブジェクト自身を返します。

ファイル名 file で指定したファイルの内容を読み込んでダイジェストを更新し、
オブジェクト自身を返します。

@param path 読み込み対象のファイル名です。
@return ダイジェストオブジェクトを返します。

例(MD5の場合)

require 'digest/md5'
digest = Digest::MD5.new
digest.file("/path/to/file") # => Digest::MD5のインスタンス
digest.hexdigest # => "/path/to/file"のMD5値

• Digest::Base

Digest::Base.file(path) -> object (63988.0)

• 3.4

• 特異メソッド

新しいダイジェストオブジェクトを生成し、 ファイル名 file で指定したファイルの内容を読み込み、 そのダイジェストオブジェクトを返します。

新しいダイジェストオブジェクトを生成し、
ファイル名 file で指定したファイルの内容を読み込み、
そのダイジェストオブジェクトを返します。

@param path 読み込み対象のファイル名です。
@return ダイジェストオブジェクトを返します。

使用例(SHA256の場合)

require 'digest'
digest = Digest::SHA256.file("X11R6.8.2-src.tar.bz2")
digest.hexdigest
# => "f02e3c85572dc9ad7cb77c2a638e...

• Digest::Base

Psych::SyntaxError#file -> String|nil (63922.0)

• 3.4

• インスタンスメソッド

エラーが生じたファイルの名前を返します。

エラーが生じたファイルの名前を返します。

Psych.load_file で指定したファイルの名前や
Psych.load の第2引数で指定した名前が返されます。
パース時にファイル名を指定しなかった場合は nil が返されます。

• Psych::SyntaxError

OpenSSL::X509::DEFAULT_CERT_FILE_ENV -> String (55240.0)

• 3.4

• 定数

CA 証明書ファイル名を指定する環境変数名です。

CA 証明書ファイル名を指定する環境変数名です。

通常、"SSL_CERT_FILE" という文字列です。
この環境変数を設定しておくことによって
OpenSSL::X509::Store#set_default_paths で読み込まれる
証明書ファイル名を変更できます。

@see OpenSSL::X509::DEFAULT_CERT_FILE

• OpenSSL::X509

Kernel#file(*args) { ... } -> Rake::FileTask (55222.0)

• 3.4

• インスタンスメソッド

ファイルタスクを定義します。

ファイルタスクを定義します。

@param args ファイル名と依存ファイル名を指定します。

例:
file "config.cfg" => ["config.template"] do
open("config.cfg", "w") do |outfile|
open("config.template") do |infile|
while line = infile.gets
outfile.puts line
end
end
end
end

@see Rake:...

• Kernel

絞り込み条件を変える

OpenSSL::X509::DEFAULT_CERT_FILE -> String (55222.0)

• 3.4

• 定数

デフォルトの CA 証明書ファイル名です。

デフォルトの CA 証明書ファイル名です。

OpenSSL::X509::Store#set_default_paths で読み込まれます。

OpenSSL::X509::DEFAULT_CERT_FILE_ENV で得られる環境変数よって
上書き可能です。

• OpenSSL::X509

Gem::SourceInfoCache#latest_system_cache_file -> String (55204.0)

• 3.4

• インスタンスメソッド

最新のシステムキャッシュのファイル名を返します。

最新のシステムキャッシュのファイル名を返します。

• Gem::SourceInfoCache

Gem::SourceInfoCache.latest_system_cache_file -> String (55204.0)

• 3.4

• 特異メソッド

最新のシステムキャッシュのファイル名を返します。

最新のシステムキャッシュのファイル名を返します。

• Gem::SourceInfoCache

Readline.filename_quote_characters -> String (55201.0)

• 3.4

• 特異メソッド

ユーザの入力時にファイル名の補完を行う際、スペースなどの単語の区切りを クオートするための複数の文字で構成される文字列を取得します。

ユーザの入力時にファイル名の補完を行う際、スペースなどの単語の区切りを
クオートするための複数の文字で構成される文字列を取得します。

@raise NotImplementedError サポートしていない環境で発生します。

@see Readline.filename_quote_characters=

• Readline

File.utime(atime, mtime, *filename) -> Integer (46819.0)

• 3.4

• 特異メソッド

ファイルの最終アクセス時刻と更新時刻を変更します。 シンボリックリンクに対しては File.lutime　と違って、 シンボリックのリンク先を変更します。

ファイルの最終アクセス時刻と更新時刻を変更します。
シンボリックリンクに対しては File.lutime　と違って、
シンボリックのリンク先を変更します。

@param atime 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。

@param mtime 更新時刻を Time か、起算時からの経過秒数を数値で指定します。

@param filename ファイル名を表す文字列を指定します。複数指定できます。

@return 変更したファイルの数を返します。

@raise Errno::EXXX 変更に失敗した場合に発生します。

//emlist[例: ...

• File
• Time

絞り込み条件を変える

File.lstat(filename) -> File::Stat (46792.0)

• 3.4

• 特異メソッド

File.statと同様ですが、シンボリックリンクに関してリンクそのものの 情報を File::Stat として返します。lstat(2) を実装していないシステムでは、File.stat と同じです。

File.statと同様ですが、シンボリックリンクに関してリンクそのものの
情報を File::Stat として返します。lstat(2) を実装していないシステムでは、File.stat と同じです。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[例][ruby]{
# link.rb は t.rb のシンボリックリンク
File.lstat("link.rb") == File.stat("t.rb") # => false
File.stat("link.rb...

• File

File.stat(filename) -> File::Stat (46660.0)

• 3.4

• 特異メソッド

filename の情報を含む File::Stat オブジェクトを生成し て返します。

filename の情報を含む File::Stat オブジェクトを生成し
て返します。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.stat("testfile").class # => File::Stat
File.stat("testfile").mtime # => 2017-12-10 01:13:56 +0900
//}

@see IO#stat, File#lstat

• File
• File::Stat

File.lutime(atime, mtime, *filename) -> Integer (46567.0)

• 3.4

• 特異メソッド

ファイルの最終アクセス時刻と更新時刻を変更します。 シンボリックリンクに対しては File.utime　と違って、 シンボリックそのものを変更します。

ファイルの最終アクセス時刻と更新時刻を変更します。
シンボリックリンクに対しては File.utime　と違って、
シンボリックそのものを変更します。

@param atime 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。

@param mtime 更新時刻を Time か、起算時からの経過秒数を数値で指定します。

@param filename ファイル名を表す文字列を指定します。複数指定できます。

@return 変更したファイルの数を返します。

@raise Errno::EXXX 変更に失敗した場合に発生します。

@see File.utim...

• File
• Time

File#lstat -> File::Stat (46342.0)

• 3.4

• インスタンスメソッド

ファイルの状態を含む File::Stat オブジェクトを生成して返します。 シンボリックリンクに関してリンクそのものの情報を返します。 lstat(2) を実装していないシステムでは、IO#statと同じです。

ファイルの状態を含む File::Stat オブジェクトを生成して返します。
シンボリックリンクに関してリンクそのものの情報を返します。
lstat(2) を実装していないシステムでは、IO#statと同じです。

@raise Errno::EXXX 失敗した場合に発生します。

@raise IOError 自身が close されている場合に発生します。

//emlist[例][ruby]{
# testlink は testfile のシンボリックリンク
File.open("testlink") do |f|
p f.lstat == File.stat("testfil...

• File
• File::Stat

File.ctime(filename) -> Time (46327.0)

• 3.4

• 特異メソッド

状態が最後に変更された時刻を返します。 状態の変更とは chmod などによるものです。

状態が最後に変更された時刻を返します。
状態の変更とは chmod などによるものです。

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

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.ctime("testfile") # => 2017-11-30 22:40:49 +0900
File.chmod(0755, "testfile")
File.ctime("testfile") # => 2...

• File

絞り込み条件を変える

Rake::TaskManager#synthesize_file_task(task_name) -> Rake::FileTask | nil (46312.0)

• 3.4

• インスタンスメソッド

与えられたタスク名をもとにファイルタスクを合成します。

与えられたタスク名をもとにファイルタスクを合成します。

@param task_name タスク名を指定します。

@return 与えられたタスク名と同名のファイルが存在する場合は、ファイルタスクを作成して返します。
そうでない場合は nil を返します。

@raise RuntimeError タスクを合成できなかった場合に発生します。

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

task default: :test_rake_app

task :test_rake_app do |task|
task.applicatio...

• Rake::TaskManager

File.delete(*filename) -> Integer (46309.0)

• 3.4

• 特異メソッド

ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 Errno::EXXX が発生します。

ファイルを削除します。削除したファイルの数を返します。
削除に失敗した場合は例外 Errno::EXXX が発生します。

このメソッドは通常ファイルの削除用で、ディレクトリの削除には
Dir.rmdir を使います。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => ...

• Errno::EXXX
• File

File.atime(filename) -> Time (46273.0)

• 3.4

• 特異メソッド

最終アクセス時刻を返します。

最終アクセス時刻を返します。

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

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.atime(__FILE__) # => 2017-11-28 22:38:44 +0900
//}

• File

File.mtime(filename) -> Time (46273.0)

• 3.4

• 特異メソッド

最終更新時刻を返します。

最終更新時刻を返します。

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

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例][ruby]{
File.mtime(__FILE__) # => 2017-12-03 03:16:22 +0900
//}

• File

File.fnmatch(pattern, path, flags = 0) -> bool (46213.0)

• 3.4

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

絞り込み条件を変える

File.fnmatch?(pattern, path, flags = 0) -> bool (46213.0)

• 3.4

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

Gem::Specification#test_suite_file -> String (46204.0)

• 3.4

• インスタンスメソッド

この属性は非推奨です。 Gem::Specification#test_files を使用してください。

この属性は非推奨です。 Gem::Specification#test_files を使用してください。

• Gem::Specification

File.identical?(filename1, filename2) -> bool (46201.0)

• 3.4

• 特異メソッド

FileTest.#identical? と同じです。

FileTest.#identical? と同じです。

@param filename1 パスを表す文字列か IO オブジェクトを指定します。

@param filename2 パスを表す文字列か IO オブジェクトを指定します。

• File

File.absolute_path?(file_name) -> bool (46096.0)

• 3.4

• 特異メソッド

file_name が絶対パスなら true を、そうでなければ false を返します。

file_name が絶対パスなら true を、そうでなければ false を返します。

@param file_name ファイル名を表す文字列を指定します。文字列でない場合は、to_path メソッド、to_str メソッドの順で暗黙の型変換が試みられます。

@raise TypeError 引数に文字列以外の（暗黙の型変換が行えない）オブジェクトを指定した場合に発生します。

//emlist[例][ruby]{
File.absolute_path?("//foo/bar\\baz") # => true
File.absolute_path?("C:foo\\bar") ...

• File

File.extname(filename) -> String (46081.0)

• 3.4

• 特異メソッド

ファイル名 filename の拡張子部分(最後の "." に続く文字列)を 返します。ディレクトリ名に含まれる "." や、ファイル名先頭の "." は拡張子の一部としては見なされません。filename に拡張子が含 まれない場合は空文字列を返します。

ファイル名 filename の拡張子部分(最後の "." に続く文字列)を
返します。ディレクトリ名に含まれる "." や、ファイル名先頭の "."
は拡張子の一部としては見なされません。filename に拡張子が含
まれない場合は空文字列を返します。

//emlist[例][ruby]{
p File.extname("foo/foo.txt") # => ".txt"
p File.extname("foo/foo.tar.gz") # => ".gz"
p File.extname("foo/bar") # => ""
p File.extname("f...

• File

絞り込み条件を変える

File.absolute_path(file_name, dir_string=nil) -> String (46078.0)

• 3.4

• 特異メソッド

file_name を絶対パスに変換した文字列を返します。

file_name を絶対パスに変換した文字列を返します。

相対パスの場合はカレントディレクトリを基準とします。
dir_string を渡した場合はそのディレクトリを基準とします。

File.expand_path と異なり、 file_name 先頭が "~" である場合
それは展開されません。普通のディレクトリ名として処理されます。

//emlist[例][ruby]{
p Dir.getwd #=> "/home/matz/work/bar"
p ENV["HOME"] #=> "/home/mat...

• File

File#atime -> Time (46027.0)

• 3.4

• インスタンスメソッド

最終アクセス時刻を Time オブジェクトとして返します。

最終アクセス時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.atime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#ctime, File#mtime, File#birthtime

• File

File#ctime -> Time (46027.0)

• 3.4

• インスタンスメソッド

状態が最後に変更された時刻を Time オブジェクトとして返します。状態の変更とは chmod などによるものです。

状態が最後に変更された時刻を Time オブジェクトとして返します。状態の変更とは chmod などによるものです。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.ctime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#atime, F...

• File

File#mtime -> Time (46027.0)

• 3.4

• インスタンスメソッド

最終更新時刻を Time オブジェクトとして返します。

最終更新時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

//emlist[例:][ruby]{
IO.write("testfile", "test")
File.open("testfile") { |f| f.mtime } # => 2017-12-21 22:58:17 +0900
//}

@see File#lstat, File#atime, File#ctime, File#birthtime

• File

File.ftype(filename) -> String (46027.0)

• 3.4

• 特異メソッド

ファイルのタイプを表す文字列を返します。

ファイルのタイプを表す文字列を返します。

文字列は以下のうちのいずれかです。File.lstat(filename).ftype と同じです。
シンボリックリンクに対して "link" を返します。

* "file"
* "directory"
* "characterSpecial"
* "blockSpecial"
* "fifo"
* "link"
* "socket"
* "unknown"

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[...

• File

絞り込み条件を変える

File.expand_path(path, default_dir = '.') -> String (45973.0)

• 3.4

• 特異メソッド

path を絶対パスに展開した文字列を返します。 path が相対パスであれば default_dir を基準にします。

path を絶対パスに展開した文字列を返します。
path が相対パスであれば default_dir を基準にします。

先頭の ~ はホームディレクトリ(環境変数 HOME が使われます)に、
~USER はそのユーザのホームディレクトリに展開されます。

//emlist[例][ruby]{
p Dir.getwd #=> "/home/matz/work/foo"
p ENV["HOME"] #=> "/home/matz"
p File.expand_path("..") #=> "/h...

• File

File.path(filename) -> String (45973.0)

• 3.4

• 特異メソッド

指定されたファイル名を文字列で返します。filename が文字列でない場合は、to_path メソッドを呼びます。

指定されたファイル名を文字列で返します。filename が文字列でない場合は、to_path メソッドを呼びます。

@param filename ファイル名を表す文字列か to_path メソッドが定義されたオブジェクトを指定します。

//emlist[例][ruby]{
require 'pathname'

class MyPath
def initialize(path)
@path = path
end
def to_path
File.absolute_path(@path)
end
end

File.path("/dev/null") ...

• File

File.realpath(pathname, basedir = nil) -> String (45973.0)

• 3.4

• 特異メソッド

与えられた pathname に対応する絶対パスを返します。

与えられた pathname に対応する絶対パスを返します。

pathname の全てのコンポーネントは存在しなければなりません。

@param pathname ファイル名を指定します。

@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。

@raise Errno::ENOENT ファイルが存在しない場合に発生します。

//emlist[例][ruby]{
ENV["HOME"] # => "/home/matz"
File.symlink("testfile", "testlink"...

• File

File.file?(path) -> bool (45952.0)

• 3.4

• 特異メソッド

FileTest.#file? と同じです。

FileTest.#file? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File::Constants::TMPFILE -> Integer (45949.0)

• 3.4

• 定数

名前なしの一時ファイルを作成します。 open(2) で O_TMPFILE が指定できる場合に使えます。 File.openで使用します。

名前なしの一時ファイルを作成します。
open(2) で O_TMPFILE が指定できる場合に使えます。
File.openで使用します。

• File::Constants

絞り込み条件を変える

IRB::ContextExtender.def_extend_command(cmd_name, load_file, *aliases) -> object (45922.0)

• 3.4

• 特異メソッド

IRB::Context に cmd_name で指定したメソッドが実行できるように拡張 します。

IRB::Context に cmd_name で指定したメソッドが実行できるように拡張
します。

@param cmd_name メソッド名を Symbol で指定します。
IRB::Context クラスのインスタンスメソッドとして定
義してある必要があります。

@param load_file cmd_name で指定したメソッドが定義されたファイル名を指
定します。このファイルは自動的に require されます。

@param aliases cmd_name の別名を Symb...

• IRB::Context
• IRB::ContextExtender
• Symbol

File.birthtime(filename) -> Time (45919.0)

• 3.4

• 特異メソッド

作成された時刻を返します。

作成された時刻を返します。

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

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

@raise NotImplementedError Windows のような birthtime のない環境で発生します。

//emlist[例][ruby]{
File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003
//}

• File

Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE -> String (45904.0)

• 3.4

• 定数

システム全体の設定ファイルのパスです。

システム全体の設定ファイルのパスです。

• Gem::ConfigFile

Rake::PackageTask#tar_bz2_file -> String (45904.0)

• 3.4

• インスタンスメソッド

tar.bz2 用のファイル名を返します。

tar.bz2 用のファイル名を返します。

• Rake::PackageTask

Rake::PackageTask#tar_gz_file -> String (45904.0)

• 3.4

• インスタンスメソッド

tar.gz 用のファイル名を返します。

tar.gz 用のファイル名を返します。

• Rake::PackageTask

絞り込み条件を変える

File.realdirpath(pathname, basedir = nil) -> String (45901.0)

• 3.4

• 特異メソッド

与えられた pathname に対応する絶対パスを返します。

与えられた pathname に対応する絶対パスを返します。

pathname の最後のコンポーネントは存在していなくても例外は発生しません。

@param pathname ファイル名を指定します。

@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。

@raise Errno::ENOENT ファイルが存在しない場合に発生します。

• File

File#path -> String (45727.0)

• 3.4

• インスタンスメソッド

オープン時に使用したパスを文字列で返します。

オープン時に使用したパスを文字列で返します。

パスは self に対応するファイルを指しているとは限りません。
たとえば、ファイルが移動されていたり、削除されていたりする場合です。

@raise IOError TMPFILE File::Constants::TMPFILEオプション付きで作成されている場合に発生します。

//emlist[例][ruby]{
File.open("testfile") {|f| f.path } #=> "testfile"
File.open("/tmp/../tmp/xxx", "w") {|f| f...

• File

File#to_path -> String (45727.0)

• 3.4

• インスタンスメソッド

オープン時に使用したパスを文字列で返します。

オープン時に使用したパスを文字列で返します。

パスは self に対応するファイルを指しているとは限りません。
たとえば、ファイルが移動されていたり、削除されていたりする場合です。

@raise IOError TMPFILE File::Constants::TMPFILEオプション付きで作成されている場合に発生します。

//emlist[例][ruby]{
File.open("testfile") {|f| f.path } #=> "testfile"
File.open("/tmp/../tmp/xxx", "w") {|f| f...

• File

File#birthtime -> Time (45691.0)

• 3.4

• インスタンスメソッド

作成された時刻を Time オブジェクトとして返します。

作成された時刻を Time オブジェクトとして返します。

@raise IOError 自身が close されている場合に発生します。

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

@raise NotImplementedError Windows のような birthtime のない環境で発生します。

File.new("testfile").birthtime #=> Wed Apr 09 08:53:14 CDT 2003

@see File#lstat, File#atime, File#ctime, File#mti...

• File

File::ALT_SEPARATOR -> "\\" | nil (45649.0)

• 3.4

• 定数

システムのファイルパスのセパレータが SEPARATOR と異なる場合 に設定されます。MS-DOS などでは "\\" です。UNIX や Cygwin などでは nil です。

システムのファイルパスのセパレータが SEPARATOR と異なる場合
に設定されます。MS-DOS などでは "\\" です。UNIX や Cygwin などでは nil です。

• File

絞り込み条件を変える

File::PATH_SEPARATOR -> ";" | ":" (45649.0)

• 3.4

• 定数

PATH 環境変数の要素のセパレータです。UNIX では ":" MS-DOS な どでは ";" です。

PATH 環境変数の要素のセパレータです。UNIX では ":" MS-DOS な
どでは ";" です。

• File

File.split(pathname) -> [String] (45637.0)

• 3.4

• 特異メソッド

pathname を dirname とbasename に分割して、2 要 素の配列を返します。

pathname を dirname とbasename に分割して、2 要
素の配列を返します。

//emlist[][ruby]{
[File.dirname(pathname), File.basename(pathname)]
//}

と同じです。

@param pathname パス名を表す文字列を指定します。

• File

File.truncate(path, length) -> 0 (45637.0)

• 3.4

• 特異メソッド

path で指定されたファイルのサイズを最大 length バイト にします。

path で指定されたファイルのサイズを最大 length バイト
にします。

サイズの変更に成功すれば 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。

@param path パスを表す文字列を指定します。

@param length 変更したいサイズを整数で与えます。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "1234567890")
File.truncate("testfile", 5) # => 0
File.size("testfil...

• Errno::EXXX
• File

File#truncate(length) -> 0 (45619.0)

• 3.4

• インスタンスメソッド

ファイルのサイズを最大 length バイトにします。

ファイルのサイズを最大 length バイトにします。

サイズの変更に成功すれば 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。

@raise IOError 自身が書き込み用にオープンされていなければ発生します。

@raise Errno::EXXX サイズの変更に失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("testfile", "1234567890")
File.open("testfile", "a") do |f|
f.truncate(5) # => 0
f.size # => 5...

• Errno::EXXX
• File

File.world_writable?(path) -> bool (45619.0)

• 3.4

• 特異メソッド

path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す 整数を返します。そうでない場合は nil を返します。

path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す
整数を返します。そうでない場合は nil を返します。

整数の意味はプラットフォームに依存します。

@param path パスを表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
m = File.world_writable?("/tmp")
"%o" % m #=> "777"
//}

• File

絞り込み条件を変える

File.directory?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#directory? と同じです。

FileTest.#directory? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.empty?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#zero? と同じです。

FileTest.#zero? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.executable?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#executable? と同じです。

FileTest.#executable? と同じです。

@param path パスを表す文字列を指定します。

• File

File.executable_real?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#executable_real? と同じです。

FileTest.#executable_real? と同じです。

@param path パスを表す文字列を指定します。

• File

File.exist?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#exist? と同じです。

FileTest.#exist? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

絞り込み条件を変える

File.setgid?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#setgid? と同じです。

FileTest.#setgid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.setuid?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#setuid? と同じです。

FileTest.#setuid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.socket?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#socket? と同じです。

FileTest.#socket? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.sticky?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#sticky? と同じです。

FileTest.#sticky? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.writable?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#writable? と同じです。

FileTest.#writable? と同じです。

@param path パスを表す文字列を指定します。

• File

絞り込み条件を変える

File.writable_real?(path) -> bool (45601.0)

• 3.4

• 特異メソッド

FileTest.#writable_real? と同じです。

FileTest.#writable_real? と同じです。

@param path パスを表す文字列を指定します。

• File

File::SEPARATOR -> "/" (45601.0)

• 3.4

• 定数

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す 場合などスクリプト内のパス名は環境によらずこのセパレータで統一され ます。値は "/" です。

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す
場合などスクリプト内のパス名は環境によらずこのセパレータで統一され
ます。値は "/" です。

• File

File::Separator -> "/" (45601.0)

• 3.4

• 定数

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す 場合などスクリプト内のパス名は環境によらずこのセパレータで統一され ます。値は "/" です。

ファイルパスのセパレータです。ファイルを扱うメソッドにパス名を渡す
場合などスクリプト内のパス名は環境によらずこのセパレータで統一され
ます。値は "/" です。

• File

Net::FTP#getbinaryfile(remotefile, localfile = File.basename(remotefile), blocksize = DEFAULT_BLOCKSIZE) -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバ上のファイルをバイナリモードで取得します。

サーバ上のファイルをバイナリモードで取得します。

サーバー上にある remotefile という名前のファイルを取得し、
ローカルの localfile という名前のファイルに保存します。

localfile が nil である場合には保存はしません。

データの転送は blocksize バイト毎に行なわれます。

ブロックが指定された場合は
データを blocksize バイト受信するごとに、そのデータを
ブロックに渡します。

@param remotefile 取得対象のリモートのファイル名を与えます。
@param localfile 取得したデータを格納するローカルのファイル...

• Net::FTP

Net::FTP#getbinaryfile(remotefile, localfile = File.basename(remotefile), blocksize = DEFAULT_BLOCKSIZE) {|data| ...} -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバ上のファイルをバイナリモードで取得します。

サーバ上のファイルをバイナリモードで取得します。

サーバー上にある remotefile という名前のファイルを取得し、
ローカルの localfile という名前のファイルに保存します。

localfile が nil である場合には保存はしません。

データの転送は blocksize バイト毎に行なわれます。

ブロックが指定された場合は
データを blocksize バイト受信するごとに、そのデータを
ブロックに渡します。

@param remotefile 取得対象のリモートのファイル名を与えます。
@param localfile 取得したデータを格納するローカルのファイル...

• Net::FTP

絞り込み条件を変える

Net::FTP#gettextfile(remotefile, localfile = File.basename(remotefile)) -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバ上のファイルをテキストモードで取得します。

サーバ上のファイルをテキストモードで取得します。

サーバー上にある remotefile という名前のファイルを取得し、
ローカルの localfile という名前のファイルに保存します。

localfile が nil である場合には保存はしません。

ブロックが指定された場合は
データを1行受信するごとに、その行をブロックに渡します。

@param remotefile 取得対象のリモートのファイル名を与えます。
@param localfile 取得したデータを格納するローカルのファイル名を与えます。


@raise Net::FTPTempError 応答コードが 4yz の...

• Net::FTP

Net::FTP#gettextfile(remotefile, localfile = File.basename(remotefile)) {|line| ...} -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバ上のファイルをテキストモードで取得します。

サーバ上のファイルをテキストモードで取得します。

サーバー上にある remotefile という名前のファイルを取得し、
ローカルの localfile という名前のファイルに保存します。

localfile が nil である場合には保存はしません。

ブロックが指定された場合は
データを1行受信するごとに、その行をブロックに渡します。

@param remotefile 取得対象のリモートのファイル名を与えます。
@param localfile 取得したデータを格納するローカルのファイル名を与えます。


@raise Net::FTPTempError 応答コードが 4yz の...

• Net::FTP

Net::FTP#putbinaryfile(localfile, remotefile = File.basename(localfile), blocksize = DEFAULT_BLOCKSIZE) -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバにファイルをバイナリモードで転送します。

サーバにファイルをバイナリモードで転送します。

ローカルの localfile という名前のファイルを読みだし、
サーバー上の remotefile という名前のファイルに保存します。

データの転送は blocksize バイト毎に行なわれます。

ブロックが指定された場合は
データを blocksize バイト転送するごとに、そのデータを
ブロックに渡します。

@param localfile 転送するローカルのファイル名を与えます。
@param remotefile 転送データを保存するリモートのファイル名を与えます。
@param blocksize データ転送の単位をバイト単...

• Net::FTP

Net::FTP#putbinaryfile(localfile, remotefile = File.basename(localfile), blocksize = DEFAULT_BLOCKSIZE) {|data| ...} -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバにファイルをバイナリモードで転送します。

サーバにファイルをバイナリモードで転送します。

ローカルの localfile という名前のファイルを読みだし、
サーバー上の remotefile という名前のファイルに保存します。

データの転送は blocksize バイト毎に行なわれます。

ブロックが指定された場合は
データを blocksize バイト転送するごとに、そのデータを
ブロックに渡します。

@param localfile 転送するローカルのファイル名を与えます。
@param remotefile 転送データを保存するリモートのファイル名を与えます。
@param blocksize データ転送の単位をバイト単...

• Net::FTP

Net::FTP#puttextfile(localfile, remotefile = File.basename(localfile)) -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバにファイルをテキストモードで転送します。

サーバにファイルをテキストモードで転送します。

ローカルの localfile という名前のファイルを読みだし、
サーバー上の remotefile という名前のファイルに保存します。

ブロックが指定された場合は
データを1行転送するごとに、その行を
ブロックに渡します。

@param localfile 転送するローカルのファイル名を与えます。
@param remotefile 転送データを保存するリモートのファイル名を与えます。

@raise Net::FTPTempError 応答コードが 4yz のときに発生します。
@raise Net::FTPPermError 応答コー...

• Net::FTP

絞り込み条件を変える

Net::FTP#puttextfile(localfile, remotefile = File.basename(localfile)) {|line| ... } -> nil (38107.0)

• 3.4

• インスタンスメソッド

サーバにファイルをテキストモードで転送します。

サーバにファイルをテキストモードで転送します。

ローカルの localfile という名前のファイルを読みだし、
サーバー上の remotefile という名前のファイルに保存します。

ブロックが指定された場合は
データを1行転送するごとに、その行を
ブロックに渡します。

@param localfile 転送するローカルのファイル名を与えます。
@param remotefile 転送データを保存するリモートのファイル名を与えます。

@raise Net::FTPTempError 応答コードが 4yz のときに発生します。
@raise Net::FTPPermError 応答コー...

• Net::FTP

RDoc::TopLevel#file_stat -> File::Stat (37555.0)

• 3.4

• インスタンスメソッド

自身が管理するファイルに関する File::Stat オブジェクトを返します。

自身が管理するファイルに関する File::Stat オブジェクトを返します。

• File::Stat
• RDoc::TopLevel

Gem::Format.from_file_by_path(file_path, security_policy = nil) -> Gem::Format (37525.0)

• 3.4

• 特異メソッド

@todo security_policy

@todo security_policy

Gem ファイルのパスからデータを読み込んで、自身を初期化して返します。

@param file_path Gem ファイルへのパスを指定します。

@param security_policy ???

• Gem::Format

Gem::OldFormat.from_file_by_path(file_path) -> Gem::OldFormat (37525.0)

• 3.4

• 特異メソッド

Gem ファイルのパスからデータを読み込んで、自身を初期化して返します。

Gem ファイルのパスからデータを読み込んで、自身を初期化して返します。

@param file_path Gem ファイルへのパスを指定します。

• Gem::OldFormat

Kernel#install_files(mfile, ifiles, map = nil, srcprefix = nil) -> [] (37519.0)

• 3.4

• インスタンスメソッド

このメソッドは create_makefile, install_rb が使用します。 内部用のメソッドです。

このメソッドは create_makefile, install_rb が使用します。
内部用のメソッドです。

@param mfile Makefile を表す File のインスタンスです。

@param ifiles インストールするファイルのリストを指定します。

@param map ???

@param srcprefix ソースディレクトリを指定します。

• File
• Kernel

絞り込み条件を変える

Rake::FileTask#timestamp -> Time | Rake::LateTime (37219.0)

• 3.4

• インスタンスメソッド

ファイルタスクのタイムスタンプを返します。

ファイルタスクのタイムスタンプを返します。

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

task default: "test.txt"
file "test.txt" do |task|
Rake.application.options.build_all = false
task.timestamp # => #<Rake::LateTime:0x2ba58f0>
end
//}

• Rake::FileTask

Gem::SourceInfoCache#try_file(path) -> String | nil (37204.0)

• 3.4

• インスタンスメソッド

与えられたパスがキャッシュファイルとして利用可能な場合、そのパスを返します。 そうでない場合は nil を返します。

与えられたパスがキャッシュファイルとして利用可能な場合、そのパスを返します。
そうでない場合は nil を返します。

@param path キャッシュファイルの候補となるパスを指定します。

• Gem::SourceInfoCache

Kernel#file_create(*args) { ... } -> Rake::FileCreationTask (37204.0)

• 3.4

• インスタンスメソッド

ファイルを作成するタスクを定義します。

ファイルを作成するタスクを定義します。

主に Kernel.#directory を定義するために使用します。

• Kernel

OpenSSL::Random.#write_random_file(filename) -> true (37204.0)

• 3.4

• モジュール関数

乱数生成器で生成された 1024 バイトのランダムなバイト列を ファイルに書き込みます。

乱数生成器で生成された 1024 バイトのランダムなバイト列を
ファイルに書き込みます。

これで出力したランダムなバイト列はあとで乱数生成器を初期化するの
に使えます。リブート直後などシステムからのエントロピーが少ない場合に
利用できます。

このファイルは利用者以外には読めないように保存しなければなりません。
部外者がこのファイルを読めることはセキュリティ上の問題を引き起します。

@param filename 書き込むファイルの名前
@raise OpenSSL::Random::RandomError ファイルの書き出しに失敗した場合に発生します

• OpenSSL::Random

Gem::Installer#formatted_program_filename(filename) -> String (37201.0)

• 3.4

• インスタンスメソッド

Ruby のコマンドと同じプレフィックスとサフィックスを付けたファイル名を返します。

Ruby のコマンドと同じプレフィックスとサフィックスを付けたファイル名を返します。

@param filename 実行ファイルのファイル名を指定します。

• Gem::Installer

絞り込み条件を変える

Gem::Specification#extra_rdoc_files -> [String] (37201.0)

• 3.4

• インスタンスメソッド

RDoc でドキュメントを作成する際に使用する特別なファイルのリストを返します。

RDoc でドキュメントを作成する際に使用する特別なファイルのリストを返します。

• Gem::Specification

RubyVM::AbstractSyntaxTree.parse_file(pathname) -> RubyVM::AbstractSyntaxTree::Node (37105.0)

• 3.4

• 特異メソッド

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

@param pathname パースする対象のファイルパスを指定します
@param keep_script_lines true を指定すると、 Node#script_lines でノードと関連づけられたソースコードのテキストを取得できます。
@param keep_tokens true を指定すると、 Node#token が利用できます。
@param error_tolerant true を指定すると、構文エラーが発生した際にエラー箇所を type が :ERROR である...

• RubyVM::AbstractSyntaxTree

RubyVM::AbstractSyntaxTree.parse_file(pathname, keep_script_lines: false, error_tolerant: false, keep_tokens: false) -> RubyVM::AbstractSyntaxTree::Node (37105.0)

• 3.4

• 特異メソッド

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

pathname のファイルを読み込み、その内容を抽象構文木にパースし、その木の根ノードを返します。

@param pathname パースする対象のファイルパスを指定します
@param keep_script_lines true を指定すると、 Node#script_lines でノードと関連づけられたソースコードのテキストを取得できます。
@param keep_tokens true を指定すると、 Node#token が利用できます。
@param error_tolerant true を指定すると、構文エラーが発生した際にエラー箇所を type が :ERROR である...

• RubyVM::AbstractSyntaxTree

Tempfile.create(basename="", tmpdir=nil, mode: 0, **options) -> File (37024.0)

• 3.4

• 特異メソッド

テンポラリファイルを作成し、それを表す File オブジェクトを生成して返します(Tempfileではありません)。 createはopenに似ていますが、finalizerによるファイルの自動unlinkを行いません。

テンポラリファイルを作成し、それを表す File オブジェクトを生成して返します(Tempfileではありません)。
createはopenに似ていますが、finalizerによるファイルの自動unlinkを行いません。

ブロックを指定しなかった場合、tmpdirにファイルを作り、Fileオブジェクトを返します。
このファイルは自動的に削除されません。ファイルを削除する場合は明示的にunlinkすべきです。

ブロックを指定して呼び出した場合、tmpdirにファイルを作り、
Fileオブジェクトを引数としてブロックを呼び出します。
ブロック終了時にファイルをクローズするのはopenと同じで...

• Tempfile

FileTest.#file?(file) -> bool (37015.0)

• 3.4

• モジュール関数

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

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

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

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

例:
FileTest.file?('/bin/bash') # => true
FileTest.file?('/bin') # => false
FileTest.file?('/no_such_file') ...

• FileTest

絞り込み条件を変える

File.unlink(*filename) -> Integer (37009.0)

• 3.4

• 特異メソッド

ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 Errno::EXXX が発生します。

ファイルを削除します。削除したファイルの数を返します。
削除に失敗した場合は例外 Errno::EXXX が発生します。

このメソッドは通常ファイルの削除用で、ディレクトリの削除には
Dir.rmdir を使います。

@param filename ファイル名を表す文字列を指定します。

@raise Errno::EXXX 失敗した場合に発生します。

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => ...

• Errno::EXXX
• File

Gem::RemoteFetcher#get_file_uri_path(uri) -> String (36952.0)

• 3.4

• インスタンスメソッド

与えられた URI から "file://" を取り除いた文字列を返します。

与えられた URI から "file://" を取り除いた文字列を返します。

@param uri URI を表す文字列を指定します。

• Gem::RemoteFetcher

ObjectSpace.#allocation_sourcefile(object) -> String (36937.0)

• 3.4

• モジュール関数

objectの元となったソースファイル名を返します。

objectの元となったソースファイル名を返します。

@param object 元となるソースファイル名を取得したいobjectを指定します。
@return objectの元となるソースファイル名を返します。存在しない場合はnilを返します。

//emlist[例:test.rbというファイルで下記のスクリプトを実行した場合][ruby]{
require 'objspace'

ObjectSpace::trace_object_allocations_start
obj = Object.new
puts "file:#{ObjectSpace::allocation_sourc...

• ObjectSpace

Gem::SourceInfoCache#latest_cache_file -> String (36922.0)

• 3.4

• インスタンスメソッド

使用可能な最新のキャッシュファイル名を返します。

使用可能な最新のキャッシュファイル名を返します。

システムキャッシュが使用可能な場合はシステムキャッシュのファイル名を返します。
そうでない場合はユーザーキャッシュのファイル名を返します。

@see Gem::SourceInfoCache#cache_file

• Gem::SourceInfoCache

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

• 3.4

• モジュール関数

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

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

@param src コピー元。

@param dest コピー先。

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

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

• FileUtils

絞り込み条件を変える

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

• 3.4

• モジュール関数

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

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

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

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

• FileUtils
• StandardError

Gem::Format#file_entries -> Array (36904.0)

• 3.4

• インスタンスメソッド

Gem パッケージに含まれるファイルの配列を返します。

Gem パッケージに含まれるファイルの配列を返します。

• Gem::Format

Gem::GemPathSearcher#matching_file?(spec, path) -> bool (36904.0)

• 3.4

• インスタンスメソッド

与えられた spec に path が含まれている場合、真を返します。 そうでない場合は偽を返します。

与えられた spec に path が含まれている場合、真を返します。
そうでない場合は偽を返します。

@param spec Gem::Specification のインスタンスを指定します。

@param path 探索対象のパスを指定します。

• Gem::GemPathSearcher
• Gem::Specification

Gem::Indexer#gem_file_list -> Array (36904.0)

• 3.4

• インスタンスメソッド

インデックスを作成するために使用する Gem ファイルのリストを返します。

インデックスを作成するために使用する Gem ファイルのリストを返します。

• Gem::Indexer

Gem::OldFormat#file_entries -> Array (36904.0)

• 3.4

• インスタンスメソッド

Gem パッケージに含まれるファイルの配列を返します。

Gem パッケージに含まれるファイルの配列を返します。

• Gem::OldFormat

絞り込み条件を変える

Gem::SourceInfoCache#latest_user_cache_file -> String (36904.0)

• 3.4

• インスタンスメソッド

最新のユーザーキャッシュのファイル名を返します。

最新のユーザーキャッシュのファイル名を返します。

• Gem::SourceInfoCache

Gem::SourceInfoCache#reset_cache_file -> nil (36904.0)

• 3.4

• インスタンスメソッド

強制的にキャッシュファイル名をリセットします。

強制的にキャッシュファイル名をリセットします。

RubyGems ライブラリの結合テストをするのに便利です。

• Gem::SourceInfoCache

Gem::SourceInfoCache#system_cache_file -> String (36904.0)

• 3.4

• インスタンスメソッド

システムキャッシュファイルの名前を返します。

システムキャッシュファイルの名前を返します。

• Gem::SourceInfoCache

Gem::SourceInfoCache.latest_user_cache_file -> String (36904.0)

• 3.4

• 特異メソッド

最新のユーザーキャッシュのファイル名を返します。

最新のユーザーキャッシュのファイル名を返します。

• Gem::SourceInfoCache

Gem::SourceInfoCache.system_cache_file -> String (36904.0)

• 3.4

• 特異メソッド

システムキャッシュのファイル名を返します。

システムキャッシュのファイル名を返します。

• Gem::SourceInfoCache

絞り込み条件を変える