class Tempfile (Ruby 1.9.3 リファレンスマニュアル)

このマニュアルは既にメンテナンスが終了したバージョンの Ruby を対象としています。最新版のマニュアルへ

要約

テンポラリファイルを操作するためのクラスです。

テンポラリファイルを作成します。ファイルは "w+" モードで "basename.pid.n" という名前になります。
Tempfile オブジェクトはFileオブジェクトと同じように使うことができます。
Tempfile#close(true) により、作成したテンポラリファイルは削除されます。
スクリプトが終了するときにも削除されます。
Tempfile#openにより、テンポラリファイルを再オープンすることができます。
テンポラリファイルのモードは 0600 です。

継承しているメソッド

Fileから継承している特異メソッド

IOから継承している特異メソッド

Fileから継承しているメソッド

IOから継承しているメソッド

Enumerableから継承しているメソッド

特異メソッド

new(basename, tempdir = Dir::tmpdir) -> Tempfile[permalink][rdoc]

open(basename, tempdir = Dir::tmpdir) -> Tempfile

open(basename, tempdir = Dir::tmpdir) {|fp| ...} -> object

テンポラリファイルを作成し、それを表す Tempfile オブジェクトを生成して返します。ファイル名のプレフィクスには指定された basename が使われます。ファイルは指定された tempdir に作られます。 open にブロックを指定して呼び出した場合は、Tempfile オブジェクトを引数としてブロックを実行します。ブロックの実行が終了すると、ファイルは自動的にクローズされ、ブロックの値をかえします。 new にブロックを指定した場合は無視されます。

[PARAM] basename:: ファイル名のプレフィクスを文字列で指定します。文字列の配列を指定した場合、先頭の要素がファイル名のプレフィックス、次の要素がサフィックスとして使われます。
[PARAM] tempdir:: テンポラリファイルが作られるディレクトリです。このデフォルト値は、Dir.tmpdir の値となります。

例:

require "tempfile"
t = Tempfile.open(['hoge', 'bar'])
p t.path                            #=> "/tmp/hoge20080518-6961-5fnk19-0bar"
t2 = Tempfile.open(['t', '.xml'])
p t2.path                           #=> "/tmp/t20080518-6961-xy2wvx-0.xml"

例：ブロックを与えた場合

require 'tempfile'

tf = Tempfile.open("temp"){|fp|
  fp.puts "hoge"
  fp
}
# テンポラリファイルへのパスを表示
p tf.path
p File.read(tf.path) #=> "hoge\n"

インスタンスメソッド

close(real = false) -> nil[permalink][rdoc]

テンポラリファイルをクローズします。 real が偽ならば、テンポラリファイルはGCによって削除されます。そうでなければ、すぐに削除されます。

[PARAM] real:: false もしくはそれ以外を指定します。

tf = Tempfile.open("bar")
tf.close
p FileTest.exist?(tf.path) # => true

close! -> nil[permalink][rdoc]

テンポラリファイルをクローズし、すぐに削除します。

require "tempfile"
tf = Tempfile.open("bar")
path = tf.path
tf.close!
p FileTest.exist?(path) # => false

delete -> self[permalink][rdoc]

unlink -> self

テンポラリファイルをクローズせずに、削除します。 UNIXライクなシステムでは、作成したテンポラリファイルが他のプログラムに使用される機会をなくすために、テンポラリファイルを作成しオープンした後、すぐに削除するということがしばしばおこなわれます。

tf = Tempfile.new("foo")
tf.unlink
p tf.path # => nil
tf.print("foobar,hoge\n")
tf.rewind
p tf.gets("\n") # => "foobar,hoge\n"

length -> Integer[permalink][rdoc]

size -> Integer

テンポラリファイルのサイズを返します。

tf = Tempfile.new("foo")
tf.print("bar,ugo")
p tf.size # => 7
tf.close
p tf.size # => 0

open -> self[permalink][rdoc]

クローズしたテンポラリファイルを再オープンします。 "r+" でオープンされるので、クローズ前の内容を再度読むことができます。

tf = Tempfile.new("foo")
tf.print("foobar,hoge\n")
tf.print("bar,ugo\n")
tf.close
tf.open
p tf.gets # => "foobar,hoge\n"

path -> String | nil[permalink][rdoc]

テンポラリファイルのパス名を返します。

Tempfile#close!を実行後だった場合にはnilを返します。

tf = Tempfile.new("hoo")
p tf.path # => "/tmp/hoo.10596.0"
tf.close!
p tf.path # => nil

要約

目次

継承しているメソッド

特異メソッド

インスタンスメソッド