検索結果

DRb.#install_acl(acl) -> () (18304.0)

• 2.5.0

• モジュール関数

サーバ起動時の :acl オプションのデフォルト値を指定します。

サーバ起動時の :acl オプションのデフォルト値を指定します。

内部的には DRb::DRbServer.default_acl を呼び出すだけです。

@see ACL

• ACL
• DRb

DRb.#install_id_conv(idconv) -> () (18304.0)

• 2.5.0

• モジュール関数

サーバ起動時の :id_conv オプションのデフォルト値を指定します。

サーバ起動時の :id_conv オプションのデフォルト値を指定します。

内部的には DRb::DRbServer.default_id_conv を呼び出すだけです。

• DRb

DRb.#start_service(uri=nil, front=nil, config_or_acl=nil) -> () (18304.0)

• 2.5.0

• モジュール関数

dRuby のサービス(サーバ)を起動します。

dRuby のサービス(サーバ)を起動します。

これで起動したサーバはプロセスのプライマリサーバとなります。
すでにプライマリサーバが存在する場合は上書きされます。

uri に URI を文字列で指定すると、それに起動したサービスを bind します。
通常は 'druby://<hostname>:<port>' という形式の URI を指定します。
このときは TCP が通信手段として使われます。
'drbunix:' のような他のプロトコルを指定することもできます。

front でフロントオブジェクト(URI に結び付けられるオブジェクト)を
設定します。

config で H...

• ACL
• DRb
• DRb::DRbIdConv
• DRb::DRbServer
• Hash

DRb.#stop_service -> () (18304.0)

• 2.5.0

• モジュール関数

ローカルプロセス内の dRuby サーバ(プライマリサーバ)を停止します。

ローカルプロセス内の dRuby サーバ(プライマリサーバ)を停止します。

サーバが動いていない場合は何もしません。

• DRb

ERB::Util.#html_escape(s) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 s を HTML用にエスケープした文字列を返します。

文字列 s を HTML用にエスケープした文字列を返します。

文字列 s 中に含まれる &"<> を、実体参照 &amp; &quot; &lt; &gt; にそれぞれ変更した文字列を返します
(CGI.escapeHTMLとほぼ同じです)。

@param s HTMLエスケープを行う文字列

//emlist[例][ruby]{
require "erb"
include ERB::Util

puts html_escape("is a > 0 & a < 10?")
# is a &gt; 0 &amp; a &lt; 10?
//}

• ERB::Util

絞り込み条件を変える

Etc.#endgrent -> nil (18304.0)

• 2.5.0

• モジュール関数

Etc.#getgrent によって開始された /etc/group ファイルを読む プロセスを終了させファイルを閉じます。

Etc.#getgrent によって開始された /etc/group ファイルを読む
プロセスを終了させファイルを閉じます。

@see getgrent(3)

• Etc

Etc.#endpwent -> nil (18304.0)

• 2.5.0

• モジュール関数

Etc.#getpwent によって開始された /etc/passwdファイルを読む プロセスを終了させファイルを閉じます。

Etc.#getpwent によって開始された /etc/passwdファイルを読む
プロセスを終了させファイルを閉じます。

@see getpwent(3)

• Etc

Etc.#getgrent -> Etc::Group | nil (18304.0)

• 2.5.0

• モジュール関数

/etc/group ファイルから読み込んだエントリを一つ返します。

/etc/group ファイルから読み込んだエントリを一つ返します。

最初の呼び出しでは、先頭のエントリを返します。それ以降の呼び出しでは、
呼び出す度に次のエントリを順に返します。ファイルの終端に達すると nil を返します。

処理が終了したときは Etc.#endgrent を呼び出すようにしてください。

@see getgrent(3), Etc::Group

• Etc
• Etc::Group

Etc.#getgrgid(gid) -> Etc::Group (18304.0)

• 2.5.0

• モジュール関数

group データベースを検索し、グループ ID が gid であるグループエントリを返します。

group データベースを検索し、グループ ID が gid
であるグループエントリを返します。

@param gid 検索する gid

@raise ArgumentError エントリが見つからなかった場合に発生します。

@see getgrgid(3), Etc::Group

• Etc
• Etc::Group

Etc.#getgrnam(name) -> Etc::Group (18304.0)

• 2.5.0

• モジュール関数

name という名前のグループエントリを返します。

name という名前のグループエントリを返します。

@param name 検索するグループ名。

@raise ArgumentError エントリが見つからなかった場合に発生します。

@see getgrnam(3), Etc::Group

• Etc
• Etc::Group

絞り込み条件を変える

Etc.#getlogin -> String | nil (18304.0)

• 2.5.0

• モジュール関数

自分の login 名を返します。得られなかった場合は nil を返します。

自分の login 名を返します。得られなかった場合は nil を返します。

getlogin は su(1) などでログイン時のユーザとは異なるユーザになっている場合、
現在ではなくログイン時のユーザを返します。

このメソッドが失敗した場合は Etc.#getpwuid に
フォールバックするとよいでしょう。

たとえば、環境変数 USER などもあわせて、以下のようにフォールバックできます。

//emlist[][ruby]{
require "etc"
login_user = ENV['USER'] || ENV['LOGNAME'] || Etc.getlogin || Et...

• Etc

Etc.#getpwent -> Etc::Passwd | nil (18304.0)

• 2.5.0

• モジュール関数

/etc/passwd から読み込んだエントリを一つ返します。

/etc/passwd から読み込んだエントリを一つ返します。

最初の呼び出しでは、先頭のエントリを返します。それ以降の呼び出しでは、
呼び出す度に次のエントリを順に返します。ファイルの終端に達すると nil を返します。

処理が終了したときは Etc.#endpwent を呼び出すようにしてください。

@see getpwent(3)

• Etc

Etc.#getpwnam(name) -> Etc::Passwd (18304.0)

• 2.5.0

• モジュール関数

passwd データベースを検索し、 名前が name である passwd エントリを返します。

passwd データベースを検索し、
名前が name である passwd エントリを返します。

@param name 検索するユーザ名。

@raise ArgumentError エントリが見つからなかった場合に発生します。

@see getpwnam(3), Etc::Passwd

• Etc
• Etc::Passwd

Etc.#getpwuid(uid = getuid) -> Etc::Passwd (18304.0)

• 2.5.0

• モジュール関数

passwd データベースを検索し、 ユーザ ID が uid である passwd エントリを返します。

passwd データベースを検索し、
ユーザ ID が uid である passwd エントリを返します。

@param uid 検索する uid 。引数を省略した場合には getuid(2) の値を用います。

@raise ArgumentError エントリが見つからなかった場合に発生します。

@see getpwuid(3), Etc::Passwd

• Etc
• Etc::Passwd

Etc.#setgrent -> nil (18304.0)

• 2.5.0

• モジュール関数

/etc/group の先頭に戻ります。

/etc/group の先頭に戻ります。

このメソッドを呼び出した後 Etc.#getgrent を呼び出すと先頭のエントリを返します。

@see getgrent(3)

• Etc

絞り込み条件を変える

Etc.#setpwent -> nil (18304.0)

• 2.5.0

• モジュール関数

/etc/passwd の先頭に戻ります。

/etc/passwd の先頭に戻ります。

このメソッドを呼び出した後 Etc.#getpwent を呼び出すと先頭のエントリを返します。

@see getpwent(3)

• Etc

Etc.#systmpdir -> String | nil (18304.0)

• 2.5.0

• モジュール関数

システムのテンポラリディレクトリを返します。

システムのテンポラリディレクトリを返します。

//emlist[][ruby]{
require 'etc'
p Etc.systmpdir # => "/tmp"
//}

• Etc

FileTest.#directory?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

例:
FileTest.directory?('/etc') # => true
FileTest.directory?('/etc/passwd') # => false

f = File.open('/etc')...

• FileTest

FileTest.#empty?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

//emlist[例:][ruby]{
IO.write("zero.txt", "")
FileTest.zero?("zero.txt") # => true
IO.write("nonzero.txt", "1")
Fil...

• FileTest

FileTest.#executable?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

ファイルがカレントプロセスにより実行できる時に真を返しま す。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルがカレントプロセスにより実行できる時に真を返しま
す。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

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

例:
FileTest.executable?('/bin') # => true
FileTest.executable?('/bin/bash') # => true

• FileTest

絞り込み条件を変える

FileTest.#executable_real?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

ファイルがカレントプロセスの実ユーザか実グループで実行できる時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルがカレントプロセスの実ユーザか実グループで実行できる時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

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

//emlist[例][ruby]{
IO.write("empty.txt", "")
File.chmod(0744, "empty.txt")
FileTest.executable_real?("empty.txt") # => true
File.chmod(0644, "empty.txt")
FileTest.ex...

• FileTest

FileTest.#exist?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

例:
FileTest.exist?('/etc/passwd') # => true
FileTest.exist?('/etc') # => true
FileTest.exist?('/etc/no_such_file') # => false...

• FileTest

FileTest.#exists?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

このメソッドは Ruby 2.1 から deprecated です。FileTest.#exist? を使用してください。

このメソッドは Ruby 2.1 から deprecated です。FileTest.#exist? を使用してください。

• FileTest

FileTest.#identical?(file1, file2) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

ruby 1.8.3 以前ではKernel.#test(?-, file1, file2)を使ってください。

open("a", "w") {}
p File.identical?("a", "a") #=> true
p File.identical?("a", "./a") #=> true
File.link("a", "b")
p File.identical...

• FileTest

FileTest.#setgid?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("g+s", "testfile")
FileTest.setgid?("testfile") # => true
FileUtils.chmod("g-s", "...

• FileTest

絞り込み条件を変える

FileTest.#setuid?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("u+s", "testfile")
FileTe...

• FileTest

FileTest.#socket?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

//emlist[例][ruby]{
require "socket"

IO.write("testfile", "test")
p FileTest.socket?("testfile") ...

• FileTest

FileTest.#world_writable?(path) -> bool (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

m = FileTest.world_writable?("/tmp")
"%o" % m #=> "777"

• FileTest

FileTest.#writable?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

ファイルがカレントプロセスにより書き込み可能である時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルがカレントプロセスにより書き込み可能である時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

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

//emlist[例][ruby]{
IO.write("testfile", "test")
File.chmod(0600, "testfile")
FileTest.writable?("testfile") # => true
File.chmod(0400, "testfile")
FileTest.writable?("tes...

• FileTest

FileTest.#writable_real?(file) -> bool (18304.0)

• 2.5.0

• モジュール関数

ファイルがカレントプロセスの実ユーザか実グループによって書き込み可能である時に真 を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルがカレントプロセスの実ユーザか実グループによって書き込み可能である時に真
を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

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


@see FileTest.#writable?

• FileTest

絞り込み条件を変える

FileUtils.#compare_stream(io_a, io_b) -> bool (18304.0)

• 2.5.0

• モジュール関数

IO オブジェクト io_a と io_b の内容が同じなら真を返します。

IO オブジェクト io_a と io_b の内容が同じなら真を返します。

@param io_a IO オブジェクト。

@param io_b IO オブジェクト。

• FileUtils
• IO

FileUtils.#copy_entry(src, dest, preserve = false, dereference_root = false) -> () (18304.0)

• 2.5.0

• モジュール関数

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

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

src が普通のファイルでない場合はその種別まで含めて完全にコピーします。
src がディレクトリの場合はその中身を再帰的にコピーします。

@param src コピー元。

@param dest コピー先。

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

@param dereference_root dereference_root が真のときは src についてだけシンボリックリンクの指す
...

• FileUtils

FileUtils.#copy_stream(src, dest) -> () (18304.0)

• 2.5.0

• モジュール関数

src を dest にコピーします。 src には read メソッド、dest には write メソッドが必要です。

src を dest にコピーします。
src には read メソッド、dest には write メソッドが必要です。

@param src read メソッドを持つオブジェクト。

@param dest write メソッドを持つオブジェクト。

• FileUtils

FileUtils.#getwd -> String (18304.0)

• 2.5.0

• モジュール関数

プロセスのカレントディレクトリを文字列で返します。

プロセスのカレントディレクトリを文字列で返します。

• FileUtils

FileUtils.#identical?(file_a, file_b) -> bool (18304.0)

• 2.5.0

• モジュール関数

ファイル file_a と file_b の内容が同じなら真を返します。

ファイル file_a と file_b の内容が同じなら真を返します。

@param file_a ファイル名。

@param file_b ファイル名。

//emlist[][ruby]{
require 'fileutils'
FileUtils.cmp('somefile', 'somefile') #=> true
FileUtils.cmp('/dev/null', '/dev/urandom') #=> false
//}

• FileUtils

絞り込み条件を変える

FileUtils.#install(src, dest, options = {}) -> () (18304.0)

• 2.5.0

• モジュール関数

src と dest の内容が違うときだけ src を dest にコピーします。

src と dest の内容が違うときだけ src を dest にコピーします。

@param src コピー元。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

@param dest コピー先のファイルかディレクトリです。

@param options :preserve, :noop, :verbose, :mode, :owner, :group が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils'
FileUti...

• FileUtils

FileUtils.#mkpath(list, options = {}) -> Array (18304.0)

• 2.5.0

• モジュール関数

ディレクトリ dir とその親ディレクトリを全て作成します。

ディレクトリ dir とその親ディレクトリを全て作成します。

例えば、
//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir_p('/usr/local/lib/ruby')
//}

は以下の全ディレクトリを (なければ) 作成します。

* /usr
* /usr/local
* /usr/local/bin
* /usr/local/bin/ruby

@param list 作成するディレクトリ。一つの場合は文字列でも指定できます。
二つ以上指定する場合は配列で指定します。

@param...

• FileUtils

FileUtils.#remove_entry(path, force = false) -> () (18304.0)

• 2.5.0

• モジュール関数

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

このメソッドにはローカル脆弱性が存在します。
詳しくは FileUtils.#remove_entry_secure の項を参照してください。

@param path 削除するパス。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.remove_entry '/tmp/ruby.tmp.08883'
//}

@see FileUtils.#remove_e...

• FileUtils
• StandardError

FileUtils.#remove_entry_secure(path, force = false) -> () (18304.0)

• 2.5.0

• モジュール関数

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

ファイル path を削除します。path がディレクトリなら再帰的に削除します。

FileUtils.#rm_r および FileUtils.#remove_entry には
TOCTTOU (time-of-check to time-of-use)脆弱性が存在します。
このメソッドはそれを防ぐために新設されました。
FileUtils.#rm_r および FileUtils.#remove_entry は以下の条件が
満たされるときにはセキュリティホールになりえます。

* 親ディレクトリが全ユーザから書き込み可能 (/tmp を含む)
* path 以下のいずれかのディレク...

• FileUtils
• StandardError

FileUtils.#rmtree(list, options = {}) -> () (18304.0)

• 2.5.0

• モジュール関数

ファイルまたはディレクトリ list を再帰的に消去します。

ファイルまたはディレクトリ list を再帰的に消去します。

rm_r(list, force: true) と同じです。

@param list 削除する対象。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :noop, :verbose, :secure が指定できます。
c:FileUtils#options

=== 注意

このメソッドにはローカル脆弱性が存在します。
この脆弱性を回避するには :secure オプションを使用してください。
詳しくは FileUt...

• FileUtils

絞り込み条件を変える

FileUtils.#touch(list, options = {}) -> () (18304.0)

• 2.5.0

• モジュール関数

list で指定されたファイルの最終変更時刻 (mtime) と アクセス時刻 (atime) を変更します。

list で指定されたファイルの最終変更時刻 (mtime) と
アクセス時刻 (atime) を変更します。

list で指定されたファイルが存在しない場合は空のファイルを作成します。

@param list 対象のファイル。一つの場合は文字列も指定可能です。
二つ以上指定する場合は配列で指定します。

@param options :mtime, :nocreate, :noop, :verbose が指定できます。
c:FileUtils#options

//emlist[][ruby]{
require 'fileutils...

• FileUtils

FileUtils.#uptodate?(newer, older_list, options = nil) -> bool (18304.0)

• 2.5.0

• モジュール関数

newer が、older_list に含まれるすべてのファイルより新しいとき真。 存在しないファイルは無限に古いとみなされます。

newer が、older_list に含まれるすべてのファイルより新しいとき真。
存在しないファイルは無限に古いとみなされます。

@param newer ファイルを一つ指定します。

@param older_list ファイル名の配列を指定します。

@param options どのようなオプションも指定することはできません。

@raise ArgumentError options にオプションを指定した場合に発生します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.uptodate?('hello.o', ['hello....

• FileUtils

Gem.#clear_paths -> nil (18304.0)

• 2.5.0

• モジュール関数

Gem.#dir, Gem.#path の値をリセットします。

Gem.#dir, Gem.#path の値をリセットします。

次に Gem.#dir, Gem.#path が呼ばれた時は、値を最初から計算します。
このメソッドは主にユニットテストの独立性を提供するために使用します。

• Gem

Gem.#ensure_gem_subdirectories (18304.0)

• 2.5.0

• モジュール関数

Gem をインストールするために必要なサブディレクトリを適切に作成します。

Gem をインストールするために必要なサブディレクトリを適切に作成します。

ディレクトリを作成する権限が無い場合もこのメソッドからは例外は発生しません。

@see Gem::DIRECTORIES

• Gem

Gem.#path -> Array (18304.0)

• 2.5.0

• モジュール関数

Gem を検索するパスの配列を返します。

Gem を検索するパスの配列を返します。

• Gem

絞り込み条件を変える

Gem.#set_home (18304.0)

• 2.5.0

• モジュール関数

Gem のホームディレクトリをセットします。

Gem のホームディレクトリをセットします。

• Gem

Gem.#set_paths (18304.0)

• 2.5.0

• モジュール関数

Gem を検索するパスをセットします。

Gem を検索するパスをセットします。

@see Gem.#path

• Gem

Gem.#win_platform? -> bool (18304.0)

• 2.5.0

• モジュール関数

Windows プラットフォームであれば真を返します。そうでなければ偽を返します。

Windows プラットフォームであれば真を返します。そうでなければ偽を返します。

@see Object::RUBY_PLATFORM

• Gem

JSON.#fast_generate(object) -> String (18304.0)

• 2.5.0

• モジュール関数

与えられたオブジェクトを一行の JSON 形式の文字列に変換して返します。

与えられたオブジェクトを一行の JSON 形式の文字列に変換して返します。

このメソッドは循環参照のチェックを無効にしています。また、
JSON::NaN, JSON::Infinity, JSON::MinusInfinity を生成することがあります。
このため容易に無限ループを発生させることができるので、気をつけてください。

fast_unparse は将来削除される予定です。

@param object JSON 形式の文字列に変換するオブジェクトを指定します。

//emlist[例][ruby]{
require "json"

JSON.fast_generate({ n...

• JSON

JSON.#fast_unparse(object) -> String (18304.0)

• 2.5.0

• モジュール関数

与えられたオブジェクトを一行の JSON 形式の文字列に変換して返します。

与えられたオブジェクトを一行の JSON 形式の文字列に変換して返します。

このメソッドは循環参照のチェックを無効にしています。また、
JSON::NaN, JSON::Infinity, JSON::MinusInfinity を生成することがあります。
このため容易に無限ループを発生させることができるので、気をつけてください。

fast_unparse は将来削除される予定です。

@param object JSON 形式の文字列に変換するオブジェクトを指定します。

//emlist[例][ruby]{
require "json"

JSON.fast_generate({ n...

• JSON

絞り込み条件を変える

Kconv.#isutf8(str) -> bool (18304.0)

• 2.5.0

• モジュール関数

文字列 str が UTF-8 なバイト列として正当であるかどうかを判定します。

文字列 str が UTF-8 なバイト列として正当であるかどうかを判定します。

@param str 判定対象の文字列
@see String#isutf8

• Kconv

Kconv.#toeuc(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを EUC-JP に変換して返します。

文字列 str のエンコーディングを EUC-JP に変換して返します。

Kconv.kconv(str, Kconv::EUC)と同じです。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-exm0', str)
を使ってください。

@param str 変換元の文字列

@see Kconv.#kconv, String#toeuc

• Kconv

Kconv.#tojis(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを iso-2022-jp に変換して返します。

文字列 str のエンコーディングを iso-2022-jp に変換して返します。

Kconv.kconv(str, Kconv::JIS) と同じです。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-jxm0', str)
を使ってください。

@param str 変換元の文字列

@see Kconv.#kconv, String#tojis

• Kconv

Kconv.#tolocale(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングをロケールエンコーディングに変換して返します。

文字列 str のエンコーディングをロケールエンコーディングに変換して返します。

ロケールエンコーディングについては Encoding.locale_charmap を見てください。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 String#encode
を使ってください。

Kconv.kconv(str, Encoding.locale_charmap)と同じです。

@param str 変換元の文字列
@see String#tolocale

• Kconv

Kconv.#tosjis(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを shift_jis に変換して返します。

文字列 str のエンコーディングを shift_jis に変換して返します。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-sxm0', str)
を使ってください。

Kconv.kconv(str, Kconv::SJIS)と同じです。

@param str 変換元の文字列

@see Kconv.#kconv, String#tosjis

• Kconv

絞り込み条件を変える

Kconv.#toutf16(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを UTF-16BE に変換して返します。

文字列 str のエンコーディングを UTF-16BE に変換して返します。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-w16xm0', str)
を使ってください。

Kconv.kconv(str, Kconv::UTF16)と同じです。

@param str 変換元の文字列
@see String#toutf16

• Kconv

Kconv.#toutf32(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを UTF-32 に変換して返します。

文字列 str のエンコーディングを UTF-32 に変換して返します。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-w32xm0', str)
を使ってください。

Kconv.kconv(str, Kconv::UTF32)と同じです。

@param str 変換元の文字列
@see String#toutf32

• Kconv

Kconv.#toutf8(str) -> String (18304.0)

• 2.5.0

• モジュール関数

文字列 str のエンコーディングを UTF-8 に変換して返します。

文字列 str のエンコーディングを UTF-8 に変換して返します。

このメソッドは MIME エンコードされた文字列を展開し、
いわゆる半角カナを全角に変換します。
これらを変換したくない場合は、 NKF.#nkf('-wxm0', str)
を使ってください。

Kconv.kconv(str, Kconv::UTF8)と同じです。

@param str 変換元の文字列
@see String#toutf8

• Kconv

Kernel.#__method__ -> Symbol | nil (18304.0)

• 2.5.0

• モジュール関数

現在のメソッド名を返します。 メソッドの外で呼ばれると nil を返します。

現在のメソッド名を返します。
メソッドの外で呼ばれると nil を返します。

//emlist[例][ruby]{
def foo
p __method__
end
alias :bar :foo
foo #=> :foo
bar #=> :foo
p __method__ #=> nil
//}

現在のメソッド名が alias されたメソッドの場合でも alias 元のメソッド名
を返します。

• Kernel

Kernel.#abort -> () (18304.0)

• 2.5.0

• モジュール関数

Ruby プログラムをエラーメッセージ付きで終了します。終了ステータスは 1 固定です。

Ruby プログラムをエラーメッセージ付きで終了します。終了ステータスは 1 固定です。

このメソッドと Kernel.#exit との違いは、プログラムの終了ステー
タスが 1 (正確にはCレベルの定数 EXIT_FAILURE の値)固定であることと、
エラーメッセージを標準エラー出力 $stderr に出力することです。

引数 message を指定すると SystemExit クラスの
Exception#message に message を設定し
て標準エラー出力に出力します。


@param message エラーメッセージ文字列です。

//emlist[][ruby]...

• Kernel

絞り込み条件を変える

Kernel.#abort(message) -> () (18304.0)

• 2.5.0

• モジュール関数

Ruby プログラムをエラーメッセージ付きで終了します。終了ステータスは 1 固定です。

Ruby プログラムをエラーメッセージ付きで終了します。終了ステータスは 1 固定です。

このメソッドと Kernel.#exit との違いは、プログラムの終了ステー
タスが 1 (正確にはCレベルの定数 EXIT_FAILURE の値)固定であることと、
エラーメッセージを標準エラー出力 $stderr に出力することです。

引数 message を指定すると SystemExit クラスの
Exception#message に message を設定し
て標準エラー出力に出力します。


@param message エラーメッセージ文字列です。

//emlist[][ruby]...

• Kernel

Kernel.#at_exit { ... } -> Proc (18304.0)

• 2.5.0

• モジュール関数

与えられたブロックをインタプリタ終了時に実行します。

与えられたブロックをインタプリタ終了時に実行します。

at_exitがメソッドである点を除けば、END ブロックによる終了
処理の登録と同等です。登録した処理を取り消すことはできません。
spec/terminateも参照してください。

@return 登録した処理を Proc オブジェクトで返します。

//emlist[例][ruby]{
3.times do |i|
at_exit{puts "at_exit#{i}"}
end
END{puts "END"}
at_exit{puts "at_exit"}
puts "main_end"

#=> main_end
# a...

• Kernel
• Proc
• spec/terminate

Kernel.#autoload(const_name, feature) -> nil (18304.0)

• 2.5.0

• モジュール関数

定数 const_name を最初に参照した時に feature を Kernel.#require するように設定します。

定数 const_name を最初に参照した時に feature を
Kernel.#require するように設定します。

const_name には、 "::" 演算子を含めることはできません。
ネストした定数を指定する方法は Module#autoload を参照してください。

const_name が autoload 設定されていて、まだ定義されてない(ロードされていない)ときは、
autoload する対象を置き換えます。
const_name が(autoloadではなく)既に定義されているときは何もしません。

@param const_name 定数をString また...

• Kernel

Kernel.#autoload?(const_name) -> String | nil (18304.0)

• 2.5.0

• モジュール関数

const_name が Kernel.#autoload 設定されているか調べます。

const_name が Kernel.#autoload 設定されているか調べます。

autoload 設定されていて、autoload 定数がまだ定義されてない(ロードされていない)
ときにそのパス名を返します。

autoload 設定されていないか、ロード済みなら nil を返します。

@param const_name 定数をString または Symbol で指定します。

//emlist[例][ruby]{
# ------- /tmp/foo.rb ---------
class Foo
class Bar
end
end
# ----- end of /tm...

• Kernel

Kernel.#catch {|tag| .... } -> object (18304.0)

• 2.5.0

• モジュール関数

Kernel.#throwとの組み合わせで大域脱出を行います。 catch はブロックを実行します。

Kernel.#throwとの組み合わせで大域脱出を行います。 catch はブロックを実行します。

ブロックの実行中に tag と同一のオブジェクトを引数とする Kernel.#throw が行われた
場合は、その throw の第二引数を戻り値として、ブロックの実行を終了します。

主にネストしたループから一気に脱出するのに使用します。

引数を省略した場合、タグとなるオブジェクトが内部で生成され、ブロックパラメータ tag に
渡されます。

@param tag タグとなる任意のオブジェクトです。
@return ブロックの返り値か、対応するthrowの第二引数を返り値として返しま...

• Kernel

絞り込み条件を変える

Kernel.#catch(tag) {|tag| .... } -> object (18304.0)

• 2.5.0

• モジュール関数

Kernel.#throwとの組み合わせで大域脱出を行います。 catch はブロックを実行します。

Kernel.#throwとの組み合わせで大域脱出を行います。 catch はブロックを実行します。

ブロックの実行中に tag と同一のオブジェクトを引数とする Kernel.#throw が行われた
場合は、その throw の第二引数を戻り値として、ブロックの実行を終了します。

主にネストしたループから一気に脱出するのに使用します。

引数を省略した場合、タグとなるオブジェクトが内部で生成され、ブロックパラメータ tag に
渡されます。

@param tag タグとなる任意のオブジェクトです。
@return ブロックの返り値か、対応するthrowの第二引数を返り値として返しま...

• Kernel

Kernel.#exit!(status = false) -> () (18304.0)

• 2.5.0

• モジュール関数

Rubyプログラムの実行を即座に終了します。 status として整数が与えられた場合、その値を Ruby コマンドの終了ステータスとします。 デフォルトの終了ステータスは 1 です。

Rubyプログラムの実行を即座に終了します。
status として整数が与えられた場合、その値を Ruby コマンドの終了ステータスとします。
デフォルトの終了ステータスは 1 です。

status が true の場合 0、 false の場合 1 を引数に指定したとみなされます。この値はCレベルの定数
EXIT_SUCCESS、EXIT_FAILURE の値なので、正確には環境依存です。

exit! は exit とは違って、例外処理などは一切行ないませ
ん。 Kernel.#fork の後、子プロセスを終了させる時などに用
いられます。

@param status 終了ステータス...

• Kernel

Kernel.#exit(status = true) -> () (18304.0)

• 2.5.0

• モジュール関数

Rubyプログラムの実行を終了します。status として整 数が与えられた場合、その値を Ruby コマンドの終了ステータスとします。 デフォルトの終了ステータスは 0(正常終了)です。

Rubyプログラムの実行を終了します。status として整
数が与えられた場合、その値を Ruby コマンドの終了ステータスとします。
デフォルトの終了ステータスは 0(正常終了)です。

status が true の場合 0、 false の場合 1 を引数に指定したとみなされます。この値はCレベルの定数
EXIT_SUCCESS、EXIT_FAILURE の値なので、正確には環境依存です。

exit は例外 SystemExit を発生させ
ることによってプログラムの実行を終了させますので、
必要に応じて begin 節で捕捉することができます。

@param status 終了...

• Kernel
• SystemExit

Kernel.#format(format, *arg) -> String (18304.0)

• 2.5.0

• モジュール関数

format 文字列を C 言語の sprintf と同じように解釈し、 引数をフォーマットした文字列を返します。

format 文字列を C 言語の sprintf と同じように解釈し、
引数をフォーマットした文字列を返します。

@param format フォーマット文字列です。
@param arg フォーマットされる引数です。
@see Kernel.#printf,Time#strftime,Date.strptime

=== sprintf フォーマット

Ruby の sprintf フォーマットは基本的に C 言語の sprintf(3)
のものと同じです。ただし、short や long などの C 特有の型に対する修飾子が
ないこと、2進数の指示子(%b, %B)が存在すること、s...

• Kernel
• String

Kernel.#gets(rs = $/) -> String | nil (18304.0)

• 2.5.0

• モジュール関数

ARGFから一行読み込んで、それを返します。 行の区切りは引数 rs で指定した文字列になります。

ARGFから一行読み込んで、それを返します。
行の区切りは引数 rs で指定した文字列になります。

rs に nil を指定すると行区切りなしとみなしてファイルの内容を
すべて読み込みます。ARGVに複数のファイル名が存在する場合は1度に1ファイルずつ読み込みます。
空文字列 "" を指定すると連続する改行を行の区切りとみなします
(パラグラフモード)。

読み込んだ文字列は組み込み変数 $_ にもセットされます。

@param rs 行の区切りとなる文字列です。
@return ファイルの終り(EOF)に到達した時、 nil を返します。
@raise Errno::EXXX 読み込み...

• ARGF
• Kernel

絞り込み条件を変える

Kernel.#print(*arg) -> nil (18304.0)

• 2.5.0

• モジュール関数

引数を順に標準出力 $stdout に出力します。引数が与えられない時には変数 $_ の値を出力します。

引数を順に標準出力 $stdout に出力します。引数が与えられない時には変数
$_ の値を出力します。

文字列以外のオブジェクトが引数として与えられた場合には、
to_s メソッドにより文字列に変換してから出力します。

変数 $, (出力フィールドセパレータ)に nil で
ない値がセットされている時には、各引数の間にその文字列を出力します。
変数 $\ (出力レコードセパレータ)に nil でな
い値がセットされている時には、最後にそれを出力します。

@param arg 出力するオブジェクトを任意個指定します。
@raise IOError 標準出力が書き込み用にオープンされてい...

• Kernel

Kernel.#printf(format, *arg) -> nil (18304.0)

• 2.5.0

• モジュール関数

C 言語の printf と同じように、format に従い引数を文字列に変 換して port に出力します。

C 言語の printf と同じように、format に従い引数を文字列に変
換して port に出力します。

port を省略した場合は標準出力 $stdout に出力します。

引数を 1 つも指定しなければ何もしません。

Ruby における format 文字列の拡張については
Kernel.#sprintfの項を参照してください。

@param port 出力先になるIO のサブクラスのインスタンスです。
@param format フォーマット文字列です。
@param arg フォーマットされる引数です。
@raise ArgumentError port を指定したのに ...

• IO
• Kernel

Kernel.#printf(port, format, *arg) -> nil (18304.0)

• 2.5.0

• モジュール関数

C 言語の printf と同じように、format に従い引数を文字列に変 換して port に出力します。

C 言語の printf と同じように、format に従い引数を文字列に変
換して port に出力します。

port を省略した場合は標準出力 $stdout に出力します。

引数を 1 つも指定しなければ何もしません。

Ruby における format 文字列の拡張については
Kernel.#sprintfの項を参照してください。

@param port 出力先になるIO のサブクラスのインスタンスです。
@param format フォーマット文字列です。
@param arg フォーマットされる引数です。
@raise ArgumentError port を指定したのに ...

• IO
• Kernel

Kernel.#putc(ch) -> object (18304.0)

• 2.5.0

• モジュール関数

文字 ch を 標準出力 $stdout に出力します。

文字 ch を 標準出力 $stdout に出力します。

ch が数値なら 0 〜 255 の範囲の対応する文字を出力します。
ch が文字列なら、その先頭1文字を出力します。
どちらでもない場合は、ch.to_int で整数に変換を試みます。

@param ch 出力する文字です。数または文字列で指定します。
@return ch を返します
@raise RangeError Bignum を引数にした場合に発生します。
@raise IOError 標準出力が書き込み用にオープンされていなければ発生します。
@raise Errno::EXXX 出力に失敗した場合に発生します。
@...

• Bignum
• Integer
• Kernel

Kernel.#puts(*arg) -> nil (18304.0)

• 2.5.0

• モジュール関数

引数と改行を順番に 標準出力 $stdout に出力します。 引数がなければ改行のみを出力します。

引数と改行を順番に 標準出力 $stdout に出力します。
引数がなければ改行のみを出力します。

引数が配列の場合、その要素と改行を順に出力します。
配列や文字列以外のオブジェクトが引数として与えられた場合には、
当該オブジェクトを最初に to_ary により配列へ、
次に to_s メソッドにより文字列へ変換を試みます。
末尾が改行で終っている引数や配列の要素に対しては puts 自身
は改行を出力しません。

@param arg 出力するオブジェクトを任意個指定します。
@raise IOError 標準出力が書き込み用にオープンされていなければ発生します。
@raise Errn...

• Kernel

絞り込み条件を変える

Kernel.#select(reads, writes = [], excepts = [], timeout = nil) -> [[IO]] | nil (18304.0)

• 2.5.0

• モジュール関数

IO.select と同じです。

IO.select と同じです。

@param reads IO.select 参照
@param writes IO.select 参照
@param excepts IO.select 参照
@param timeout IO.select 参照


@see IO.select

• Kernel

Kernel.#set_trace_func(proc) -> Proc (18304.0)

• 2.5.0

• モジュール関数

Ruby インタプリタのイベントをトレースする Proc オブジェクトとして 指定された proc を登録します。 nil を指定するとトレースがオフになります。

Ruby インタプリタのイベントをトレースする Proc オブジェクトとして
指定された proc を登録します。 nil を指定するとトレースがオフになります。

Ruby インタプリタがプログラムを実行する過程で、メソッドの呼び出しや
式の評価などのイベントが発生する度に、以下で説明する6個の引数とともに
登録された Proc オブジェクトを実行します。

標準添付の debug、tracer、
profile はこの組み込み関数を利用して実現されています。

=== ブロックパラメータの意味

渡す Proc オブジェクトのパラメータは
//emlist[][ruby]{
proc{|...

• Binding
• Kernel
• Proc
• debug
• profile
• tracer

Kernel.#sprintf(format, *arg) -> String (18304.0)

• 2.5.0

• モジュール関数

format 文字列を C 言語の sprintf と同じように解釈し、 引数をフォーマットした文字列を返します。

format 文字列を C 言語の sprintf と同じように解釈し、
引数をフォーマットした文字列を返します。

@param format フォーマット文字列です。
@param arg フォーマットされる引数です。
@see Kernel.#printf,Time#strftime,Date.strptime

=== sprintf フォーマット

Ruby の sprintf フォーマットは基本的に C 言語の sprintf(3)
のものと同じです。ただし、short や long などの C 特有の型に対する修飾子が
ないこと、2進数の指示子(%b, %B)が存在すること、s...

• Kernel
• String

Kernel.#system(command, options={}) -> bool | nil (18304.0)

• 2.5.0

• モジュール関数

引数を外部コマンドとして実行して、成功した時に真を返します。

引数を外部コマンドとして実行して、成功した時に真を返します。

子プロセスが終了ステータス 0 で終了すると成功とみなし true を返します。
それ以外の終了ステータスの場合は false を返します。
コマンドを実行できなかった場合は nil を返します。


終了ステータスは変数 $? で参照できます。

コマンドを実行することができなかった場合、多くのシェルはステータス
127 を返します。シェルを介さない場合は Ruby の子プロセスがステータス
127 で終了します。
コマンドが実行できなかったのか、コマンドが失敗したのかは、普通
$? を参照することで判別可能です。

=== ...

• Kernel

Kernel.#system(env, command, options={}) -> bool | nil (18304.0)

• 2.5.0

• モジュール関数

引数を外部コマンドとして実行して、成功した時に真を返します。

引数を外部コマンドとして実行して、成功した時に真を返します。

子プロセスが終了ステータス 0 で終了すると成功とみなし true を返します。
それ以外の終了ステータスの場合は false を返します。
コマンドを実行できなかった場合は nil を返します。


終了ステータスは変数 $? で参照できます。

コマンドを実行することができなかった場合、多くのシェルはステータス
127 を返します。シェルを介さない場合は Ruby の子プロセスがステータス
127 で終了します。
コマンドが実行できなかったのか、コマンドが失敗したのかは、普通
$? を参照することで判別可能です。

=== ...

• Kernel

絞り込み条件を変える

Kernel.#system(env, program, *args, options={}) -> bool | nil (18304.0)

• 2.5.0

• モジュール関数

引数を外部コマンドとして実行して、成功した時に真を返します。

引数を外部コマンドとして実行して、成功した時に真を返します。

子プロセスが終了ステータス 0 で終了すると成功とみなし true を返します。
それ以外の終了ステータスの場合は false を返します。
コマンドを実行できなかった場合は nil を返します。


終了ステータスは変数 $? で参照できます。

コマンドを実行することができなかった場合、多くのシェルはステータス
127 を返します。シェルを介さない場合は Ruby の子プロセスがステータス
127 で終了します。コマンドが実行できなかったのか、コマンドが失敗したの
かは、普通 $? を参照することで判別可能です。

Hash...

• Kernel

Kernel.#system(program, *args, options={}) -> bool | nil (18304.0)

• 2.5.0

• モジュール関数

引数を外部コマンドとして実行して、成功した時に真を返します。

引数を外部コマンドとして実行して、成功した時に真を返します。

子プロセスが終了ステータス 0 で終了すると成功とみなし true を返します。
それ以外の終了ステータスの場合は false を返します。
コマンドを実行できなかった場合は nil を返します。


終了ステータスは変数 $? で参照できます。

コマンドを実行することができなかった場合、多くのシェルはステータス
127 を返します。シェルを介さない場合は Ruby の子プロセスがステータス
127 で終了します。コマンドが実行できなかったのか、コマンドが失敗したの
かは、普通 $? を参照することで判別可能です。

Hash...

• Kernel

Kernel.#test(cmd, file1, file2) -> bool (18304.0)

• 2.5.0

• モジュール関数

２ファイル間のファイルテストを行います。

２ファイル間のファイルテストを行います。

@param cmd 以下に示す文字リテラル、文字列、あるいは同じ文字を表す数値
です。文字列の場合はその先頭の文字だけをコマンドとみなします。
@param file1 テストするファイルのパスを表す文字列か IO オブジェクトを指定します。
@param file2 テストするファイルのパスを表す文字列か IO オブジェクトを指定します。
@return 真偽値を返します。

以下は cmd として指定できる文字リテラルとその意味です。

: ?=
ファイル1とファイル2の最終更新時刻が等しい
: ?>
フ...

• Kernel

Kernel.#throw(tag, value = nil) -> () (18304.0)

• 2.5.0

• モジュール関数

Kernel.#catchとの組み合わせで大域脱出を行います。 throw は同じ tag を指定した catch のブロックの終わりまでジャンプします。

Kernel.#catchとの組み合わせで大域脱出を行います。 throw
は同じ tag を指定した catch のブロックの終わりまでジャンプします。

throw は探索時に呼び出しスタックをさかのぼるので、
ジャンプ先は同じメソッド内にあるとは限りません。
もし ensure節 が存在するならジャンプ前に実行します。

同じ tag で待っている catch が存在しない場合は、例外で
スレッドが終了します。

同じ tag であるとは Object#object_id が同じであるという意味です。

@param tag catch の引数に対応する任意のオブジェクトです。
@pa...

• Kernel

Kernel.#trace_var(varname) {|new_val| .... } -> nil (18304.0)

• 2.5.0

• モジュール関数

グローバル変数 varname への代入のフックを登録します。

グローバル変数 varname への代入のフックを登録します。

ここでの「グローバル変数」は、特殊変数
(d:spec/variables#builtin を参照)も含めた `$' で始まる変数のこ
とです。

この呼び出し以降、varname で指定したグローバル変数に
値が代入されるたびに hook かブロックが評価されます。hook が Proc オブジェクトの場合
代入された値がブロック引数に渡されます。文字列の場合はRubyコードとして評価されます。

trace_var がフックするのは明示的な代入だけです。
フックは複数登録できます。

フックを解除するには、hook に n...

• Kernel
• Proc
• Symbol

絞り込み条件を変える

Kernel.#trace_var(varname, hook) -> nil (18304.0)

• 2.5.0

• モジュール関数

グローバル変数 varname への代入のフックを登録します。

グローバル変数 varname への代入のフックを登録します。

ここでの「グローバル変数」は、特殊変数
(d:spec/variables#builtin を参照)も含めた `$' で始まる変数のこ
とです。

この呼び出し以降、varname で指定したグローバル変数に
値が代入されるたびに hook かブロックが評価されます。hook が Proc オブジェクトの場合
代入された値がブロック引数に渡されます。文字列の場合はRubyコードとして評価されます。

trace_var がフックするのは明示的な代入だけです。
フックは複数登録できます。

フックを解除するには、hook に n...

• Kernel
• Proc
• Symbol

Math.#atan(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の逆正接関数（arctangent）の値をラジアンで返します。

x の逆正接関数（arctangent）の値をラジアンで返します。

@param x 実数

@return 返される値の範囲は [-π/2, +π/2] です。

@raise TypeError x に数値以外を指定した場合に発生します。

@raise RangeError x に実数以外の数値を指定した場合に発生します。

//emlist[例][ruby]{
Math.atan(0) # => 0.0
//}

@see Math.#atan2, Math.#tan

• Math

Math.#atan2(y, x) -> Float (18304.0)

• 2.5.0

• モジュール関数

y / x の逆正接関数（arctangent）の値をラジアンで返します。

y / x の逆正接関数（arctangent）の値をラジアンで返します。

@param y 実数
@param x 実数

@return 返される値の範囲は [-π, π] です。


//emlist[例][ruby]{
Math.atan2(1,0) #=> 1.5707963267949
Math.atan2(-1,0) #=> -1.5707963267949
//}

@raise TypeError y, x に数値以外を指定した場合に発生します。

@raise RangeError y, x に実数以外の数値を指定した場合に発生します。

@see Math.#...

• Math

Math.#atanh(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の逆双曲線正接関数（area hyperbolic tangent）の値を返します。

x の逆双曲線正接関数（area hyperbolic tangent）の値を返します。

=== 定義

atanh(x) = log((1+x)/(1-x)) / 2 [-1 < x < 1]

@param x -1 < x < 1 の実数

@return 実数

@raise TypeError x に数値以外を指定した場合に発生します。

@raise Math::DomainError x に範囲外の実数を指定した場合に発生します。

@raise RangeError x に実数以外の数値を指定した場合に発生します。

@see Math.#tanh

• Math

Math.#cbrt(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の立方根（cubic root）を返します。

x の立方根（cubic root）を返します。

@param x 実数

@raise TypeError xに数値以外を指定した場合に発生します。

@raise RangeError xに実数以外の数値を指定した場合に発生します。

//emlist[例][ruby]{
-9.upto(9) {|x|
p [x, Math.cbrt(x), Math.cbrt(x)**3]
}
# => [-9, -2.0800838230519, -9.0]
# [-8, -2.0, -8.0]
# [-7, -1.91293118277239, -7.0]
# [-6, -1.8...

• Math

絞り込み条件を変える

Math.#hypot(x, y) -> Float (18304.0)

• 2.5.0

• モジュール関数

sqrt(x*x + y*y) を返します。

sqrt(x*x + y*y) を返します。

この値は x, y を直交する 2 辺とする直角三角形の斜辺（hypotenuse）の長さです。

@param x 実数
@param y 実数

@raise TypeError 引数のどちらかに数値以外を指定した場合に発生します。

@raise RangeError 引数のどちらかに実数以外の数値を指定した場合に発生します。

//emlist[例][ruby]{
Math.hypot(3, 4) #=> 5.0
//}

• Math

Math.#sqrt(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の非負の平方根（principal square root）を返します。

x の非負の平方根（principal square root）を返します。

@param x 0または正の実数

@raise TypeError xに数値以外を指定した場合に発生します。

@raise Math::DomainError x に範囲外の実数を指定した場合に発生します。

@raise RangeError xに実数以外の数値を指定した場合に発生します。

//emlist[例][ruby]{
0.upto(10) {|x|
p [x, Math.sqrt(x), Math.sqrt(x)**2]
}
# => [0, 0.0, 0.0]
# [1, 1.0, ...

• Math

Math.#tan(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の正接関数（tangent）の値を返します。

x の正接関数（tangent）の値を返します。

@param x 実数（ラジアンで与えます）

@return 実数

@raise TypeError x に数値以外を指定した場合に発生します。

@raise RangeError x に実数以外の数値を指定した場合に発生します。

//emlist[例][ruby]{
Math.tan(0) # => 0.0
//}

@see Math.#atan, Math.#atan2

• Math

Math.#tanh(x) -> Float (18304.0)

• 2.5.0

• モジュール関数

x の双曲線正接関数（hyperbolic tangent）の値を返します。

x の双曲線正接関数（hyperbolic tangent）の値を返します。

=== 定義

tanh(x) = sinh(x) / cosh(x)

@param x 実数

@return [-1, 1] の範囲の実数

@raise TypeError x に数値以外を指定した場合に発生します。

@raise RangeError x に実数以外の数値を指定した場合に発生します。

@see Math.#atanh

• Math

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

• 2.5.0

• モジュール関数

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

絞り込み条件を変える

ObjectSpace.#allocation_sourceline(object) -> Integer (18304.0)

• 2.5.0

• モジュール関数

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

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

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

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

ObjectSpace::trace_object_allocations_start
obj = Object.new
puts "line:#{ObjectSpace::allocation_sourceline(obj)}" # => lin...

• ObjectSpace

ObjectSpace.#each_object -> Enumerator (18304.0)

• 2.5.0

• モジュール関数

指定された klass と Object#kind_of? の関係にある全ての オブジェクトに対して繰り返します。引数が省略された時には全てのオブ ジェクトに対して繰り返します。 繰り返した数を返します。

指定された klass と Object#kind_of? の関係にある全ての
オブジェクトに対して繰り返します。引数が省略された時には全てのオブ
ジェクトに対して繰り返します。
繰り返した数を返します。

ブロックが与えられなかった場合は、
Enumerator オブジェクトを返します。

次のクラスのオブジェクトについては繰り返しません

* Fixnum
* Symbol
* TrueClass
* FalseClass
* NilClass

とくに、klass に Fixnum や Symbol などのクラスを指定した場合は、
何も繰り返さないことになります。
なお、Sy...

• Enumerator
• FalseClass
• Fixnum
• NilClass
• ObjectSpace
• Symbol
• TrueClass

ObjectSpace.#each_object {|object| ...} -> Integer (18304.0)

• 2.5.0

• モジュール関数

指定された klass と Object#kind_of? の関係にある全ての オブジェクトに対して繰り返します。引数が省略された時には全てのオブ ジェクトに対して繰り返します。 繰り返した数を返します。

指定された klass と Object#kind_of? の関係にある全ての
オブジェクトに対して繰り返します。引数が省略された時には全てのオブ
ジェクトに対して繰り返します。
繰り返した数を返します。

ブロックが与えられなかった場合は、
Enumerator オブジェクトを返します。

次のクラスのオブジェクトについては繰り返しません

* Fixnum
* Symbol
* TrueClass
* FalseClass
* NilClass

とくに、klass に Fixnum や Symbol などのクラスを指定した場合は、
何も繰り返さないことになります。
なお、Sy...

• Enumerator
• FalseClass
• Fixnum
• NilClass
• ObjectSpace
• Symbol
• TrueClass

ObjectSpace.#each_object(klass) -> Enumerator (18304.0)

• 2.5.0

• モジュール関数

指定された klass と Object#kind_of? の関係にある全ての オブジェクトに対して繰り返します。引数が省略された時には全てのオブ ジェクトに対して繰り返します。 繰り返した数を返します。

指定された klass と Object#kind_of? の関係にある全ての
オブジェクトに対して繰り返します。引数が省略された時には全てのオブ
ジェクトに対して繰り返します。
繰り返した数を返します。

ブロックが与えられなかった場合は、
Enumerator オブジェクトを返します。

次のクラスのオブジェクトについては繰り返しません

* Fixnum
* Symbol
* TrueClass
* FalseClass
* NilClass

とくに、klass に Fixnum や Symbol などのクラスを指定した場合は、
何も繰り返さないことになります。
なお、Sy...

• Enumerator
• FalseClass
• Fixnum
• NilClass
• ObjectSpace
• Symbol
• TrueClass

ObjectSpace.#each_object(klass) {|object| ...} -> Integer (18304.0)

• 2.5.0

• モジュール関数

指定された klass と Object#kind_of? の関係にある全ての オブジェクトに対して繰り返します。引数が省略された時には全てのオブ ジェクトに対して繰り返します。 繰り返した数を返します。

指定された klass と Object#kind_of? の関係にある全ての
オブジェクトに対して繰り返します。引数が省略された時には全てのオブ
ジェクトに対して繰り返します。
繰り返した数を返します。

ブロックが与えられなかった場合は、
Enumerator オブジェクトを返します。

次のクラスのオブジェクトについては繰り返しません

* Fixnum
* Symbol
* TrueClass
* FalseClass
* NilClass

とくに、klass に Fixnum や Symbol などのクラスを指定した場合は、
何も繰り返さないことになります。
なお、Sy...

• Enumerator
• FalseClass
• Fixnum
• NilClass
• ObjectSpace
• Symbol
• TrueClass

絞り込み条件を変える