検索結果

Kernel.#require(feature) -> bool (54379.0)

• 2.2.0

• モジュール関数

Ruby ライブラリ feature をロードします。拡張子補完を行い、 同じファイルの複数回ロードはしません。

Ruby ライブラリ feature をロードします。拡張子補完を行い、
同じファイルの複数回ロードはしません。

feature が絶対パスのときは feature からロードします。
feature が相対パスのときは組み込み変数 $:
に示されるパスを順番に探し、最初に見付かったファイルを
ロードします。このとき、$: の要素文字列の先頭文字が
`~' (チルダ) だと、環境変数 HOME の値に展開されます。
また `~USER' はそのユーザのホームディレクトリに展開されます。

Ruby ライブラリとは Ruby スクリプト (*.rb) か拡張ライブラリ
(*.so,*.o,*...

• Kernel

Kernel.#require_relative(relative_feature) -> bool (18445.0)

• 2.2.0

• モジュール関数

現在のファイルからの相対パスで require します。

現在のファイルからの相対パスで require します。

require File.expand_path(relative_feature, File.dirname(__FILE__))
とほぼ同じです。

Kernel.#eval などで文字列を評価した場合に、そこから
require_relative を呼出すと必ず失敗します。

@param relative_feature ファイル名の文字列です。
@raise LoadError ロードに失敗した場合に発生します。
@see Kernel.#require

=== require と load のスコープ

ローカル変数...

• Kernel

Kernel.#load(file, priv = false) -> true (94.0)

• 2.2.0

• モジュール関数

Ruby プログラム file をロードして実行します。再ロード可能です。

Ruby プログラム file をロードして実行します。再ロード可能です。

file が絶対パスのときは file からロードします。
file が相対パスのときは組み込み変数 $:
に示されるパスとカレントディレクトリを順番に探し、最初に見付かったファイルを
ロードします。このとき、$: の要素文字列の先頭文字が
`~' (チルダ) だと、環境変数 HOME の値に展開されます。
また `~USER' はそのユーザのホームディレクトリに展開されます。

ロードに成功した場合は true を返します。

@param file ファイル名の文字列です。
@param priv 真のとき、ロ...

• Kernel

Readline.#readline(prompt = "", add_hist = false) -> String | nil (94.0)

• 2.2.0

• モジュール関数

prompt を出力し、ユーザからのキー入力を待ちます。 エンターキーの押下などでユーザが文字列を入力し終えると、 入力した文字列を返します。 このとき、add_hist が true であれば、入力した文字列を入力履歴に追加します。 何も入力していない状態で EOF(UNIX では ^D) を入力するなどで、 ユーザからの入力がない場合は nil を返します。

prompt を出力し、ユーザからのキー入力を待ちます。
エンターキーの押下などでユーザが文字列を入力し終えると、
入力した文字列を返します。
このとき、add_hist が true であれば、入力した文字列を入力履歴に追加します。
何も入力していない状態で EOF(UNIX では ^D) を入力するなどで、
ユーザからの入力がない場合は nil を返します。

本メソッドはスレッドに対応しています。
入力待ち状態のときはスレッドコンテキストの切替えが発生します。

入力時には行内編集が可能で、vi モードと Emacs モードが用意されています。
デフォルトは Emacs モードです。
...

• Readline

Timeout.#timeout(sec, exception_class = nil) {|i| ... } -> object (94.0)

• 2.2.0

• モジュール関数

ブロックを sec 秒の期限付きで実行します。 ブロックの実行時間が制限を過ぎたときは例外 Timeout::Error が発生します。

ブロックを sec 秒の期限付きで実行します。
ブロックの実行時間が制限を過ぎたときは例外
Timeout::Error が発生します。

exception_class を指定した場合には Timeout::Error の代わりに
その例外が発生します。
ブロックパラメータ i は sec がはいります。

また sec が 0 もしくは nil のときは制限時間なしで
ブロックを実行します。

@param sec タイムアウトする時間を秒数で指定します.
@param exception_class タイムアウトした時、発生させる例外を指定します.

例 長い計算のタイムアウト
r...

• Timeout
• Timeout::Error
• resolv-replace

絞り込み条件を変える

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

• 2.2.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

Open3.#popen3(*cmd) -> [IO, IO, IO, Thread] (76.0)

• 2.2.0

• モジュール関数

外部プログラム cmd を実行し、そのプロセスの標準入力、標準出力、標準エラー 出力に接続されたパイプと実行したプロセスを待つためのスレッドを 4 要素の 配列で返します。

外部プログラム cmd を実行し、そのプロセスの標準入力、標準出力、標準エラー
出力に接続されたパイプと実行したプロセスを待つためのスレッドを 4 要素の
配列で返します。

require 'open3'
stdin, stdout, stderr, wait_thr = *Open3.popen3("/usr/bin/nroff -man")

@param cmd 実行するコマンドを指定します。

@return ブロックを指定した場合はブロックの最後に評価された値を返します。
ブロックを指定しなかった場合は標準入力、標準出力、標準エラー出
力と...

• Open3

Open3.#popen3(*cmd) {|stdin, stdout, stderr, wait_thr| ... } -> () (76.0)

• 2.2.0

• モジュール関数

外部プログラム cmd を実行し、そのプロセスの標準入力、標準出力、標準エラー 出力に接続されたパイプと実行したプロセスを待つためのスレッドを 4 要素の 配列で返します。

外部プログラム cmd を実行し、そのプロセスの標準入力、標準出力、標準エラー
出力に接続されたパイプと実行したプロセスを待つためのスレッドを 4 要素の
配列で返します。

require 'open3'
stdin, stdout, stderr, wait_thr = *Open3.popen3("/usr/bin/nroff -man")

@param cmd 実行するコマンドを指定します。

@return ブロックを指定した場合はブロックの最後に評価された値を返します。
ブロックを指定しなかった場合は標準入力、標準出力、標準エラー出
力と...

• Open3

Benchmark.#bm(label_width = 0, *labels) {|rep| ... } -> [Benchmark::Tms] (58.0)

• 2.2.0

• モジュール関数

Benchmark.#benchmark メソッドの引数を簡略化したものです。

Benchmark.#benchmark メソッドの引数を簡略化したものです。

Benchmark.#benchmark メソッドと同様に働きます。

@param label_width ラベルの幅を指定します。
@param labels ブロックが Benchmark::Tms オブジェクトの配列を返す場合に指定します。

//emlist[][ruby]{
require 'benchmark'

n = 50000
Benchmark.bm do |x|
x.report { for i in 1..n; a = "1"; end }
x.report { n.t...

• Benchmark
• Benchmark::Tms

LUSolve.#lusolve(a, b, ps, zero = 0.0) -> [BigDecimal] (58.0)

• 2.2.0

• モジュール関数

LU 分解を用いて、連立1次方程式 Ax = b の解 x を求めて返します。

LU 分解を用いて、連立1次方程式 Ax = b の解 x を求めて返します。

@param a 行列を BigDecimal の配列で指定します。
各要素を Row-major order で並べて 1 次元の配列にし、
LUSolve.#ludecomp で変換したものを指定します。

@param b ベクトルを BigDecimal の配列で指定します。

@param ps LUSolve.#ludecomp の返り値を指定します。

@param zero 0.0 を表す値を指定します。

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

• BigDecimal
• LUSolve

絞り込み条件を変える

Etc.#uname -> {Symbol => String} (40.0)

• 2.2.0

• モジュール関数

uname(2) で取得したシステム情報を Hash で返します。

uname(2) で取得したシステム情報を Hash で返します。

@return 少なくとも :sysname, :nodename, :release, :version, :machine の
5 つのキーを持つ Hash を返します。

//emlist[例][ruby]{
require 'etc'
require 'pp'

pp Etc.uname
# => {:sysname=>"Linux",
# :nodename=>"boron",
# :release=>"2.6.18-6-xen-686",
# :version=>"#1 ...

• Etc
• Hash

FileUtils.#chmod(mode, list, options = {}) -> Array (40.0)

• 2.2.0

• モジュール関数

ファイル list のパーミッションを mode に変更します。

ファイル list のパーミッションを mode に変更します。

@param mode パーミッションを8進数(absolute mode)か文字列(symbolic
mode)で指定します。

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

@param options :noop と :verbose が指定可能です。
c:FileUtils#options

@return list を配列として返しま...

• FileUtils

FileUtils.#chown_R(user, group, list, options = {}) -> Array (40.0)

• 2.2.0

• モジュール関数

list 以下のファイルの所有ユーザと所有グループを user と group へ再帰的に変更します。

list 以下のファイルの所有ユーザと所有グループを
user と group へ再帰的に変更します。

user, group に nil または -1 を渡すとその項目は変更しません。

@param user ユーザー名か uid を指定します。nil/-1 を指定すると変更しません。

@param group グループ名か gid を指定します。nil/-1 を指定すると変更しません。

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

@param opti...

• FileUtils

FileUtils.#cp_r(src, dest, options = {}) -> () (40.0)

• 2.2.0

• モジュール関数

src を dest にコピーします。src がディレクトリであったら再帰的に コピーします。その際 dest がディレクトリなら dest/src にコピーします。

src を dest にコピーします。src がディレクトリであったら再帰的に
コピーします。その際 dest がディレクトリなら dest/src にコピーします。

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

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

@param options :preserve, :noop, :verbose, :dereference_root, :remove_destination が指定できます。
c:FileU...

• FileUtils

JSON.#dump(object, io = nil, limit = nil) -> String | IO (40.0)

• 2.2.0

• モジュール関数

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

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

与えられたオブジェクトを引数として JSON.#generate を呼び出します。


@param object ダンプするオブジェクトを指定します。

@param io IO のように write メソッドを実装しているオブジェクトを指定します。

@param limit 指定した場合、limit 段以上深くリンクしたオブジェクトをダンプできません。

@raise ArgumentError オブジェクトのネストの深さが limit を越えた場合に発生します。

//emlist[例][ruby]{
re...

• IO
• JSON
• Marshal

絞り込み条件を変える

Open3.#pipeline(*cmds) -> [Process::Status] (40.0)

• 2.2.0

• モジュール関数

指定したコマンドのリストをパイプで繋いで順番に実行します。

指定したコマンドのリストをパイプで繋いで順番に実行します。

@param cmds 実行するコマンドのリストを指定します。それぞれのコマンドは
以下のように String か Array で指定します。
commandline にはコマンド全体(例. "nroff -man")を表す
String を指定します。
options には Hash で指定します。
env には環境変数を Hash で指定します。
cmdname にはコマンド名を表す ...

• Open3

OpenSSL::ASN1.#decode(der) -> OpenSSL::ASN1::ASN1Data (40.0)

• 2.2.0

• モジュール関数

DER 表現の文字列を解析し、そこにエンコードされている ASN.1 の値を OpenSSL::ASN1::ASN1Data のサブクラスのインスタンスとして返します。

DER 表現の文字列を解析し、そこにエンコードされている ASN.1 の値を
OpenSSL::ASN1::ASN1Data のサブクラスのインスタンスとして返します。

複数の ASN.1 の値が含まれている場合、先頭の値だけを返します。

ASN.1 オブジェクトが Constructive である場合は、
それを構成する要素も再帰的に解析します。

例:

ruby -e '
require "openssl"
require "pp"
pem = File.read(ARGV[0])
cert = OpenSSL::X509::Certificate.new(pem...

• OpenSSL::ASN1
• OpenSSL::ASN1::ASN1Data

Syslog.#open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) -> self (40.0)

• 2.2.0

• モジュール関数

与えられた引数でsyslogを開きます。以降、他の Syslog モジュール関数が使 用可能となります。

与えられた引数でsyslogを開きます。以降、他の Syslog モジュール関数が使
用可能となります。

ブロック付きで呼ばれた場合は、self を引数としてブロックを実行し、
最後に Syslog.#close を行います。

syslog の詳細については syslog(3) を参照してください。

@param ident すべてのログにつく識別子で、どのプログラムから送られ
たログなのかを識別するために使われる文字列を指定します。
指定しない場合はプログラム名が使われます。

@param options Syslog.open ...

• RuntimeError
• Syslog
• Syslog::Constants

Syslog.#open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) { |syslog| ... } -> self (40.0)

• 2.2.0

• モジュール関数

与えられた引数でsyslogを開きます。以降、他の Syslog モジュール関数が使 用可能となります。

与えられた引数でsyslogを開きます。以降、他の Syslog モジュール関数が使
用可能となります。

ブロック付きで呼ばれた場合は、self を引数としてブロックを実行し、
最後に Syslog.#close を行います。

syslog の詳細については syslog(3) を参照してください。

@param ident すべてのログにつく識別子で、どのプログラムから送られ
たログなのかを識別するために使われる文字列を指定します。
指定しない場合はプログラム名が使われます。

@param options Syslog.open ...

• RuntimeError
• Syslog
• Syslog::Constants

Win32::Resolv.#get_resolv_info -> [[String], [String]] (40.0)

• 2.2.0

• モジュール関数

ドメイン名とネームサーバを配列の配列で返します。

ドメイン名とネームサーバを配列の配列で返します。

例:

require "win32/resolv"
p Win32::Resolv.get_resolv_info #=> [["my.example.com"], ["192.168.1.1"]]

設定されていない情報は nil になります。

# ドメイン名が設定されていない場合。
require "win32/resolv"
p Win32::Resolv.get_resolv_info #=> [nil, ["192.168.1.1"]]

• Win32::Resolv

絞り込み条件を変える

Abbrev.#abbrev(words, pattern = nil) -> Hash (22.0)

• 2.2.0

• モジュール関数

文字列の配列から一意に決まる短縮形を計算し、 短縮形をキー、元の文字列を値とするハッシュを返します。

文字列の配列から一意に決まる短縮形を計算し、
短縮形をキー、元の文字列を値とするハッシュを返します。

第二引数に正規表現を指定すると、words のうちそのパターンにマッチしたものから短縮形を計算します。
第二引数に文字列を指定すると、words のうちその文字列で始まるものから短縮形を計算します。

@param words 元となる文字列の配列。
@param pattern Regexp か String を指定します。

@return 短縮形をキー、元の文字列を値とするハッシュを返します。

require 'abbrev'

# words に同じ文字列が含まれ...

• Abbrev
• Regexp
• String

Base64.#decode64(str) -> String (22.0)

• 2.2.0

• モジュール関数

与えられた文字列を Base64 デコードしたデータを返します。

与えられた文字列を Base64 デコードしたデータを返します。

このメソッドは 2045 に対応しています。

@param str Base64 デコードする文字列を指定します。

require 'base64'
str = 'VGhpcyBpcyBsaW5lIG9uZQpUaGlzIG' +
'lzIGxpbmUgdHdvClRoaXMgaXMgbGlu' +
'ZSB0aHJlZQpBbmQgc28gb24uLi4K'
puts Base64.decode64(str)

# This is line one
# T...

• Base64

Base64.#encode64(bin) -> String (22.0)

• 2.2.0

• モジュール関数

与えられたデータを Base64 エンコードした文字列を返します。

与えられたデータを Base64 エンコードした文字列を返します。

このメソッドは 2045 に対応しています。
エンコード後の文字で 60 文字ごとに改行を追加します。

@param bin Base64 エンコードするデータを指定します。


require 'base64'
Base64.encode64("Now is the time for all good coders\nto learn Ruby")

# => Tm93IGlzIHRoZSB0aW1lIGZvciBhbGwgZ29vZCBjb2RlcnMKdG8gbGVhcm4g
# ...

• Base64

Base64.#urlsafe_encode64(bin, padding: true) -> String (22.0)

• 2.2.0

• モジュール関数

与えられたデータを Base64 エンコードした文字列を返します。

与えられたデータを Base64 エンコードした文字列を返します。

このメソッドは 4648 の "Base 64 Encoding with URL and Filename Safe Alphabet" に対応しています。
"+" を "-" に "/" を "_" に置き換えます。

デフォルトでは戻り値は = によるパディングを含むことがあります。
パディングを含めたくない場合は、padding オプションに false を指定してください。

@param bin Base64 エンコードするデータを指定します。
@param padding false を指定した場合、 = によ...

• Base64

Benchmark.#benchmark(caption = "", label_width = nil, fmtstr = nil, *labels) {|rep| ...} -> [Benchmark::Tms] (22.0)

• 2.2.0

• モジュール関数

Benchmark::Report オブジェクトを生成し、それを引数として与えられたブロックを実行します。

Benchmark::Report オブジェクトを生成し、それを引数として与えられたブロックを実行します。

基本的には以下のように使います。
ブロックが Benchmark::Tms オブジェクトの配列を返した場合は、
それらの数値も追加の行に表示されます。

@param caption レポートの一行目に表示する文字列を指定します。
@param label_width ラベルの幅を指定します。
@param fmtstr フォーマット文字列を指定します。
この引数を省略すると Benchmark::FORMAT が使用されます。...

• Benchmark
• Benchmark::Report
• Benchmark::Tms

絞り込み条件を変える

Benchmark.#bmbm(width = 0) {|job| ... } -> [Benchmark::Tms] (22.0)

• 2.2.0

• モジュール関数

Benchmark::Job オブジェクトを生成して、それを引数として与えられたブロックを 実行します。

Benchmark::Job オブジェクトを生成して、それを引数として与えられたブロックを
実行します。

ベンチマークの結果は GC の影響によって歪められてしまうことがあります。
このメソッドは与えられたブロックを二度実行する事によってこの影響を最小化します。
一回目は実行環境を安定化するためにリハーサルとして実行します。二回目は本番として
実行します。

二回目のブロック実行の前に GC.start を実行しますが、この実行時間は計測には
含まれません。しかし、実際にはこのメソッドを使用しても、GC などの影響を分離する
ことは保証されません。

@param width ラベルの幅を...

• Benchmark
• Benchmark::Job

Benchmark.#measure(label = "") { ... } -> Benchmark::Tms (22.0)

• 2.2.0

• モジュール関数

与えられたブロックを実行して、経過した時間を Process.#times で計り、 Benchmark::Tms オブジェクトを生成して返します。

与えられたブロックを実行して、経過した時間を Process.#times で計り、
Benchmark::Tms オブジェクトを生成して返します。

Benchmark::Tms オブジェクトには to_s が定義されているので、
基本的には以下のように使います。

//emlist[][ruby]{
require 'benchmark'

puts Benchmark::CAPTION
puts Benchmark.measure { "a"*1_000_000 }

#=>
#
# user system total real
# 1.1666...

• Benchmark
• Benchmark::Tms

Benchmark.#realtime { ... } -> Float (22.0)

• 2.2.0

• モジュール関数

与えられたブロックを評価して実行時間を計測して返します。 返り値の単位は、秒です。

与えられたブロックを評価して実行時間を計測して返します。
返り値の単位は、秒です。

//emlist[][ruby]{
require 'benchmark'
puts Benchmark.realtime { [0] * (10**8) } # => 1.0929416846483946
//}

• Benchmark

BigMath.#E(prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

自然対数の底 e を prec で指定した精度で計算します。

自然対数の底 e を prec で指定した精度で計算します。

@param prec 計算結果の精度。

@raise ArgumentError prec に 0 以下が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::E(2) #=> 0.27e1
puts BigMath::E(4) #=> 0.2718e1
puts BigMath::E(10) #=> 0.2718281828e1
//}

• BigMath

BigMath.#PI(prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

円周率を prec で指定した精度で計算します。

円周率を prec で指定した精度で計算します。

@param prec 計算結果の精度。

@raise ArgumentError prec に 0 以下が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::PI(2) #=> 0.31415926535897932384671233672993238432e1
puts BigMath::PI(5) #=> 0.31415926535897932384627534923029509162e1
puts BigMath::PI(10) ...

• BigMath

絞り込み条件を変える

BigMath.#atan(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の逆正接関数を prec で指定した精度で計算します。単位はラジアンです。 x に無限大や NaN を指定した場合には NaN を返します。

x の逆正接関数を prec で指定した精度で計算します。単位はラジアンです。
x に無限大や NaN を指定した場合には NaN を返します。

@param x 計算対象の BigDecimal オブジェクト。単位はラジアン。

@param prec 計算結果の精度。

@raise ArgumentError x の絶対値が1以上の場合に発生します。

@raise ArgumentError prec に 0 以下が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::atan(BigD...

• BigMath

BigMath.#cos(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の余弦関数を prec で指定した精度で計算します。単位はラジアンです。x に無限大や NaN を指定した場合には NaN を返します。

x の余弦関数を prec で指定した精度で計算します。単位はラジアンです。x
に無限大や NaN を指定した場合には NaN を返します。

@param x 計算対象の BigDecimal オブジェクト。単位はラジアン。

@param prec 計算結果の精度。

@raise ArgumentError prec に 0 以下が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::cos(BigDecimal('0.5'), 10) #=> 0.877582561890372716116...

• BigMath

BigMath.#exp(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の指数関数を prec で指定した精度で計算します。

x の指数関数を prec で指定した精度で計算します。

x に正の無限大を指定した場合は正の無限大を返します。負の無限大を指定し
た場合には 0 を返します。NaN を指定した場合には NaNを返します。

@param x 計算対象の数値を Integer、BigDecimal、
Float、Rationalオブジェクトのいずれかで指定します。

@param prec 計算結果の精度を指定します。

@raise ArgumentError x に Integer、BigDecimal、
Float、Rational以外のオ...

• BigDecimal
• BigMath
• Integer

BigMath.#log(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の自然対数を prec で指定した精度で計算します。

x の自然対数を prec で指定した精度で計算します。

x に無限大を指定した場合は無限大を返します。NaN を指定した場合には NaN
を返します。

@param x 計算対象の数値を Integer、Float、
Rational、BigDecimal オブジェクトのいずれかで指定
します。

@param prec 計算結果の精度を指定します。

@raise Math::DomainError x に 0 以下の数値か Complex オブジェクト
が指定された場合に発生します。

@rais...

• BigMath
• Complex
• Float
• Integer

BigMath.#sin(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の正弦関数を prec で指定した精度で計算します。単位はラジアンです。x に無限大や NaN を指定した場合には NaN を返します。

x の正弦関数を prec で指定した精度で計算します。単位はラジアンです。x
に無限大や NaN を指定した場合には NaN を返します。

@param x 計算対象の BigDecimal オブジェクト。単位はラジアン。

@param prec 計算結果の精度。

@raise ArgumentError prec に 0 以下が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::sin(BigDecimal('0.5'), 10) #=> 0.479425538604203000273...

• BigMath

絞り込み条件を変える

BigMath.#sqrt(x, prec) -> BigDecimal (22.0)

• 2.2.0

• モジュール関数

x の平方根を prec で指定した精度で計算します。

x の平方根を prec で指定した精度で計算します。

@param x 平方根を求める数。

@param prec 計算結果の精度。

@raise FloatDomainError x に 0 以下、もしくは NaN が指定された場合に発生します。

@raise ArgumentError prec に 0 未満が指定された場合に発生します。

//emlist[][ruby]{
require "bigdecimal/math"

puts BigMath::sqrt(BigDecimal('2'), 10) #=> 0.1414213562373095048666666667e...

• BigMath

CMath.#cbrt!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の立方根を返します。Math.#cbrt のエイリアスです。

実数 x の立方根を返します。Math.#cbrt のエイリアスです。

@param x 実数

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

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

//emlist[例][ruby]{
require "cmath"
CMath.cbrt!(8.0)# => 2.0
CMath.cbrt!(-8.0) # => -2.0
//}

@see Math.#cbrt

• CMath

CMath.#cbrt(z) -> Float | Complex (22.0)

• 2.2.0

• モジュール関数

z の立方根の内、主値を返します。

z の立方根の内、主値を返します。

@param z 数値

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

//emlist[例][ruby]{
require "cmath"
CMath.cbrt(-8)# => (1.0000000000000002+1.7320508075688772i)
//}


@see Complex#**

• CMath

CMath.#cos!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の余弦関数の値を返します。Math.#cos のエイリアス です。

実数 x の余弦関数の値を返します。Math.#cos のエイリアス
です。

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

@return [-1, 1] の実数

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

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

//emlist[例][ruby]{
require "cmath"
CMath.cos!(0 * Math::PI / 4) # => 1.0
CMath.cos!(1 * Math::PI / 4) # => 0.7071067811865476
CMat...

• CMath

CMath.#exp!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の指数関数(Math::E の x 乗)の値を返します。 Math.#exp のエイリアスです。

実数 x の指数関数(Math::E の x 乗)の値を返します。
Math.#exp のエイリアスです。

@param x Math::E を x 乗する数を実数で指定します。

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

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

//emlist[例][ruby]{
require "cmath"
CMath.exp!(0) # => 1
CMath.exp!(0.5) # => Math.sqrt(Math::E)
CMath.exp!(1) # => Math::E
...

• CMath

絞り込み条件を変える

CMath.#exp(z) -> Float | Complex (22.0)

• 2.2.0

• モジュール関数

z の指数関数(Math::E の z 乗)の値を返します。

z の指数関数(Math::E の z 乗)の値を返します。

@param z Math::E を z 乗する数を指定します。

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

//emlist[例][ruby]{
require "cmath"
CMath.exp(Complex(0, 0))# => (1.0+0.0i)
CMath.exp(Complex(0, Math::PI)) # => (-1.0+1.2246063538223773e-16i)
CMath.exp(Complex(0, Math::PI / 2.0)) # => (6.1230...

• CMath

CMath.#log!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の対数を返します。Math.#log のエイリアスです。

実数 x の対数を返します。Math.#log のエイリアスです。

@param x 真数を正の実数で指定します。

@param b 底を指定します。省略した場合は自然対数を計算します。

@raise Math::DomainError x が負の数である場合に発生します。

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

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

//emlist[例][ruby]{
require "cmath"
CMath.log!(Math::E) # => 1.0...

• CMath

CMath.#log!(x, b) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の対数を返します。Math.#log のエイリアスです。

実数 x の対数を返します。Math.#log のエイリアスです。

@param x 真数を正の実数で指定します。

@param b 底を指定します。省略した場合は自然対数を計算します。

@raise Math::DomainError x が負の数である場合に発生します。

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

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

//emlist[例][ruby]{
require "cmath"
CMath.log!(Math::E) # => 1.0...

• CMath

CMath.#log(z) -> Float | Complex (22.0)

• 2.2.0

• モジュール関数

z の対数を返します。

z の対数を返します。

@param z 真数を指定します。

@param b 底を指定します。省略した場合は自然対数を計算します。

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

//emlist[例][ruby]{
require "cmath"
CMath.log(Complex(0, 0)) # => -Infinity+0.0i
CMath.log(0) # => -Infinity
//}

• CMath

CMath.#log(z, b) -> Float | Complex (22.0)

• 2.2.0

• モジュール関数

z の対数を返します。

z の対数を返します。

@param z 真数を指定します。

@param b 底を指定します。省略した場合は自然対数を計算します。

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

//emlist[例][ruby]{
require "cmath"
CMath.log(Complex(0, 0)) # => -Infinity+0.0i
CMath.log(0) # => -Infinity
//}

• CMath

絞り込み条件を変える

CMath.#sin!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の正弦関数の値を返します。Math.#sin のエイリアス です。

実数 x の正弦関数の値を返します。Math.#sin のエイリアス
です。

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

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

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

//emlist[例][ruby]{
require "cmath"
CMath.sin!(0 * Math::PI / 4) # => 0.0
CMath.sin!(1 * Math::PI / 4) # => 0.7071067811865475
CMath.sin!(2 * Math::PI /...

• CMath

CMath.#sqrt!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の平方根を返します。Math.#sqrt のエイリアスです。

実数 x の平方根を返します。Math.#sqrt のエイリアスです。

@param x 正の実数

@raise Math::DomainError x が負の数である場合に発生します。

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

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

//emlist[例][ruby]{
require "cmath"
CMath.sqrt!(4.0) # => 2.0
CMath.sqrt!(9.0) # => 3.0
//}

@see Math.#sqrt

• CMath

CMath.#sqrt(z) -> Float | Complex (22.0)

• 2.2.0

• モジュール関数

z の平方根を返します。

z の平方根を返します。

@param z 数値

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

//emlist[例][ruby]{
require "cmath"
CMath.sqrt(-1) # => (0+1.0i)
CMath.sqrt(1)# => 1.0
CMath.sqrt(Complex(0, 8))# => (2.0+2.0i)
//}

• CMath

CMath.#tan!(x) -> Float (22.0)

• 2.2.0

• モジュール関数

実数 x の正接関数の値を返します。Math.#tan のエイリアス です。

実数 x の正接関数の値を返します。Math.#tan のエイリアス
です。

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

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

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

//emlist[例][ruby]{
require "cmath"
CMath.tan!(0 * Math::PI / 4) # => 0.0
CMath.tan!(1 * Math::PI / 4) # => 1.0
CMath.tan!(4 * Math::PI / 4) # => 0.0
//...

• CMath

Digest.#hexencode(string) -> String (22.0)

• 2.2.0

• モジュール関数

引数である文字列 string を、16進数に変換した文字列を生成して返します。

引数である文字列 string を、16進数に変換した文字列を生成して返します。

@param string 文字列を指定します。

//emlist[][ruby]{
require 'digest'

p Digest.hexencode("") # => ""
p Digest.hexencode("d") # => "64"
p Digest.hexencode("\1\2") # => "0102"
p Digest.hexencode("\xB0") # => "b0"

p digest = Digest::MD5.digest("ruby") # => "...

• Digest

絞り込み条件を変える

ERB::DefMethod.#def_erb_method(methodname, erb) -> nil (22.0)

• 2.2.0

• モジュール関数

self に erb のスクリプトをメソッドとして定義します。

self に erb のスクリプトをメソッドとして定義します。

メソッド名は methodname で指定します。
erb が文字列の時、そのファイルを読み込み ERB で変換したのち、メソッドとして定義します。

@param methodname メソッド名

@param erb ERBインスタンスもしくはERBソースファイル名

例:

require 'erb'
class Writer
extend ERB::DefMethod
def_erb_method('to_html', 'writer.erb')
...
end
...
p...

• ERB::DefMethod

ERB::Util.#h(s) -> String (22.0)

• 2.2.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

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

• 2.2.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

ERB::Util.#u(s) -> String (22.0)

• 2.2.0

• モジュール関数

文字列 s を URLエンコードした文字列を返します。

文字列 s を URLエンコードした文字列を返します。

文字列 s 中に含まれる 2バイト文字や半角スペースについて URL エンコードを行った文字列を返します(CGI.escapeとほぼ同じです)。

@param s URLエンコードを行う文字列

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

puts url_encode("Programming Ruby: The Pragmatic Programmer's Guide")
# Programming%20Ruby%3A%20%20The%20Pragmatic%20P...

• ERB::Util

ERB::Util.#url_encode(s) -> String (22.0)

• 2.2.0

• モジュール関数

文字列 s を URLエンコードした文字列を返します。

文字列 s を URLエンコードした文字列を返します。

文字列 s 中に含まれる 2バイト文字や半角スペースについて URL エンコードを行った文字列を返します(CGI.escapeとほぼ同じです)。

@param s URLエンコードを行う文字列

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

puts url_encode("Programming Ruby: The Pragmatic Programmer's Guide")
# Programming%20Ruby%3A%20%20The%20Pragmatic%20P...

• ERB::Util

絞り込み条件を変える

Etc.#confstr(name) -> String | nil (22.0)

• 2.2.0

• モジュール関数

confstr(3) で取得したシステム設定変数の値を返します。

confstr(3) で取得したシステム設定変数の値を返します。

@param name Etc モジュールの CS_ で始まる定数のいずれかを指定します。

引数 name に対応する設定が行われていない状態の場合は nil を返します。
(confstr(3) が -1 を返し、errno が設定されていない場合)

//emlist[][ruby]{
require "etc"
Etc.confstr(Etc::CS_PATH) # => "/bin:/usr/bin"

# GNU/Linux
Etc.confstr(Etc::CS_GNU_LIBC_VERSION) # => "...

• Etc

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

• 2.2.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.#nprocessors -> Integer (22.0)

• 2.2.0

• モジュール関数

有効な CPU コア数を返します。

有効な CPU コア数を返します。

//emlist[][ruby]{
require 'etc'
p Etc.nprocessors #=> 4
//}

• Etc

Etc.#sysconf(name) -> Integer | nil (22.0)

• 2.2.0

• モジュール関数

sysconf(3) で取得したシステム設定変数の値を返します。

sysconf(3) で取得したシステム設定変数の値を返します。

引数 name が制限に関する設定値であり、設定が制限がない状態の場合は nil
を返します。(sysconf(3) が -1 を返し、errno が設定されていない
場合)

@param name Etc モジュールの SC_ で始まる定数のいずれかを指定します。

//emlist[][ruby]{
require "etc"
Etc.sysconf(Etc::SC_ARG_MAX) # => 2097152

# Number of processors.
# It is not standardized.
Etc....

• Etc

Etc.#sysconfdir -> String | nil (22.0)

• 2.2.0

• モジュール関数

システムの設定ディレクトリを返します。

システムの設定ディレクトリを返します。

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

主に "/etc" を返しますが、Ruby をソースからビルドした場合は異なるディレ
クトリを返す場合があります。例えば、Ruby を /usr/local にインストールし
た場合は、"/usr/local/etc" を返します。
Windows では常にシステムで提供されたディレクトリを返します。

• Etc

絞り込み条件を変える

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

• 2.2.0

• モジュール関数

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

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

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

• Etc

Fiddle.#dlunwrap(addr) -> object (22.0)

• 2.2.0

• モジュール関数

指定されたアドレスの Ruby オブジェクトを返します。

指定されたアドレスの Ruby オブジェクトを返します。

@param addr Fiddle.#dlwrap が返した Ruby オブジェクトのアドレス(整数)を指定します。

例:

require 'fiddle'
s = 'abc'
p addr = Fiddle.dlwrap(s) #=> 136122440
p Fiddle.dlunwrap(addr) #=> "abc"

• Fiddle

Fiddle.#dlwrap(obj) -> Integer (22.0)

• 2.2.0

• モジュール関数

指定されたオブジェクト obj のアドレスを表す整数を返します。

指定されたオブジェクト obj のアドレスを表す整数を返します。

@param obj Ruby のオブジェクトを指定します。

例:

require 'fiddle'
s = 'abc'
p addr = Fiddle.dlwrap(s) #=> 136122440
p Fiddle.dlunwrap(addr) #=> "abc"

• Fiddle

Fiddle.#free(addr) -> nil (22.0)

• 2.2.0

• モジュール関数

指定された addr が指すメモリ領域を開放します。

指定された addr が指すメモリ領域を開放します。

必ず Fiddle.#malloc が返した整数を addr に与えなければいけません。
そうでない場合、ruby インタプリタが異常終了します。

@param addr Fiddle.#malloc で確保されたメモリ領域を指す整数を指定します。

例:
require 'fiddle'
addr = Fiddle.malloc(10)
p addr #=> 136942800
Fiddle.free(addr)

• Fiddle

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

• 2.2.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 (22.0)

• 2.2.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 (22.0)

• 2.2.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.#sticky?(file) -> bool (22.0)

• 2.2.0

• モジュール関数

ファイルの sticky ビット(chmod(2) 参照)が 立っている時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

ファイルの sticky ビット(chmod(2) 参照)が
立っている時に真を返します。そうでない場合、ファイルが存在しない場合、あるいはシステムコールに失敗した場合などには false を返します。

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

//emlist[例][ruby]{
require 'fileutils'
IO.write("testfile", "")
FileUtils.chmod("o+t", "testfile")
FileTest.sticky?("testfile") # => true
FileUtils....

• FileTest

FileUtils.#cd(dir, options = {}) -> nil (22.0)

• 2.2.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#cd(dir, options = {}) {|dir| .... } -> nil (22.0)

• 2.2.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

絞り込み条件を変える

FileUtils.#chdir(dir, options = {}) -> nil (22.0)

• 2.2.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#chdir(dir, options = {}) {|dir| .... } -> nil (22.0)

• 2.2.0

• モジュール関数

プロセスのカレントディレクトリを dir に変更します。

プロセスのカレントディレクトリを dir に変更します。

ブロックとともに呼び出された時はブロック終了後に
元のディレクトリに戻ります。

@param dir ディレクトリを指定します。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.cd('/', verbose: true) # chdir and report it
//}

• FileUtils

FileUtils.#chmod_R(mode, list, options = {}) -> Array (22.0)

• 2.2.0

• モジュール関数

ファイル list のパーミッションを再帰的に mode へ変更します。

ファイル list のパーミッションを再帰的に mode へ変更します。

@param mode パーミッションを8進数(absolute mode)か文字列(symbolic
mode)で指定します(FileUtils.#chmod 参照)。

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

@param options :noop と :verbose が指定可能です。
c:FileUtils#options...

• FileUtils

FileUtils.#chown(user, group, list, options = {}) -> Array (22.0)

• 2.2.0

• モジュール関数

ファイル list の所有ユーザと所有グループを user と group に変更します。

ファイル list の所有ユーザと所有グループを user と group に変更します。

user, group に nil または -1 を渡すとその項目は変更しません。

@param user ユーザー名か uid を指定します。nil/-1 を指定すると変更しません。

@param group グループ名か gid を指定します。nil/-1 を指定すると変更しません。

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

@param options :n...

• FileUtils

FileUtils.#cmp(file_a, file_b) -> bool (22.0)

• 2.2.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.#compare_file(file_a, file_b) -> bool (22.0)

• 2.2.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.#copy(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

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

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

src にファイルが一つだけ与えられた場合、
dest がディレクトリならdest/src にコピーします。
dest が既に存在ししかもディレクトリでないときは上書きします。

src にファイルが複数与えられた場合、
file1 を dest/file1 にコピー、file2 を dest/file2 にコピー、
というように、ディレクトリ dest の中にファイル file1、file2、 …を
同じ名前でコピーします。dest がディレクトリでない場合は例外
Errno::ENOTDIR が発生します。

@param src コピ...

• Errno::ENOTDIR
• FileUtils

FileUtils.#cp(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

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

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

src にファイルが一つだけ与えられた場合、
dest がディレクトリならdest/src にコピーします。
dest が既に存在ししかもディレクトリでないときは上書きします。

src にファイルが複数与えられた場合、
file1 を dest/file1 にコピー、file2 を dest/file2 にコピー、
というように、ディレクトリ dest の中にファイル file1、file2、 …を
同じ名前でコピーします。dest がディレクトリでない場合は例外
Errno::ENOTDIR が発生します。

@param src コピ...

• Errno::ENOTDIR
• FileUtils

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

• 2.2.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 = {}) -> () (22.0)

• 2.2.0

• モジュール関数

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

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

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

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

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.install('ruby...

• FileUtils

絞り込み条件を変える

FileUtils.#link(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

src へのハードリンク dest を作成します。

src へのハードリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのハードリンク dest/src[0]、src[1] への
ハードリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param...

• FileUtils

FileUtils.#ln(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

src へのハードリンク dest を作成します。

src へのハードリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのハードリンク dest/src[0]、src[1] への
ハードリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param...

• FileUtils

FileUtils.#ln_s(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

src へのシンボリックリンク dest を作成します。

src へのシンボリックリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのシンボリックリンク dest/src[0]、src[1] への
シンボリックリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します...

• FileUtils

FileUtils.#makedirs(list, options = {}) -> Array (22.0)

• 2.2.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.#mkdir(dir, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

ディレクトリ dir を作成します。

ディレクトリ dir を作成します。

@param dir 作成するディレクトリ。

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


//emlist[][ruby]{
require 'fileutils'
FileUtils.mkdir('test')
FileUtils.mkdir(%w( tmp data ))
FileUtils.mkdir('notexist', noop: true) # does not create really
//}

• FileUtils

絞り込み条件を変える

FileUtils.#mkdir_p(list, options = {}) -> Array (22.0)

• 2.2.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.#mkpath(list, options = {}) -> Array (22.0)

• 2.2.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.#move(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

ファイル src を dest に移動します。

ファイル src を dest に移動します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは src を dest/src へ移動します。
dest がすでに存在しディレクトリでないときは src は dest を上書きします。

src が複数の場合、
src[0] を dest/src[0]、src[1] を dest/src[1] へ移動します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param src 元のファイル。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列...

• FileUtils

FileUtils.#mv(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

ファイル src を dest に移動します。

ファイル src を dest に移動します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは src を dest/src へ移動します。
dest がすでに存在しディレクトリでないときは src は dest を上書きします。

src が複数の場合、
src[0] を dest/src[0]、src[1] を dest/src[1] へ移動します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します。

@param src 元のファイル。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列...

• FileUtils

FileUtils.#remove(list, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

list で指定された対象を消去します。

list で指定された対象を消去します。

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

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.rm('junk.txt')
FileUtils.rm(Dir.glob('*~'))
FileUtils.rm('NotExistFile', f...

• FileUtils

絞り込み条件を変える

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

• 2.2.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.#rm(list, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

list で指定された対象を消去します。

list で指定された対象を消去します。

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

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.rm('junk.txt')
FileUtils.rm(Dir.glob('*~'))
FileUtils.rm('NotExistFile', f...

• FileUtils

FileUtils.#rm_r(list, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

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

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

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

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

=== 注意

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

• FileUtils

FileUtils.#rmdir(dir, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

ディレクトリ dir を削除します。

ディレクトリ dir を削除します。

ディレクトリにファイルが残っていた場合は削除に失敗します。

@param dir 削除するディレクトリを指定します。一つの場合は文字列でも指定可能です。
二つ以上指定する場合は配列で指定します。

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

//emlist[][ruby]{
require 'fileutils'
FileUtils.rmdir('somedir')
FileUtils.rmdir(%...

• FileUtils

FileUtils.#symlink(src, dest, options = {}) -> () (22.0)

• 2.2.0

• モジュール関数

src へのシンボリックリンク dest を作成します。

src へのシンボリックリンク dest を作成します。

src が一つの場合、
dest がすでに存在しディレクトリであるときは dest/src を作成します。
dest がすでに存在しディレクトリでないならば例外 Errno::EEXIST が発生します。
ただし :force オプションを指定したときは dest を上書きします。

src が複数の場合、
src[0] へのシンボリックリンク dest/src[0]、src[1] への
シンボリックリンク dest/src[1] …を作成します。
dest がディレクトリでない場合は例外 Errno::ENOTDIR が発生します...

• FileUtils

絞り込み条件を変える

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

• 2.2.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 (22.0)

• 2.2.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

Find.#find(*dirs, ignore_error: true) -> Enumerator (22.0)

• 2.2.0

• モジュール関数

find(1) のように dir 配下のすべてのファイルや ディレクトリを一つずつ引数 file に渡してブロックを実行します。

find(1) のように dir 配下のすべてのファイルや
ディレクトリを一つずつ引数 file に渡してブロックを実行します。

ディレクトリのシンボリックリンクは辿りません。
また file に渡される順序は不定です。

ブロックを省略した場合は Enumerator を返します。

@param dirs 探索するディレクトリを一つ以上指定します。

@param ignore_error 探索中に発生した例外を無視するかどうかを指定します。

例:

require 'find'

Find.find('/tmp') {|f|
Find.prune if f ==...

• Enumerator
• Find

Find.#find(*dirs, ignore_error: true) {|file| ... } -> nil (22.0)

• 2.2.0

• モジュール関数

find(1) のように dir 配下のすべてのファイルや ディレクトリを一つずつ引数 file に渡してブロックを実行します。

find(1) のように dir 配下のすべてのファイルや
ディレクトリを一つずつ引数 file に渡してブロックを実行します。

ディレクトリのシンボリックリンクは辿りません。
また file に渡される順序は不定です。

ブロックを省略した場合は Enumerator を返します。

@param dirs 探索するディレクトリを一つ以上指定します。

@param ignore_error 探索中に発生した例外を無視するかどうかを指定します。

例:

require 'find'

Find.find('/tmp') {|f|
Find.prune if f ==...

• Enumerator
• Find

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

• 2.2.0

• モジュール関数

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

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

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

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

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

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

JSON.fast_generate({ n...

• JSON

絞り込み条件を変える