るりまサーチ (Ruby 2.5.0)

最速Rubyリファレンスマニュアル検索!
26件ヒット [1-26件を表示] (0.247秒)
トップページ > ライブラリ:ビルトイン[x] > バージョン:2.5.0[x] > クエリ:_builtin[x] > クエリ:name[x] > クラス:File[x]

別のキーワード

  1. _builtin new
  2. _builtin inspect
  3. _builtin []
  4. _builtin to_s
  5. _builtin each

キーワード

検索結果

File.basename(filename, suffix = "") -> String (42610.0)

filename の一番後ろのスラッシュに続く要素を返します。もし、 引数 suffix が与えられて、かつそれが filename の末尾に 一致するなら、それを取り除いたものを返します。

...
file
name の一番後ろのスラッシュに続く要素を返します。もし、
引数 suffix が与えられて、かつそれが filename の末尾に
一致するなら、それを取り除いたものを返します。

//emlist[例][ruby]{
p File.basename("ruby/ruby.c") #=> "ruby...
..."
p File.basename("ruby/ruby.c", ".c") #=> "ruby"
p File.basename("ruby/ruby.c", ".*") #=> "ruby"
p File.basename("ruby/ruby.exe", ".*") #=> "ruby"
p File.basename("ruby/y.tab.c", ".*") #=> "y.tab"
//}

File
.basename の動作は basename(3)
に従います。
//emlist[例][ruby]{
p File.b...
...asename("foo/bar/") # => "bar"
//}

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

@param suffix サフィックスを文字列で与えます。'.*' という文字列を与えた場合、'*' はワイルドカードとして働き
'.' を含まない任...

File.dirname(filename) -> String (42610.0)

filename の一番後ろのスラッシュより前を文 字列として返します。スラッシュを含まないファイル名に対しては "."(カレントディレクトリ)を返します。

...
file
name の一番後ろのスラッシュより前を文
字列として返します。スラッシュを含まないファイル名に対しては
"."(カレントディレクトリ)を返します。

//emlist[例][ruby]{
p File.dirname("dir/file.ext") # => "dir"
p File.dirname("file.ext")...
...# => "."
//}

File
.dirname の動作は dirname(3)
に従います。
//emlist[例][ruby]{
p File.dirname("foo/bar/") # => "foo"
p File.dirname("foo//bar") # => "foo"
//}


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

@see File.basename, File.extname...

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

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

...ファイル名 filename の拡張子部分(最後の "." に続く文字列)を
返します。ディレクトリ名に含まれる "." や、ファイル名先頭の "."
は拡張子の一部としては見なされません。filename に拡張子が含
まれない場合は空文字列を返し...
...例][ruby]{
p File.extname("foo/foo.txt") # => ".txt"
p File.extname("foo/foo.tar.gz") # => ".gz"
p File.extname("foo/bar") # => ""
p File.extname("foo/.bar") # => ""
p File.extname("foo.txt/bar") # => ""
p File.extname(".foo") # => ""
//}

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

@see File.basename, File.dirname...

File.rename(from, to) -> 0 (42310.0)

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

...{
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)>...

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

FileTest.#identical? と同じです。

...
File
Test.#identical? と同じです。

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

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

絞り込み条件を変える

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

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

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

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

File
.expand_path と異なり、 file_name 先頭が "~" である場...
...ME"] #=> "/home/matz"
p File.absolute_path("..") #=> "/home/matz/work"
p File.absolute_path("..", "/tmp") #=> "/"
p File.absolute_path("~") #=> "/home/matz/work/bar/~"
p File.absolute_path("~foo") #=> "/home/matz/work/bar/~foo"
//}

@see File.expand_path...

File.mkfifo(file_name, mode = 0666) -> 0 (24379.0)

引数 file_name で指定した名前の FIFO スペシャルファイルを作成します。

...引数 file_name で指定した名前の FIFO スペシャルファイルを作成します。

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

@param mode FIFO の許可モードを数値で指定します。指定したモードは通常の
ファイル作成と同様にプロ...
...セスの umask によって変更されます。
作成されたファイルの許可モードは (mode & ~umask) になります。

//emlist[例][ruby]{
File
.mkfifo("testfile", 0666)
File
.ftype("testfile") # => "fifo"
//}...

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

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

...セス時刻を返します。

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

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

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

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

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

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

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

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

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

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

File.chmod(mode, *filename) -> Integer (24310.0)

ファイルのモードを mode に変更します。モードを変更したファイ ルの数を返します。

...ファイルのモードを mode に変更します。モードを変更したファイ
ルの数を返します。

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

@param mode chmod(2) と同様に整数で指定します。

@raise Errno::EXXX モードの変更に失敗...

絞り込み条件を変える

File.chown(owner, group, *filename) -> Integer (24310.0)

ファイルのオーナーとグループを変更します。スーパーユーザだけがファ イルのオーナーとグループを変更できます。変更を行ったファイルの数を 返します。

...ユーザだけがファ
イルのオーナーとグループを変更できます。変更を行ったファイルの数を
返します。

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

@param owner chown(2) と同様に数値で指定します。nil または -1 を指...
...を指定することで、グループを現在のままにすることができます。

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

//emlist[例][ruby]{
IO.write("test.txt", "test")
File
.chown(502, 12, "test.txt")
File
.stat("test.txt").uid # => 502
//}

@see File#chown...

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

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

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

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

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

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

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

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

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

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => 1
p File.exist?("test.txt") # => false
begin
File
....
...delete("test.txt")
rescue
p $! # => #<Errno::ENOENT: No such file or directory @ unlink_internal - test.txt>
end
//}...

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

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

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

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

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

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

//emlist[例][ruby]{
File
.ftype("testfile") # => "file"
File
.ftype("/dev/tty") # => "characterSpecial"
File
.ftype("/tmp/.X11-unix/X0") # => "socket"
//}...

File.lchmod(mode, *filename) -> Integer (24310.0)

File.chmod と同様ですが、シンボリックリンクに関してリンクそのものの モードを変更します。

...
File
.chmod と同様ですが、シンボリックリンクに関してリンクそのものの
モードを変更します。

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

@param mode chmod(2) と同様に整数で指定します。

@raise NotImplementedError lchmod(2)...
...生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File
.symlink("testfile", "testlink")
File
.lstat("testlink").ftype # => "link"
File
.lchmod(0744, "testlink")
File
.stat("testlink").mode.to_s(8) # => "100644"
File
.lstat("testlink").mode.to_s(8) # => "120744"
//}...

絞り込み条件を変える

File.lchown(owner, group, *filename) -> Integer (24310.0)

File#chown と同様ですが、 シンボリックリンクに関してリンクそのもののオーナー、 グループを変更します。

...
File
#chown と同様ですが、
シンボリックリンクに関してリンクそのもののオーナー、
グループを変更します。

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

@param owner chown(2) と同様に数値で指定します。nil または -1...
...発生します。

//emlist[例][ruby]{
IO.write("testfile", "test")
File
.symlink("testfile", "testlink")
File
.chown(501, -1, "testfile")
File
.lstat("testlink").ftype # => "link"
File
.lchown(0, -1, "testlink")
File
.stat("testlink").uid # => 501
File
.lstat("testlink").uid # => 0
//}...

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

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

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

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

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

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

@see IO#stat, File#lstat...

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

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

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

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

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

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

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

@see File.utime...

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

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

...更新時刻を返します。

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

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

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

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

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

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

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

//emlist[例][ruby]{
requ...
...ire 'pathname'

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

File
.path("/dev/null") # => "/dev/null"
File
.path(Pathname("/tmp")) # => "/tmp"
File
.path(MyPath.new(".")) # => "/Users/user/projects/txt"
//}...

絞り込み条件を変える

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

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

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

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

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

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

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

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

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

...合に発生します。

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

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

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

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

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

と同じです。

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

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

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

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

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

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

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

@see IO#stat, File#lstat...

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

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

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

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

//emlist[例][ruby]{
IO.write("test.txt", "test")
p File.exist?("test.txt") # => true
p File.delete("test.txt") # => 1
p File.exist?("test.txt") # => false
begin
File
....
...delete("test.txt")
rescue
p $! # => #<Errno::ENOENT: No such file or directory @ unlink_internal - test.txt>
end
//}...

絞り込み条件を変える

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

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

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

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

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

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

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

@raise Errno::EXXX...
...5, 6)
File
.utime(atime, mtime, "testfile") # => 1
File
.atime("testfile") # => 2018-01-02 03:04:05 +0900
File
.mtime("testfile") # => 2018-02-03 04:05:06 +0900
//}

//emlist[例: 経過秒数で指定][ruby]{
File
.utime(1, 2, "testfile") # => 1
File
.atime("testfile")...