Ruby 2.0.0 リファレンスマニュアル > ライブラリ一覧 > tempfileライブラリ > Tempfileクラス

class Tempfile

クラスの継承リスト: Tempfile < File < IO < Enumerable < File::Constants < Object < Kernel < BasicObject

要約

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

目次

特異メソッド
new open
インスタンスメソッド
close close! delete unlink length size open path

特異メソッド

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