クラス
- Array (5)
- Class (2)
- Complex (3)
- Dir (30)
- Encoding (10)
-
Encoding
:: Converter (6) - Enumerator (2)
-
Enumerator
:: Lazy (1) -
Errno
:: EXXX (2) - Exception (2)
- Fiber (2)
- File (61)
-
File
:: Stat (1) - Hash (5)
- IO (43)
- Module (4)
- Mutex (1)
- NameError (1)
- NoMethodError (1)
- Object (1)
- Proc (2)
- Random (9)
- Range (1)
- Regexp (8)
-
RubyVM
:: InstructionSequence (8) - SignalException (3)
- String (2)
- Struct (5)
- Symbol (1)
- SystemCallError (4)
- SystemExit (1)
- Thread (17)
- ThreadGroup (1)
- Time (13)
- TracePoint (2)
モジュール
- GC (10)
-
GC
:: Profiler (8) - Process (8)
キーワード
- === (1)
- DEBUG (1)
- DEBUG= (1)
- [] (6)
- []= (1)
- abort (2)
-
abort
_ on _ exception (1) -
abort
_ on _ exception= (1) -
absolute
_ path (1) - aliases (1)
-
all
_ symbols (1) -
asciicompat
_ encoding (2) - assoc (1)
- at (2)
- atime (1)
- basename (1)
- binread (1)
- binwrite (1)
- blockdev? (1)
- chardev? (1)
- chdir (4)
- chmod (1)
- chown (1)
- chroot (1)
- clear (2)
- clone (1)
- compatible? (1)
- compile (2)
-
compile
_ file (1) -
compile
_ option (1) -
compile
_ option= (1) - constants (1)
-
copy
_ stream (2) - count (1)
- ctime (1)
- current (1)
-
default
_ external (1) -
default
_ external= (1) -
default
_ internal (1) -
default
_ internal= (1) -
define
_ method (2) - delete (4)
-
delete
_ if (2) - directory? (1)
- dirname (1)
- disable (2)
- disasm (1)
- disassemble (1)
- each (2)
-
each
_ key (2) -
each
_ pair (2) -
each
_ value (2) - empty? (1)
- enable (2)
- enabled? (1)
- entries (2)
- escape (1)
- exception (1)
- exclusive (1)
- exec (1)
- executable? (1)
-
executable
_ real? (1) - exist? (2)
- exists? (2)
- exit (2)
- exit! (1)
- extname (1)
- fetch (3)
- file? (1)
- find (1)
- fnmatch (1)
- fnmatch? (1)
-
for
_ fd (1) - foreach (6)
- fork (3)
- ftype (1)
- getwd (1)
- glob (2)
- gm (2)
- grpowned? (1)
-
handle
_ interrupt (1) -
has
_ key? (1) -
has
_ value? (1) - home (2)
- identical? (1)
- include (1)
- include? (1)
- index (1)
- inspect (2)
- invert (1)
- join (1)
-
keep
_ if (2) - key (1)
- key? (1)
- keys (1)
- kill (1)
-
last
_ match (2) -
latest
_ gc _ info (2) - lchmod (1)
- lchown (1)
- left (1)
- length (1)
- link (1)
- list (2)
- local (2)
-
locale
_ charmap (1) - lstat (1)
- main (1)
- member? (1)
- members (1)
- mkdir (1)
- mktime (2)
- mtime (1)
-
name
_ list (1) - nesting (1)
- new (50)
-
new
_ seed (1) - now (1)
- of (1)
- open (8)
- owned? (1)
- pass (1)
- path (1)
-
pending
_ interrupt? (1) - pipe (8)
- pipe? (1)
- polar (1)
- popen (14)
- private (1)
- public (1)
- pwd (1)
- quote (1)
- rand (3)
- rassoc (1)
-
raw
_ data (1) - read (3)
- readable? (1)
-
readable
_ real? (1) - readlines (3)
- readlink (1)
- realdirpath (1)
- realpath (1)
- rect (1)
- rectangular (1)
- rehash (1)
- reject (2)
- reject! (2)
- rename (1)
- replace (1)
- report (1)
- result (1)
- rmdir (1)
-
search
_ convpath (1) - select (3)
- select! (2)
- setgid? (1)
- setuid? (1)
- shift (1)
- size (2)
- size? (1)
- socket? (1)
- spawn (1)
- split (1)
- srand (2)
- start (2)
- stat (3)
- state (1)
- sticky? (1)
- stop (1)
- store (1)
- stress (1)
- stress= (1)
- symlink (1)
- symlink? (1)
- sysopen (1)
-
to
_ a (1) -
to
_ h (1) -
to
_ hash (1) -
to
_ s (2) -
total
_ time (1) - trace (1)
- truncate (1)
-
try
_ convert (5) - umask (2)
- union (1)
- unlink (2)
- update (2)
- using (1)
- utc (2)
- utime (1)
- value? (1)
- values (1)
-
values
_ at (1) -
world
_ readable? (1) -
world
_ writable? (1) - writable? (1)
-
writable
_ real? (1) - write (2)
- yield (1)
- zero? (1)
検索結果
先頭5件
-
Encoding
. default _ external=(encoding) (10.0) -
既定の外部エンコーディングを設定します。
既定の外部エンコーディングを設定します。
default_external を変更する前に作成した文字列と、default_external を変更した後に作成した文字列とではエンコーディングが異なる可能性があるため、Ruby スクリプト内で Encoding.default_external を設定してはいけません。代わりに、ruby -E を使用して、正しい default_external で Ruby を起動してください。
デフォルトの外部エンコーディングがどのように使われるかについては Encoding.default_external を参照してください。
@see spec... -
Encoding
. default _ internal -> Encoding | nil (10.0) -
既定の内部エンコーディングを返します。デフォルトでは nil です。
既定の内部エンコーディングを返します。デフォルトでは nil です。
標準入出力、コマンドライン引数、open で開くファイルなどで、内部エンコーディングが指定されていない場合の既定値として利用されます。
String#encode と String#encode! は、引数に Encoding が与えられていない場合、 default_internal を使用します。
文字列リテラルを作成した場合、エンコーディングには default_internal ではなく __ENCODING__ 特殊変数で参照できるスクリプトエンコーディングが使用されます。
default_internal... -
Encoding
. default _ internal=(encoding) (10.0) -
既定の内部エンコーディングを設定します。
既定の内部エンコーディングを設定します。
default_internal を変更する前に作成した文字列と、default_internal を変更した後に作成した文字列とではエンコーディングが異なる可能性があるため、Ruby スクリプト内で Encoding.default_internal を設定してはいけません。代わりに、ruby -E を使用して、正しい default_internal で Ruby を起動してください。
デフォルトの内部エンコーディングがどのように使われるかについては Encoding.default_internal を参照してください。
@see spe... -
Encoding
. find(name) -> Encoding (10.0) -
指定された name という名前を持つ Encoding オブジェクトを返します。
指定された name という名前を持つ Encoding オブジェクトを返します。
@param name エンコーディング名を表す String を指定します。
@return 発見された Encoding オブジェクトを返します。
@raise ArgumentError 指定した名前のエンコーディングが発見できないと発生します。
特殊なエンコーディング名として、ロケールエンコーディングを表す locale、default_external を表す external、default_internal を表す internal、ファイルシステムエンコーディングを表す filesystem... -
Encoding
. list -> [Encoding] (10.0) -
現在ロードされているエンコーディングのリストを返します。
現在ロードされているエンコーディングのリストを返します。
//emlist[例][ruby]{
Encoding.list
# => [#<Encoding:ASCII-8BIT>, #<Encoding:EUC-JP>,
# #<Encoding:Shift_JIS>, #<Encoding:UTF-8>,
# #<Encoding:ISO-2022-JP (dummy)>]
Encoding.find("US-ASCII")
# => #<Encoding:US-ASCII>
Encoding.list
# => [#<Encoding:ASCII-8BIT>, #<... -
Encoding
. locale _ charmap -> String | nil (10.0) -
ロケールエンコーディングを決定するために用いる、locale charmap 名を返します。nl_langinfo 等がない環境では nil を、miniruby では ASCII_8BIT を返します。
ロケールエンコーディングを決定するために用いる、locale charmap 名を返します。nl_langinfo 等がない環境では nil を、miniruby では ASCII_8BIT を返します。
//emlist[Debian GNU/Linux + LANG=C][ruby]{
Encoding.locale_charmap #=> "ANSI_X3.4-1968"
//}
//emlist[LANG=ja_JP.EUC-JP][ruby]{
Encoding.locale_charmap #=> "EUC-JP"
//}
//emlist[SunOS 5 + LANG=C]... -
Encoding
. name _ list -> [String] (10.0) -
利用可能なエンコーディングの名前を文字列の配列で返します。
利用可能なエンコーディングの名前を文字列の配列で返します。
//emlist[例][ruby]{
p Encoding.name_list
#=> ["US-ASCII", "ASCII-8BIT", "UTF-8",
# "ISO-8859-1", "Shift_JIS", "EUC-JP",
# "Windows-31J",
# "BINARY", "CP932", "eucJP", ...]
//} -
Encoding
:: Converter . asciicompat _ encoding(encoding) -> Encoding | nil (10.0) -
同じ文字集合を持つ ASCII 互換エンコーディングを返します。
同じ文字集合を持つ ASCII 互換エンコーディングを返します。
@param string エンコーディング名
@param encoding エンコーディングオブジェクト
@return ASCII 互換エンコーディングのオブジェクトか nil
引数とエンコーディングと同じ文字集合を持つ ASCII 互換エンコーディングを返します。引数と戻り値、2 つのエンコーディング間では変換しても未定義文字の例外は発生しません。
引数が ASCII 互換エンコーディングである場合や、エンコーディングでない場合は nil を返します。
//emlist[][ruby]{
Encoding::Con... -
Encoding
:: Converter . asciicompat _ encoding(string) -> Encoding | nil (10.0) -
同じ文字集合を持つ ASCII 互換エンコーディングを返します。
同じ文字集合を持つ ASCII 互換エンコーディングを返します。
@param string エンコーディング名
@param encoding エンコーディングオブジェクト
@return ASCII 互換エンコーディングのオブジェクトか nil
引数とエンコーディングと同じ文字集合を持つ ASCII 互換エンコーディングを返します。引数と戻り値、2 つのエンコーディング間では変換しても未定義文字の例外は発生しません。
引数が ASCII 互換エンコーディングである場合や、エンコーディングでない場合は nil を返します。
//emlist[][ruby]{
Encoding::Con... -
Encoding
:: Converter . new(convpath) -> Encoding :: Converter (10.0) -
Encoding::Converter オブジェクトを作成します。
Encoding::Converter オブジェクトを作成します。
@param source_encoding 変換元のエンコーディング
@param destination_encoding 変換先のエンコーディング
@param options 変換の詳細を指定する定数やハッシュ
@param convpath 変換経路の配列
options では String#encode でのハッシュオプションに加えて、以下の定数が利用可能です。
* Encoding::Converter::INVALID_REPLACE
* Encoding::Converter::UNDEF_RE... -
Encoding
:: Converter . new(source _ encoding , destination _ encoding) -> Encoding :: Converter (10.0) -
Encoding::Converter オブジェクトを作成します。
Encoding::Converter オブジェクトを作成します。
@param source_encoding 変換元のエンコーディング
@param destination_encoding 変換先のエンコーディング
@param options 変換の詳細を指定する定数やハッシュ
@param convpath 変換経路の配列
options では String#encode でのハッシュオプションに加えて、以下の定数が利用可能です。
* Encoding::Converter::INVALID_REPLACE
* Encoding::Converter::UNDEF_RE... -
Encoding
:: Converter . new(source _ encoding , destination _ encoding , options) -> Encoding :: Converter (10.0) -
Encoding::Converter オブジェクトを作成します。
Encoding::Converter オブジェクトを作成します。
@param source_encoding 変換元のエンコーディング
@param destination_encoding 変換先のエンコーディング
@param options 変換の詳細を指定する定数やハッシュ
@param convpath 変換経路の配列
options では String#encode でのハッシュオプションに加えて、以下の定数が利用可能です。
* Encoding::Converter::INVALID_REPLACE
* Encoding::Converter::UNDEF_RE... -
Encoding
:: Converter . search _ convpath(source _ encoding , destination _ encoding , options) -> Array (10.0) -
引数で指定した文字エンコーディングの変換の経路を配列にして返します。
引数で指定した文字エンコーディングの変換の経路を配列にして返します。
@param source_encoding 変換元の文字エンコーディングを Encoding オ
ブジェクトか文字列で指定します。
@param destination_encoding 変換先の文字エンコーディングを
Encoding オブジェクトか文字列で指定し
ます。
@param options 変換の詳細を指定する定数やハッシュを指定します。
... -
Enumerator
. new(obj , method = :each , *args) -> Enumerator (10.0) -
オブジェクト obj について、 each の代わりに method という 名前のメソッドを使って繰り返すオブジェクトを生成して返します。 args を指定すると、 method の呼び出し時に渡されます。
オブジェクト obj について、 each の代わりに method という
名前のメソッドを使って繰り返すオブジェクトを生成して返します。
args を指定すると、 method の呼び出し時に渡されます。
@param obj イテレータメソッドのレシーバとなるオブジェクト
@param method イテレータメソッドの名前を表すシンボルまたは文字列
@param args イテレータメソッドの呼び出しに渡す任意個の引数
//emlist[例][ruby]{
str = "xyz"
enum = Enumerator.new(str, :each_byte)
p enum.map... -
Enumerator
. new(size=nil) {|y| . . . } -> Enumerator (10.0) -
Enumerator オブジェクトを生成して返します。与えられたブロックは Enumerator::Yielder オブジェクトを 引数として実行されます。
Enumerator オブジェクトを生成して返します。与えられたブロックは Enumerator::Yielder オブジェクトを
引数として実行されます。
生成された Enumerator オブジェクトに対して each を呼ぶと、この生成時に指定されたブロックを
実行し、Yielder オブジェクトに対して << メソッドが呼ばれるたびに、
each に渡されたブロックが繰り返されます。
new に渡されたブロックが終了した時点で each の繰り返しが終わります。
このときのブロックの返り値が each の返り値となります。
@param size 生成する Enumerator... -
Enumerator
:: Lazy . new(obj , size=nil) {|yielder , *values| . . . } -> Enumerator :: Lazy (10.0) -
Lazy Enumerator を作成します。Enumerator::Lazy#force メソッドなどに よって列挙が実行されたとき、objのeachメソッドが実行され、値が一つずつ ブロックに渡されます。ブロックは、yielder を使って最終的に yield される値を 指定できます。
Lazy Enumerator を作成します。Enumerator::Lazy#force メソッドなどに
よって列挙が実行されたとき、objのeachメソッドが実行され、値が一つずつ
ブロックに渡されます。ブロックは、yielder を使って最終的に yield される値を
指定できます。
//emlist[Enumerable#filter_map と、その遅延評価版を定義する例][ruby]{
module Enumerable
def filter_map(&block)
map(&block).compact
end
end
class Enumerator::... -
Errno
:: EXXX . new() -> Errno :: EXXX (10.0) -
Errno::EXXX オブジェクトを生成して返します。
Errno::EXXX オブジェクトを生成して返します。
@param error_message エラーメッセージを表す文字列
p Errno::ENOENT.new
# => #<Errno::ENOENT: No such file or directory>
p Errno::ENOENT.new('message')
# => #<Errno::ENOENT: No such file or directory - message> -
Errno
:: EXXX . new(error _ message) -> Errno :: EXXX (10.0) -
Errno::EXXX オブジェクトを生成して返します。
Errno::EXXX オブジェクトを生成して返します。
@param error_message エラーメッセージを表す文字列
p Errno::ENOENT.new
# => #<Errno::ENOENT: No such file or directory>
p Errno::ENOENT.new('message')
# => #<Errno::ENOENT: No such file or directory - message> -
Exception
. exception(error _ message = nil) -> Exception (10.0) -
例外オブジェクトを生成して返します。
例外オブジェクトを生成して返します。
@param error_message エラーメッセージを表す文字列を指定します。このメッセージは
属性 Exception#message の値になり、デフォルトの例外ハンドラで表示されます。
//emlist[例][ruby]{
e = Exception.new("some message")
p e # => #<Exception: some message>
p e.message # => "some message"
//}
//emlist[例][ruby]{
e = E... -
Exception
. new(error _ message = nil) -> Exception (10.0) -
例外オブジェクトを生成して返します。
例外オブジェクトを生成して返します。
@param error_message エラーメッセージを表す文字列を指定します。このメッセージは
属性 Exception#message の値になり、デフォルトの例外ハンドラで表示されます。
//emlist[例][ruby]{
e = Exception.new("some message")
p e # => #<Exception: some message>
p e.message # => "some message"
//}
//emlist[例][ruby]{
e = E... -
Fiber
. new {|obj| . . . } -> Fiber (10.0) -
与えられたブロックとともにファイバーを生成して返します。 ブロックは Fiber#resume に与えられた引数をその引数として実行されます。
与えられたブロックとともにファイバーを生成して返します。
ブロックは Fiber#resume に与えられた引数をその引数として実行されます。
ブロックが終了した場合は親にコンテキストが切り替わります。
その時ブロックの評価値が返されます。
//emlist[例:][ruby]{
a = nil
f = Fiber.new do |obj|
a = obj
:hoge
end
b = f.resume(:foo)
p a #=> :foo
p b #=> :hoge
//} -
Fiber
. yield(*arg = nil) -> object (10.0) -
現在のファイバーの親にコンテキストを切り替えます。
現在のファイバーの親にコンテキストを切り替えます。
コンテキストの切り替えの際に Fiber#resume に与えられた引数を yield メソッドは返します。
@param arg 現在のファイバーの親に渡したいオブジェクトを指定します。
@raise FiberError Fiber でのルートファイバーで呼ばれた場合に発生します。
//emlist[例:][ruby]{
a = nil
f = Fiber.new do
a = Fiber.yield()
end
f.resume()
f.resume(:foo)
p a #=> :foo
//} -
File
. absolute _ path(file _ name , dir _ string=nil) -> String (10.0) -
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
. atime(filename) -> Time (10.0) -
最終アクセス時刻を返します。
最終アクセス時刻を返します。
@param filename ファイル名を表す文字列か IO オブジェクトを指定します。
@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。
//emlist[例][ruby]{
File.atime(__FILE__) # => 2017-11-28 22:38:44 +0900
//} -
File
. basename(filename , suffix = "") -> String (10.0) -
filename の一番後ろのスラッシュに続く要素を返します。もし、 引数 suffix が与えられて、かつそれが filename の末尾に 一致するなら、それを取り除いたものを返します。
filename の一番後ろのスラッシュに続く要素を返します。もし、
引数 suffix が与えられて、かつそれが filename の末尾に
一致するなら、それを取り除いたものを返します。
//emlist[例][ruby]{
p File.basename("ruby/ruby.c") #=> "ruby.c"
p File.basename("ruby/ruby.c", ".c") #=> "ruby"
p File.basename("ruby/ruby.c", ".*") #=> "ruby"
p File.basename("ruby/ruby.e... -
File
. blockdev?(path) -> bool (10.0) -
FileTest.#blockdev? と同じです。
FileTest.#blockdev? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。
@see FileTest.#blockdev? -
File
. chardev?(path) -> bool (10.0) -
FileTest.#chardev? と同じです。
FileTest.#chardev? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. chmod(mode , *filename) -> Integer (10.0) -
ファイルのモードを mode に変更します。モードを変更したファイ ルの数を返します。
ファイルのモードを mode に変更します。モードを変更したファイ
ルの数を返します。
@param filename ファイル名を表す文字列を指定します。
@param mode chmod(2) と同様に整数で指定します。
@raise Errno::EXXX モードの変更に失敗した場合に発生します。 -
File
. chown(owner , group , *filename) -> Integer (10.0) -
ファイルのオーナーとグループを変更します。スーパーユーザだけがファ イルのオーナーとグループを変更できます。変更を行ったファイルの数を 返します。
ファイルのオーナーとグループを変更します。スーパーユーザだけがファ
イルのオーナーとグループを変更できます。変更を行ったファイルの数を
返します。
@param filename ファイル名を表す文字列を指定します。
@param owner chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在のままにすることができます。
@param group chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在のままにすることができます。
@raise Errno::EXXX 変更に失敗した場合に発生し... -
File
. ctime(filename) -> Time (10.0) -
状態が最後に変更された時刻を返します。 状態の変更とは 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
. delete(*filename) -> Integer (10.0) -
ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 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") # => ... -
File
. directory?(path) -> bool (10.0) -
FileTest.#directory? と同じです。
FileTest.#directory? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. dirname(filename) -> String (10.0) -
filename の一番後ろのスラッシュより前を文 字列として返します。スラッシュを含まないファイル名に対しては "."(カレントディレクトリ)を返します。
filename の一番後ろのスラッシュより前を文
字列として返します。スラッシュを含まないファイル名に対しては
"."(カレントディレクトリ)を返します。
//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.di... -
File
. executable?(path) -> bool (10.0) -
FileTest.#executable? と同じです。
FileTest.#executable? と同じです。
@param path パスを表す文字列を指定します。 -
File
. executable _ real?(path) -> bool (10.0) -
FileTest.#executable_real? と同じです。
FileTest.#executable_real? と同じです。
@param path パスを表す文字列を指定します。 -
File
. exist?(path) -> bool (10.0) -
FileTest.#exist? と同じです。
FileTest.#exist? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. exists?(path) -> bool (10.0) -
このメソッドは Ruby 2.1 から deprecated です。File.exist? を使用してください。
このメソッドは Ruby 2.1 から deprecated です。File.exist? を使用してください。 -
File
. expand _ path(path , default _ dir = & # 39; . & # 39;) -> String (10.0) -
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
. extname(filename) -> String (10.0) -
ファイル名 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?(path) -> bool (10.0) -
FileTest.#file? と同じです。
FileTest.#file? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. fnmatch(pattern , path , flags = 0) -> bool (10.0) -
ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。
ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。
@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`?', `[]', `{}' が使用できます。
Dir.glob とは違って `**/' は使用できません。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# =>... -
File
. fnmatch?(pattern , path , flags = 0) -> bool (10.0) -
ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。
ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。
@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`?', `[]', `{}' が使用できます。
Dir.glob とは違って `**/' は使用できません。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# =>... -
File
. ftype(filename) -> String (10.0) -
ファイルのタイプを表す文字列を返します。
ファイルのタイプを表す文字列を返します。
文字列は以下のうちのいずれかです。File.lstat(filename).ftype と同じです。
シンボリックリンクに対して "link" を返します。
* "file"
* "directory"
* "characterSpecial"
* "blockSpecial"
* "fifo"
* "link"
* "socket"
* "unknown"
@param filename ファイル名を表す文字列を指定します。
@raise Errno::EXXX 情報の取得に失敗した場合に発生します。
//emlist[... -
File
. grpowned?(path) -> bool (10.0) -
FileTest.#grpowned? と同じです。
FileTest.#grpowned? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. identical?(filename1 , filename2) -> bool (10.0) -
FileTest.#identical? と同じです。
FileTest.#identical? と同じです。
@param filename1 パスを表す文字列か IO オブジェクトを指定します。
@param filename2 パスを表す文字列か IO オブジェクトを指定します。 -
File
. join(*item) -> String (10.0) -
File::SEPARATORを間に入れて文字列を連結します。platform/DOSISH-supportで環境依存になる予定です。
File::SEPARATORを間に入れて文字列を連結します。platform/DOSISH-supportで環境依存になる予定です。
@param item 連結したいディレクトリ名やファイル名を文字列(もしくは文字列を要素に持つ配列)で与えます。
文字列AとBを連結する際に、Aの末尾の文字とBの先頭の文字がFile::SEPARATORであった場合には、
まずこれらを削除した上で改めてFile::SEPARATORを間に入れて連結します。
引数の中に配列がある場合は配列要素を再帰的に展開します。空の配列は空文字列に... -
File
. lchmod(mode , *filename) -> Integer (10.0) -
File.chmod と同様ですが、シンボリックリンクに関してリンクそのものの モードを変更します。
File.chmod と同様ですが、シンボリックリンクに関してリンクそのものの
モードを変更します。
@param filename ファイル名を表す文字列を指定します。
@param mode chmod(2) と同様に整数で指定します。
@raise NotImplementedError lchmod(2) を実装していないシステムでこのメソッドを呼び出すと発生します。
@raise Errno::EXXX モードの変更に失敗した場合に発生します。
//emlist[例][ruby]{
IO.write("testfile", "test")
File.symlink("te... -
File
. lchown(owner , group , *filename) -> Integer (10.0) -
File#chown と同様ですが、 シンボリックリンクに関してリンクそのもののオーナー、 グループを変更します。
File#chown と同様ですが、
シンボリックリンクに関してリンクそのもののオーナー、
グループを変更します。
@param filename ファイル名を表す文字列を指定します。
@param owner chown(2) と同様に数値で指定します。nil または -1 を指定することで、オーナーを現在のままにすることができます。
@param group chown(2) と同様に数値で指定します。nil または -1 を指定することで、グループを現在のままにすることができます。
@raise NotImplementedError lchown(2) を実装していないシステ... -
File
. link(old , new) -> 0 (10.0) -
old を指す new という名前のハードリンクを 生成します。old はすでに存在している必要があります。 ハードリンクに成功した場合は 0 を返します。
old を指す new という名前のハードリンクを
生成します。old はすでに存在している必要があります。
ハードリンクに成功した場合は 0 を返します。
失敗した場合は例外 Errno::EXXX が発生します。
@param old ファイル名を表す文字列を指定します。
@param new ファイル名を表す文字列を指定します。
@raise Errno::EXXX 失敗した場合に発生します。
//emlist[例][ruby]{
IO.write("testfile", "test")
File.link("testfile", "testlink") # => 0... -
File
. lstat(filename) -> File :: Stat (10.0) -
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
. mtime(filename) -> Time (10.0) -
最終更新時刻を返します。
最終更新時刻を返します。
@param filename ファイル名を表す文字列か IO オブジェクトを指定します。
@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。
//emlist[例][ruby]{
File.mtime(__FILE__) # => 2017-12-03 03:16:22 +0900
//} -
File
. new(path , mode = "r" , perm = 0666) -> File (10.0) -
path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。
path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。
path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。
@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。
@param mode モードを文字列か定数の論理... -
File
. open(path , mode = "r" , perm = 0666) -> File (10.0) -
path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。
path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。
path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。
@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。
@param mode モードを文字列か定数の論理... -
File
. open(path , mode = "r" , perm = 0666) {|file| . . . } -> object (10.0) -
path で指定されるファイルをオープンし、File オブジェクトを生成して 返します。
path で指定されるファイルをオープンし、File オブジェクトを生成して
返します。
path が整数の場合はファイルディスクリプタとして扱い、それに対応する
File オブジェクトを生成して返します。IO.open と同じです。
ブロックを指定して呼び出した場合は、File オブジェクトを引数として
ブロックを実行します。ブロックの実行が終了すると、ファイルは自動的に
クローズされます。ブロックの実行結果を返します。
@param path ファイルを文字列で指定します。整数を指定した場合はファイルディスクリプタとして扱います。
@param mode モードを文字列か定数の論理... -
File
. owned?(path) -> bool (10.0) -
FileTest.#owned? と同じです。
FileTest.#owned? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. path(filename) -> String (10.0) -
指定されたファイル名を文字列で返します。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
. pipe?(path) -> bool (10.0) -
FileTest.#pipe? と同じです。
FileTest.#pipe? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. readable?(path) -> bool (10.0) -
FileTest.#readable? と同じです。
FileTest.#readable? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. readable _ real?(path) -> bool (10.0) -
FileTest.#readable_real? と同じです。
FileTest.#readable_real? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. readlink(path) -> String (10.0) -
シンボリックリンクのリンク先のパスを文字列で返します。
シンボリックリンクのリンク先のパスを文字列で返します。
@param path シンボリックリンクを表す文字列を指定します。
@raise Errno::EXXX 指定された path がシンボリックリンクでない場合や、リンクの読み取りに失敗した場合に発生します。
//emlist[例:][ruby]{
IO.write("testfile", "test")
File.symlink("testfile", "testlink") # => 0
File.readlink("testlink") # => "testfile"
//} -
File
. realdirpath(pathname , basedir = nil) -> String (10.0) -
与えられた pathname に対応する絶対パスを返します。
与えられた pathname に対応する絶対パスを返します。
pathname の最後のコンポーネントは存在していなくても例外は発生しません。
@param pathname ファイル名を指定します。
@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。
@raise Errno::ENOENT ファイルが存在しない場合に発生します。 -
File
. realpath(pathname , basedir = nil) -> String (10.0) -
与えられた pathname に対応する絶対パスを返します。
与えられた pathname に対応する絶対パスを返します。
pathname の全てのコンポーネントは存在しなければなりません。
@param pathname ファイル名を指定します。
@param basedir ベースディレクトリを指定します。省略するとカレントディレクトリを使用します。
@raise Errno::ENOENT ファイルが存在しない場合に発生します。
//emlist[例][ruby]{
ENV["HOME"] # => "/home/matz"
File.symlink("testfile", "testlink"... -
File
. rename(from , to) -> 0 (10.0) -
ファイルの名前を変更します。ディレクトリが異なる場合には移動も行い ます。rename(2) を参照してください。移動先のファ イルが存在する時には上書きされます。
ファイルの名前を変更します。ディレクトリが異なる場合には移動も行い
ます。rename(2) を参照してください。移動先のファ
イルが存在する時には上書きされます。
ファイルの移動に成功した場合 0 を返します。失敗した場合は例外
Errno::EXXX が発生します。
@param from ファイルの名前を文字列で与えます。
@param to 新しいファイル名を文字列で与えます。
@raise Errno::EXXX 失敗した場合に発生します。
//emlist[例][ruby]{
begin
File.rename("testfile", "testfile.bak")... -
File
. setgid?(path) -> bool (10.0) -
FileTest.#setgid? と同じです。
FileTest.#setgid? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. setuid?(path) -> bool (10.0) -
FileTest.#setuid? と同じです。
FileTest.#setuid? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. size(path) -> Integer (10.0) -
FileTest.#size と同じです。
FileTest.#size と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. size?(path) -> Integer | nil (10.0) -
FileTest.#size? と同じです。
FileTest.#size? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. socket?(path) -> bool (10.0) -
FileTest.#socket? と同じです。
FileTest.#socket? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. split(pathname) -> [String] (10.0) -
pathname を dirname とbasename に分割して、2 要 素の配列を返します。
pathname を dirname とbasename に分割して、2 要
素の配列を返します。
//emlist[][ruby]{
[File.dirname(pathname), File.basename(pathname)]
//}
と同じです。
@param pathname パス名を表す文字列を指定します。 -
File
. stat(filename) -> File :: Stat (10.0) -
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
. sticky?(path) -> bool (10.0) -
FileTest.#sticky? と同じです。
FileTest.#sticky? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. symlink(old , new) -> 0 (10.0) -
old への new という名前のシンボリックリンクを生成します。
old への new という名前のシンボリックリンクを生成します。
シンボリックリンクの作成に成功すれば 0 を返します。失敗した場合は
例外 Errno::EXXX が発生します。
@param old ファイル名を表す文字列を指定します。
@param new シンボリックリンクを表す文字列を指定します。
@raise Errno::EXXX 失敗した場合に発生します。
//emlist[例][ruby]{
File.symlink("testfile", "testlink") # => 0
//} -
File
. symlink?(path) -> bool (10.0) -
FileTest.#symlink? と同じです。
FileTest.#symlink? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
. truncate(path , length) -> 0 (10.0) -
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... -
File
. umask -> Integer (10.0) -
現在の umask の値を返します。
現在の umask の値を返します。
@see umask(2) -
File
. umask(umask) -> Integer (10.0) -
umask を変更します。変更前の umask の値を返します。
umask を変更します。変更前の umask の値を返します。
@param umask 設定したい umask の値を整数で指定します。
//emlist[例][ruby]{
File.umask(0006) # => 18
File.umask # => 6
//}
@see umask(2) -
File
. unlink(*filename) -> Integer (10.0) -
ファイルを削除します。削除したファイルの数を返します。 削除に失敗した場合は例外 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") # => ... -
File
. utime(atime , mtime , *filename) -> Integer (10.0) -
ファイルの最終アクセス時刻と更新時刻を変更します。
ファイルの最終アクセス時刻と更新時刻を変更します。
@param atime 最終アクセス時刻を Time か、起算時からの経過秒数を数値で指定します。
@param mtime 更新時刻を Time か、起算時からの経過秒数を数値で指定します。
@param filename ファイル名を表す文字列を指定します。複数指定できます。
@return 変更したファイルの数を返します。
@raise Errno::EXXX 変更に失敗した場合に発生します。
//emlist[例: Time を指定][ruby]{
atime = Time.new(2018, 1, 2, 3, 4, ... -
File
. world _ readable?(path) -> Integer | nil (10.0) -
path が全てのユーザから読めるならばそのファイルのパーミッションを表す 整数を返します。そうでない場合は nil を返します。
path が全てのユーザから読めるならばそのファイルのパーミッションを表す
整数を返します。そうでない場合は nil を返します。
整数の意味はプラットフォームに依存します。
@param path パスを表す文字列か IO オブジェクトを指定します。
//emlist[例][ruby]{
m = File.world_readable?("/etc/passwd")
"%o" % m # => "644"
//} -
File
. world _ writable?(path) -> bool (10.0) -
path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す 整数を返します。そうでない場合は nil を返します。
path が全てのユーザから書き込めるならば、そのファイルのパーミッションを表す
整数を返します。そうでない場合は nil を返します。
整数の意味はプラットフォームに依存します。
@param path パスを表す文字列か IO オブジェクトを指定します。
//emlist[例][ruby]{
m = File.world_writable?("/tmp")
"%o" % m #=> "777"
//} -
File
. writable?(path) -> bool (10.0) -
FileTest.#writable? と同じです。
FileTest.#writable? と同じです。
@param path パスを表す文字列を指定します。 -
File
. writable _ real?(path) -> bool (10.0) -
FileTest.#writable_real? と同じです。
FileTest.#writable_real? と同じです。
@param path パスを表す文字列を指定します。 -
File
. zero?(path) -> bool (10.0) -
FileTest.#zero? と同じです。
FileTest.#zero? と同じです。
@param path パスを表す文字列か IO オブジェクトを指定します。 -
File
:: Stat . new(path) -> File :: Stat (10.0) -
path に関する File::Stat オブジェクトを生成して返します。 File.stat と同じです。
path に関する File::Stat オブジェクトを生成して返します。
File.stat と同じです。
@param path ファイルのパスを指定します。
@raise Errno::ENOENT pathに該当するファイルが存在しない場合発生します。
//emlist[][ruby]{
p $:[0]
#=> 例
# "C:/Program Files/ruby-1.8/lib/ruby/site_ruby/1.8"
p File::Stat.new($:[0])
#=> 例
#<File::Stat dev=0x2, ino=0, mode=040755, nlink=1,... -
GC
. count -> Integer (10.0) -
プロセス開始からガーベージコレクトを実行した回数を Integer で返し ます。
プロセス開始からガーベージコレクトを実行した回数を Integer で返し
ます。
//emlist[例][ruby]{
GC.count # => 3
//} -
GC
. disable -> bool (10.0) -
ガーベージコレクトを禁止します。
ガーベージコレクトを禁止します。
前回の禁止状態を返します(禁止されていたなら true, GC が有効であったなら、
false)。
//emlist[例][ruby]{
GC.disable # => false
GC.disable # => true
//}
@see GC.enable -
GC
. enable -> bool (10.0) -
ガーベージコレクトを許可します。
ガーベージコレクトを許可します。
前回の禁止状態を返します(禁止されていたなら true, GC が有効であったなら、
false)。
@see GC.disable
//emlist[例][ruby]{
GC.disable # => false
GC.enable # => true
GC.enable # => false
//} -
GC
. latest _ gc _ info(key) -> object (10.0) -
最新のGCの情報を返します。
最新のGCの情報を返します。
@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。
@param key 得られる情報から特定の情報を取得したい場合にキーを
Symbol で指定します。
//emlist[例][ruby]{
latest = GC.latest_gc_info
latest # => {:major_by=>nil, :gc_by=>:newobj, :ha... -
GC
. latest _ gc _ info(result _ hash = {}) -> Hash (10.0) -
最新のGCの情報を返します。
最新のGCの情報を返します。
@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。
@param key 得られる情報から特定の情報を取得したい場合にキーを
Symbol で指定します。
//emlist[例][ruby]{
latest = GC.latest_gc_info
latest # => {:major_by=>nil, :gc_by=>:newobj, :ha... -
GC
. start(full _ mark: true , immediate _ sweep: true) -> nil (10.0) -
ガーベージコレクトを開始します。
ガーベージコレクトを開始します。
GC#garbage_collect や ObjectSpace.#garbage_collect と同じ働きをします。
GC.disable により GC が禁止されている場合は何もしません。
nil を返します。
@param full_mark マイナー GC を動作させる場合は false を、そうでない場
合は true を指定します。
@param immediate_sweep sweep を遅らせる(Lazy Sweep を行う)場合は false
を、そ... -
GC
. stat(key) -> Numeric (10.0) -
GC 内部の統計情報を Hash で返します。
GC 内部の統計情報を Hash で返します。
@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。
@param key 得られる統計情報から特定の情報を取得したい場合にキーを
Symbol で指定します。
@return GC 内部の統計情報をHash で返します。
引数 key を指定した場合は数値を返します。
GC.stat
# =>
... -
GC
. stat(result _ hash = {}) -> {Symbol => Integer} (10.0) -
GC 内部の統計情報を Hash で返します。
GC 内部の統計情報を Hash で返します。
@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。
@param key 得られる統計情報から特定の情報を取得したい場合にキーを
Symbol で指定します。
@return GC 内部の統計情報をHash で返します。
引数 key を指定した場合は数値を返します。
GC.stat
# =>
... -
GC
. stress -> bool (10.0) -
GCがストレスモードかどうかを返します。
GCがストレスモードかどうかを返します。
真が設定されている場合は GC を行えるすべての機会に GC を行います。
@see GC.stress= -
GC
. stress=(value) (10.0) -
GCのストレスモードを引数 value に設定します。 引数 value が真に設定されている間は、GC を行えるすべての機会に GC を行います。
GCのストレスモードを引数 value に設定します。
引数 value が真に設定されている間は、GC を行えるすべての機会に GC を行います。
この機能はデバッグ用途に提供されています。ストレスモードを有効にすると
プログラムのパフォーマンスが低下します。
@param value 任意のオブジェクト。整数以外の値を指定した場合は真偽値として解釈されます。
整数を指定する場合は以下のフラグをOR演算した値を指定します。
: 0x01
マイナー GC を動作させる場合に指定します。
: 0x02
sweep を遅らせる(Lazy Sweep を行う)... -
GC
:: Profiler . clear -> nil (10.0) -
蓄積している GC のプロファイル情報をすべて削除します。
蓄積している GC のプロファイル情報をすべて削除します。
例:
GC::Profiler.enable
GC.start
GC.start
GC::Profiler.report #=> 2 回分の GC のプロファイル情報出力する。
GC::Profiler.clear
GC.start
GC::Profiler.report #=> 1 回分の GC のプロファイル情報出力する。 -
GC
:: Profiler . disable -> nil (10.0) -
GC のプロファイラを停止します。
GC のプロファイラを停止します。
例:
GC::Profiler.disable
GC::Profiler.enabled? #=> false
このメソッドでは、蓄積したプロファイル情報は破棄しません。
破棄したい場合は GC::Profiler.clear を呼び出してください。
@see GC::Profiler.enable, GC::Profiler.enabled? -
GC
:: Profiler . enable -> nil (10.0) -
GC のプロファイラを起動します。
GC のプロファイラを起動します。
このメソッドを呼び出してから GC が発生すると、
GC についてプロファイル情報を取得します。
例:
GC::Profiler.enable
GC::Profiler.enabled? #=> true
@see GC::Profiler.disable, GC::Profiler.enabled? -
GC
:: Profiler . enabled? -> bool (10.0) -
GC のプロファイラを起動中であれば true、停止中であれば false を返します。
GC のプロファイラを起動中であれば true、停止中であれば false を返します。
例:
GC::Profiler.enabled? #=> false
GC::Profiler.enable
GC::Profiler.enabled? #=> true
GC::Profiler.disable
GC::Profiler.enabled? #=> false
@see GC::Profiler.enable, GC::Profiler.disable -
GC
:: Profiler . raw _ data -> [Hash , . . . ] | nil (10.0) -
GC のプロファイル情報を GC の発生ごとに Hash の配列 (:GC_INVOKE_TIME が早いもの順)で返します。GC::Profiler が有効になっ ていない場合は nil を返します。
GC のプロファイル情報を GC の発生ごとに Hash の配列
(:GC_INVOKE_TIME が早いもの順)で返します。GC::Profiler が有効になっ
ていない場合は nil を返します。
例:
GC::Profiler.enable
GC.start
GC::Profiler.raw_data
# => [
{
:GC_TIME=>1.3000000000000858e-05,
:GC_INVOKE_TIME=>0.010634999999999999,
:HEAP_USE_SIZE=>289640,
... -
GC
:: Profiler . report(out = $ stdout) -> nil (10.0) -
GC::Profiler.result の結果を out に出力します。
GC::Profiler.result の結果を out に出力します。
@param out 結果の出力先を指定します。デフォルトは $stdout です。
//emlist[例][ruby]{
GC::Profiler.enable
GC.start
GC::Profiler.report
# => GC 4 invokes.
# Index Invoke Time(sec) Use Size(byte) Total Size(byte) Total Object GC Time(ms)
# 1...