検索結果

ENV.reject {|key, value| ... } -> Hash (18304.0)

• 3.2

• 特異メソッド

環境変数のうち、ブロックを評価した値が真であるものをとり除きます。 Enumerable#reject と異なり Hash を返します。また、とり除いた結果 は実際の環境変数に影響を与えません。

環境変数のうち、ブロックを評価した値が真であるものをとり除きます。
Enumerable#reject と異なり Hash を返します。また、とり除いた結果
は実際の環境変数に影響を与えません。

//emlist[][ruby]{
ENV['TEST'] = 'foo'
result = ENV.reject { |key, value| key == 'TEST' }
result['TEST'] # => nil
ENV['TEST'] # => "foo"
//}

• ENV

ENV.reject! -> Enumerator (18304.0)

• 3.2

• 特異メソッド

key と value を引数としてブロックを評価した値が真であ る時、環境変数を削除します。

key と value を引数としてブロックを評価した値が真であ
る時、環境変数を削除します。

reject! は要素に変化がなければ nil を返します。

//emlist[][ruby]{
ENV['FOO'] = 'bar'
ENV.delete_if { |key, value| key == 'FOO' && value == 'bar' } # => ENV
ENV.reject! { |key, value| key == 'FOO' && value == 'bar' } # => nil
//}

• ENV

ENV.reject! {|key, value| ... } -> ENV | nil (18304.0)

• 3.2

• 特異メソッド

key と value を引数としてブロックを評価した値が真であ る時、環境変数を削除します。

key と value を引数としてブロックを評価した値が真であ
る時、環境変数を削除します。

reject! は要素に変化がなければ nil を返します。

//emlist[][ruby]{
ENV['FOO'] = 'bar'
ENV.delete_if { |key, value| key == 'FOO' && value == 'bar' } # => ENV
ENV.reject! { |key, value| key == 'FOO' && value == 'bar' } # => nil
//}

• ENV

ENV.select -> Enumerator (18304.0)

• 3.2

• 特異メソッド

環境変数名と値についてブロックを評価し、真を返したものを集めたハッシュ を返します。

環境変数名と値についてブロックを評価し、真を返したものを集めたハッシュ
を返します。

• ENV

ENV.select {|key, value| ... } -> Hash (18304.0)

• 3.2

• 特異メソッド

環境変数名と値についてブロックを評価し、真を返したものを集めたハッシュ を返します。

環境変数名と値についてブロックを評価し、真を返したものを集めたハッシュ
を返します。

• ENV

絞り込み条件を変える

ENV.select! -> Enumerator (18304.0)

• 3.2

• 特異メソッド

キーと値を引数としてブロックを評価した結果が真であ るような要素を環境変数に残します。

キーと値を引数としてブロックを評価した結果が真であ
るような要素を環境変数に残します。

keep_if は常に self を返します。
select! と filter! はオブジェクトが変更された場合に self を、
されていない場合に nil を返します。

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

@see ENV.delete_if,ENV.reject!, Hash#keep_if, Hash#select!,

• ENV
• Enumerator

ENV.select! {|key, value| ... } -> ENV | nil (18304.0)

• 3.2

• 特異メソッド

キーと値を引数としてブロックを評価した結果が真であ るような要素を環境変数に残します。

キーと値を引数としてブロックを評価した結果が真であ
るような要素を環境変数に残します。

keep_if は常に self を返します。
select! と filter! はオブジェクトが変更された場合に self を、
されていない場合に nil を返します。

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

@see ENV.delete_if,ENV.reject!, Hash#keep_if, Hash#select!,

• ENV
• Enumerator

ENV.shift -> [String, String] | nil (18304.0)

• 3.2

• 特異メソッド

環境変数を一つ取り除いて、それを名前と値の組の配列で返します。 環境変数が一つも設定されていなければ nil を返します。

環境変数を一つ取り除いて、それを名前と値の組の配列で返します。
環境変数が一つも設定されていなければ nil を返します。

• ENV

ENV.to_a -> [[String, String]] (18304.0)

• 3.2

• 特異メソッド

環境変数から [変数名, 値] となる 2 要素の配列の配列を生成します。

環境変数から [変数名, 値] となる 2 要素の配列の配列を生成します。

• ENV

ENV.to_h -> Hash (18304.0)

• 3.2

• 特異メソッド

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

ブロックを指定すると各ペアでブロックを呼び出し、
その結果をペアとして使います。
//emlist[ブロック付きの例][ruby]{
ENV.to_h {|name, value| [name, value.size] }
//}

• ENV

絞り込み条件を変える

ENV.to_h {|name, value| block } -> Hash (18304.0)

• 3.2

• 特異メソッド

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

ブロックを指定すると各ペアでブロックを呼び出し、
その結果をペアとして使います。
//emlist[ブロック付きの例][ruby]{
ENV.to_h {|name, value| [name, value.size] }
//}

• ENV

ENV.to_hash -> Hash (18304.0)

• 3.2

• 特異メソッド

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

環境変数の名前をキーとし、対応する値をもつハッシュを返します。

• ENV

ENV.to_s -> String (18304.0)

• 3.2

• 特異メソッド

環境変数を文字列化します。 Hash#to_s と同じように動作します。

環境変数を文字列化します。 Hash#to_s と同じように動作します。

• ENV

ENV.values_at(*key) -> [String] (18304.0)

• 3.2

• 特異メソッド

引数で指定されたキー(環境変数名)に対応する値の配列を返します。存在 しないキーに対しては nil が対応します。

引数で指定されたキー(環境変数名)に対応する値の配列を返します。存在
しないキーに対しては nil が対応します。

例:

ENV.update({'FOO' => 'foo', 'BAR' => 'bar'})
p ENV.values_at(*%w(FOO BAR BAZ)) # => ["foo", "bar", nil]

@param key 環境変数名を指定します。文字列で指定します。
文字列以外のオブジェクトを指定した場合は to_str メソッドによる暗黙の型変換を試みます。

• ENV

Encoding.compatible?(obj1, obj2) -> Encoding | nil (18304.0)

• 3.2

• 特異メソッド

2つのオブジェクトのエンコーディングに関する互換性をチェックします。 互換性がある場合はそのエンコーディングを、 ない場合は nil を返します。

2つのオブジェクトのエンコーディングに関する互換性をチェックします。
互換性がある場合はそのエンコーディングを、
ない場合は nil を返します。

引数が両方とも文字列である場合、互換性があるならば
その文字列を結合できます。この場合返り値のエンコーディングは
結合した文字列が取るであろう Encoding オブジェクトを返します。

//emlist[例][ruby]{
Encoding.compatible?("\xa1".force_encoding("iso-8859-1"), "b")
#=> #<Encoding:ISO-8859-1>

Encoding.compatible?...

• Encoding

絞り込み条件を変える

Encoding.default_external -> Encoding (18304.0)

• 3.2

• 特異メソッド

既定の外部エンコーディングを返します。

既定の外部エンコーディングを返します。

標準入出力、コマンドライン引数、open で開くファイルなどで、外部エンコーディングが指定されていない場合の既定値として利用されます。

Rubyはロケールまたは -E オプションに従って default_external を決定します。ロケールの確認・設定方法については各システムのマニュアルを参照してください。

-E オプションを指定していない場合は、WindowsではUTF-8、その他のOSではロケールに従って default_external を決定します。

default_external は必ず設定されます。Encoding.locale...

• Encoding
• spec/rubycmd

Encoding.default_external=(encoding) (18304.0)

• 3.2

• 特異メソッド

既定の外部エンコーディングを設定します。

既定の外部エンコーディングを設定します。

default_external を変更する前に作成した文字列と、default_external を変更した後に作成した文字列とではエンコーディングが異なる可能性があるため、Ruby スクリプト内で Encoding.default_external を設定してはいけません。代わりに、ruby -E を使用して、正しい default_external で Ruby を起動してください。

デフォルトの外部エンコーディングがどのように使われるかについては Encoding.default_external を参照してください。

@see spec...

• Encoding
• spec/rubycmd

Encoding.default_internal -> Encoding | nil (18304.0)

• 3.2

• 特異メソッド

既定の内部エンコーディングを返します。デフォルトでは nil です。

既定の内部エンコーディングを返します。デフォルトでは nil です。

標準入出力、コマンドライン引数、open で開くファイルなどで、内部エンコーディングが指定されていない場合の既定値として利用されます。

String#encode と String#encode! は、引数に Encoding が与えられていない場合、 default_internal を使用します。

文字列リテラルを作成した場合、エンコーディングには default_internal ではなく __ENCODING__ 特殊変数で参照できるスクリプトエンコーディングが使用されます。

default_internal...

• Encoding
• spec/rubycmd

Encoding.default_internal=(encoding) (18304.0)

• 3.2

• 特異メソッド

既定の内部エンコーディングを設定します。

既定の内部エンコーディングを設定します。

default_internal を変更する前に作成した文字列と、default_internal を変更した後に作成した文字列とではエンコーディングが異なる可能性があるため、Ruby スクリプト内で Encoding.default_internal を設定してはいけません。代わりに、ruby -E を使用して、正しい default_internal で Ruby を起動してください。

デフォルトの内部エンコーディングがどのように使われるかについては Encoding.default_internal を参照してください。

@see spe...

• Encoding
• spec/rubycmd

Encoding.list -> [Encoding] (18304.0)

• 3.2

• 特異メソッド

現在ロードされているエンコーディングのリストを返します。

現在ロードされているエンコーディングのリストを返します。

//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

絞り込み条件を変える

Encoding.name_list -> [String] (18304.0)

• 3.2

• 特異メソッド

利用可能なエンコーディングの名前を文字列の配列で返します。

利用可能なエンコーディングの名前を文字列の配列で返します。

//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

Encoding::Converter.asciicompat_encoding(encoding) -> Encoding | nil (18304.0)

• 3.2

• 特異メソッド

同じ文字集合を持つ ASCII 互換エンコーディングを返します。

同じ文字集合を持つ ASCII 互換エンコーディングを返します。

@param string エンコーディング名
@param encoding エンコーディングオブジェクト
@return ASCII 互換エンコーディングのオブジェクトか nil

引数とエンコーディングと同じ文字集合を持つ ASCII 互換エンコーディングを返します。引数と戻り値、2 つのエンコーディング間では変換しても未定義文字の例外は発生しません。
引数が ASCII 互換エンコーディングである場合や、エンコーディングでない場合は nil を返します。

//emlist[][ruby]{
Encoding::Con...

• Encoding::Converter

Encoding::Converter.asciicompat_encoding(string) -> Encoding | nil (18304.0)

• 3.2

• 特異メソッド

同じ文字集合を持つ ASCII 互換エンコーディングを返します。

同じ文字集合を持つ ASCII 互換エンコーディングを返します。

@param string エンコーディング名
@param encoding エンコーディングオブジェクト
@return ASCII 互換エンコーディングのオブジェクトか nil

引数とエンコーディングと同じ文字集合を持つ ASCII 互換エンコーディングを返します。引数と戻り値、2 つのエンコーディング間では変換しても未定義文字の例外は発生しません。
引数が ASCII 互換エンコーディングである場合や、エンコーディングでない場合は nil を返します。

//emlist[][ruby]{
Encoding::Con...

• Encoding::Converter

Encoding::Converter.search_convpath(source_encoding, destination_encoding, options) -> Array (18304.0)

• 3.2

• 特異メソッド

引数で指定した文字エンコーディングの変換の経路を配列にして返します。

引数で指定した文字エンコーディングの変換の経路を配列にして返します。

@param source_encoding 変換元の文字エンコーディングを Encoding オ
ブジェクトか文字列で指定します。

@param destination_encoding 変換先の文字エンコーディングを
Encoding オブジェクトか文字列で指定し
ます。

@param options 変換の詳細を指定する定数やハッシュを指定します。
...

• Encoding
• Encoding::Converter

Exception.json_create(hash) -> Exception (18304.0)

• 3.2

• 特異メソッド

JSON のオブジェクトから Ruby のオブジェクトを生成して返します。

JSON のオブジェクトから Ruby のオブジェクトを生成して返します。

@param hash 適切なキーを持つハッシュを指定します。

• Exception

絞り込み条件を変える

Exception.new(error_message = nil) -> Exception (18304.0)

• 3.2

• 特異メソッド

例外オブジェクトを生成して返します。

例外オブジェクトを生成して返します。

@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

Exception.to_tty? -> bool (18304.0)

• 3.2

• 特異メソッド

$stderr が変更されておらず、$stderr.tty? が真の場合は true を返します。

$stderr が変更されておらず、$stderr.tty? が真の場合は true を返します。


@see Exception#full_message

• Exception

Fiber.current -> Fiber (18304.0)

• 3.2

• 特異メソッド

このメソッドが評価されたコンテキストにおける Fiber のインスタンスを返します。

このメソッドが評価されたコンテキストにおける Fiber のインスタンスを返します。

//emlist[例:][ruby]{
fr = Fiber.new do
Fiber.current
end

fb = fr.resume
p fb.equal?(fr) # => true

p Fiber.current # => #<Fiber:0x91345e4>
p Fiber.current # => #<Fiber:0x91345e4>
//}

• Fiber

Fiddle.last_error -> Integer (18304.0)

• 3.2

• 特異メソッド

最後に Fiddle::Function#call で C の関数を呼び出した 結果設定された errno を返します。

最後に Fiddle::Function#call で C の関数を呼び出した
結果設定された errno を返します。

この値はスレッドローカルです。

• Fiddle

Fiddle.last_error=(errno) (18304.0)

• 3.2

• 特異メソッド

Fiddle.last_error で返される値を設定します。

Fiddle.last_error で返される値を設定します。

errno は fiddle が設定するのでユーザはこのメソッドを使わないでください。

@param errno 設定する errno

• Fiddle

絞り込み条件を変える

Fiddle.win32_last_error -> Integer (18304.0)

• 3.2

• 特異メソッド

最後に Fiddle::Function#call で C の関数を呼び出した 結果設定された errno を返します。

最後に Fiddle::Function#call で C の関数を呼び出した
結果設定された errno を返します。

このメソッドは Windows 環境でのみ定義されています。

この値はスレッドローカルです。

• Fiddle

Fiddle.win32_last_error=(errno) (18304.0)

• 3.2

• 特異メソッド

Fiddle.win32_last_error で返される値を設定します。

Fiddle.win32_last_error で返される値を設定します。

errno は fiddle が設定するのでユーザはこのメソッドを使わないでください。

このメソッドは Windows 環境でのみ定義されています。

@param errno 設定する errno

• Fiddle

Fiddle::Pointer.to_ptr(val) -> Fiddle::Pointer (18304.0)

• 3.2

• 特異メソッド

与えられた val と関連した Pointer オブジェクトを生成して返します。

与えられた val と関連した Pointer オブジェクトを生成して返します。

val が文字列の場合は文字列が格納されているメモリ領域を指す Pointer
オブジェクトを返します。

IO オブジェクトの場合は FILE ポインタを表す Pointer オブジェクトを返します。

val に to_ptr メソッドが定義されている場合は、val.to_ptr を呼び、
Pointer オブジェクトに変換したものを返します。

val が整数の場合はそれをアドレスとする Pointer オブジェクトを返します。

上以外の場合は、整数に変換(to_int)し
それをアドレスとする P...

• Fiddle::Pointer

File.absolute_path(file_name, dir_string=nil) -> String (18304.0)

• 3.2

• 特異メソッド

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

File.absolute_path?(file_name) -> bool (18304.0)

• 3.2

• 特異メソッド

file_name が絶対パスなら true を、そうでなければ false を返します。

file_name が絶対パスなら true を、そうでなければ false を返します。

@param file_name ファイル名を表す文字列を指定します。文字列でない場合は、to_path メソッド、to_str メソッドの順で暗黙の型変換が試みられます。

@raise TypeError 引数に文字列以外の（暗黙の型変換が行えない）オブジェクトを指定した場合に発生します。

//emlist[例][ruby]{
File.absolute_path?("//foo/bar\\baz") # => true
File.absolute_path?("C:foo\\bar") ...

• File

絞り込み条件を変える

File.birthtime(filename) -> Time (18304.0)

• 3.2

• 特異メソッド

作成された時刻を返します。

作成された時刻を返します。

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

@raise Errno::EXXX ファイルの時刻の取得に失敗した場合に発生します。

@raise NotImplementedError Windows のような birthtime のない環境で発生します。

//emlist[例][ruby]{
File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003
//}

• File

File.directory?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#directory? と同じです。

FileTest.#directory? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.empty?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#zero? と同じです。

FileTest.#zero? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.executable?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#executable? と同じです。

FileTest.#executable? と同じです。

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

• File

File.executable_real?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#executable_real? と同じです。

FileTest.#executable_real? と同じです。

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

• File

絞り込み条件を変える

File.exist?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#exist? と同じです。

FileTest.#exist? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.extname(filename) -> String (18304.0)

• 3.2

• 特異メソッド

ファイル名 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.fnmatch(pattern, path, flags = 0) -> bool (18304.0)

• 3.2

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

File.fnmatch?(pattern, path, flags = 0) -> bool (18304.0)

• 3.2

• 特異メソッド

ファイル名のパターンマッチ fnmatch(3) を行います。 path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

ファイル名のパターンマッチ fnmatch(3) を行います。
path が pattern にマッチすれば真を返します。そうでない場合には false を返します。

@param pattern パターンを文字列で指定します。ワイルドカードとして `*',
`**`, `?', `[]', `{}' が使用できます。
//emlist[例][ruby]{
%w(foo foobar bar).each {|f|
p File.fnmatch("foo*", f)
}
# => true
# true
# false
//}

@param p...

• File
• File::Constants

File.ftype(filename) -> String (18304.0)

• 3.2

• 特異メソッド

ファイルのタイプを表す文字列を返します。

ファイルのタイプを表す文字列を返します。

文字列は以下のうちのいずれかです。File.lstat(filename).ftype と同じです。
シンボリックリンクに対して "link" を返します。

* "file"
* "directory"
* "characterSpecial"
* "blockSpecial"
* "fifo"
* "link"
* "socket"
* "unknown"

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

@raise Errno::EXXX 情報の取得に失敗した場合に発生します。

//emlist[...

• File

絞り込み条件を変える

File.identical?(filename1, filename2) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#identical? と同じです。

FileTest.#identical? と同じです。

@param filename1 パスを表す文字列か IO オブジェクトを指定します。

@param filename2 パスを表す文字列か IO オブジェクトを指定します。

• File

File.path(filename) -> String (18304.0)

• 3.2

• 特異メソッド

指定されたファイル名を文字列で返します。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

File.setgid?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#setgid? と同じです。

FileTest.#setgid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.setuid?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#setuid? と同じです。

FileTest.#setuid? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.socket?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#socket? と同じです。

FileTest.#socket? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

絞り込み条件を変える

File.split(pathname) -> [String] (18304.0)

• 3.2

• 特異メソッド

pathname を dirname とbasename に分割して、2 要 素の配列を返します。

pathname を dirname とbasename に分割して、2 要
素の配列を返します。

//emlist[][ruby]{
[File.dirname(pathname), File.basename(pathname)]
//}

と同じです。

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

• File

File.sticky?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#sticky? と同じです。

FileTest.#sticky? と同じです。

@param path パスを表す文字列か IO オブジェクトを指定します。

• File

File.truncate(path, length) -> 0 (18304.0)

• 3.2

• 特異メソッド

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

• Errno::EXXX
• File

File.world_writable?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

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

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

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

@param path パスを表す文字列か IO オブジェクトを指定します。

//emlist[例][ruby]{
m = File.world_writable?("/tmp")
"%o" % m #=> "777"
//}

• File

File.writable?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#writable? と同じです。

FileTest.#writable? と同じです。

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

• File

絞り込み条件を変える

File.writable_real?(path) -> bool (18304.0)

• 3.2

• 特異メソッド

FileTest.#writable_real? と同じです。

FileTest.#writable_real? と同じです。

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

• File

FileUtils.collect_method(opt) -> Array (18304.0)

• 3.2

• 特異メソッド

与えられたオプションを持つメソッド名の配列を返します。

与えられたオプションを持つメソッド名の配列を返します。

@param opt オプション名をシンボルで指定します。

//emlist[][ruby]{
require 'fileutils'
FileUtils.collect_method(:preserve) # => ["cp", "cp_r", "copy", "install"]
//}

• FileUtils

GC.auto_compact -> bool (18304.0)

• 3.2

• 特異メソッド

auto compaction が有効化どうかを返します。

auto compaction が有効化どうかを返します。

@return auto compaction が有効な場合 true を返します。
そうでなければ false を返します。

@see GC.auto_compact=

• GC

GC.auto_compact=(bool) (18304.0)

• 3.2

• 特異メソッド

GC.compact をフルGCで行うかどうかを制御します。

GC.compact をフルGCで行うかどうかを制御します。

true を設定するとフルGCのタイミングででヒープをコンパクションします。

この機能を有効にするとフルGCのパフォーマンスが低下します。

デフォルトは false です。

詳細は17176を参照してください。

@param bool フルGCでコンパクションするかどうかを true か false で設定します。

@see GC.compact GC.auto_compact

• GC

GC.compact -> Hash (18304.0)

• 3.2

• 特異メソッド

ヒープをコンパクションします。

ヒープをコンパクションします。

詳細は15626を参照してください。

@see GC.verify_compaction_references

• GC

絞り込み条件を変える

GC.count -> Integer (18304.0)

• 3.2

• 特異メソッド

プロセス開始からガーベージコレクトを実行した回数を Integer で返し ます。

プロセス開始からガーベージコレクトを実行した回数を Integer で返し
ます。

//emlist[例][ruby]{
GC.count # => 3
//}

• GC
• Integer

GC.latest_gc_info(key) -> object (18304.0)

• 3.2

• 特異メソッド

最新の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

GC.latest_gc_info(result_hash = {}) -> Hash (18304.0)

• 3.2

• 特異メソッド

最新の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

GC.start(full_mark: true, immediate_sweep: true) -> nil (18304.0)

• 3.2

• 特異メソッド

ガーベージコレクトを開始します。

ガーベージコレクトを開始します。

GC#garbage_collect や ObjectSpace.#garbage_collect と同じ働きをします。
GC.disable により GC が禁止されている場合でもガベージコレクトを開始します。

nil を返します。

@param full_mark マイナー GC を動作させる場合は false を、そうでない場
合は true を指定します。

@param immediate_sweep sweep を遅らせる(Lazy Sweep を行う)場合は false
...

• GC

GC.stat(key) -> Numeric (18304.0)

• 3.2

• 特異メソッド

GC 内部の統計情報を Hash で返します。

GC 内部の統計情報を Hash で返します。

@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。


@param key 得られる統計情報から特定の情報を取得したい場合にキーを
Symbol で指定します。

@return GC 内部の統計情報をHash で返します。
引数 key を指定した場合は数値を返します。

GC.stat
# =>
...

• GC
• Hash

絞り込み条件を変える

GC.stat(result_hash = {}) -> {Symbol => Integer} (18304.0)

• 3.2

• 特異メソッド

GC 内部の統計情報を Hash で返します。

GC 内部の統計情報を Hash で返します。

@param result_hash 戻り値のためのハッシュを指定します。省略した場合は新
しくハッシュを作成します。result_hash の内容は上書き
されます。


@param key 得られる統計情報から特定の情報を取得したい場合にキーを
Symbol で指定します。

@return GC 内部の統計情報をHash で返します。
引数 key を指定した場合は数値を返します。

GC.stat
# =>
...

• GC
• Hash

GC.stress -> bool (18304.0)

• 3.2

• 特異メソッド

GCがストレスモードかどうかを返します。

GCがストレスモードかどうかを返します。

真が設定されている場合は GC を行えるすべての機会に GC を行います。

@see GC.stress=

• GC

GC.stress=(value) (18304.0)

• 3.2

• 特異メソッド

GCのストレスモードを引数 value に設定します。 引数 value が真に設定されている間は、GC を行えるすべての機会に GC を行います。

GCのストレスモードを引数 value に設定します。
引数 value が真に設定されている間は、GC を行えるすべての機会に GC を行います。

この機能はデバッグ用途に提供されています。ストレスモードを有効にすると
プログラムのパフォーマンスが低下します。

@param value 任意のオブジェクト。整数以外の値を指定した場合は真偽値として解釈されます。
整数を指定する場合は以下のフラグをOR演算した値を指定します。
: 0x01
マイナー GC を動作させる場合に指定します。
: 0x02
sweep を遅らせる(Lazy Sweep を行う)...

• GC

GC::Profiler.raw_data -> [Hash, ...] | nil (18304.0)

• 3.2

• 特異メソッド

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
• Hash

GC::Profiler.report(out = $stdout) -> nil (18304.0)

• 3.2

• 特異メソッド

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

• GC::Profiler

絞り込み条件を変える

GC::Profiler.result -> String (18304.0)

• 3.2

• 特異メソッド

GC のプロファイル情報をフォーマットし、文字列として返します。

GC のプロファイル情報をフォーマットし、文字列として返します。

プロファイル情報は、GC の発生ごとに集計します。
以下は、5 回 GC が発生した場合の実行例です。

$ ruby -e "GC::Profiler.enable; a = Array.new(100000){ 'aa' }; puts GC::Profiler.result"
GC 5 invokes.
Index Invoke Time(sec) Use Size(byte) Total Size(byte) Total Object ...

• GC::Profiler

GC::Profiler.total_time -> Float (18304.0)

• 3.2

• 特異メソッド

GC のプロファイル情報から GC の総計時間を計算し、msec 単位で返します。

GC のプロファイル情報から GC の総計時間を計算し、msec 単位で返します。

//emlist[例][ruby]{
GC::Profiler.enable
GC.start
GC::Profiler.total_time # => 0.0011530000000000012
//}

• GC::Profiler

Gem.default_bindir -> String (18304.0)

• 3.2

• 特異メソッド

実行ファイルのデフォルトのパスを返します。

実行ファイルのデフォルトのパスを返します。

• Gem

Gem.default_dir -> String (18304.0)

• 3.2

• 特異メソッド

デフォルトの Gem パッケージをインストールするディレクトリを返します。

デフォルトの Gem パッケージをインストールするディレクトリを返します。

• Gem

Gem.default_exec_format -> String (18304.0)

• 3.2

• 特異メソッド

デフォルトのインストールするコマンド名を決めるためのフォーマット文字列を返します。

デフォルトのインストールするコマンド名を決めるためのフォーマット文字列を返します。

• Gem

絞り込み条件を変える

Gem.default_path -> [String] (18304.0)

• 3.2

• 特異メソッド

デフォルトの Gem パッケージをロードするディレクトリのリストを返します。

デフォルトの Gem パッケージをロードするディレクトリのリストを返します。

• Gem

Gem.default_sources -> [String] (18304.0)

• 3.2

• 特異メソッド

デフォルトのパッケージ情報取得先のリストを返します。

デフォルトのパッケージ情報取得先のリストを返します。

• Gem

Gem.default_system_source_cache_dir -> String (18304.0)

• 3.2

• 特異メソッド

デフォルトのシステム全体のソースキャッシュファイルのパスを返します。

デフォルトのシステム全体のソースキャッシュファイルのパスを返します。

• Gem

Gem.default_user_source_cache_dir -> String (18304.0)

• 3.2

• 特異メソッド

デフォルトのユーザ専用のソースキャッシュファイルのパスを返します。

デフォルトのユーザ専用のソースキャッシュファイルのパスを返します。

• Gem

Gem::Command.add_specific_extra_args(cmd, args) (18304.0)

• 3.2

• 特異メソッド

与えられたコマンドに対応する追加の引数を追加します。

与えられたコマンドに対応する追加の引数を追加します。

@param cmd コマンド名を指定します。

@param args 追加の引数を配列か、空白で区切った文字列で指定します。

• Gem::Command

絞り込み条件を変える

Gem::Command.common_options -> Array (18304.0)

• 3.2

• 特異メソッド

共通の引数を返します。

共通の引数を返します。

• Gem::Command

Gem::Command.extra_args -> Array (18304.0)

• 3.2

• 特異メソッド

追加の引数を返します。

追加の引数を返します。

• Gem::Command

Gem::Command.extra_args=(value) (18304.0)

• 3.2

• 特異メソッド

追加の引数をセットします。

追加の引数をセットします。

@param value 配列を指定します。

• Gem::Command

Gem::Command.specific_extra_args(cmd) -> Array (18304.0)

• 3.2

• 特異メソッド

与えられたコマンドに対応する追加の引数を返します。

与えられたコマンドに対応する追加の引数を返します。

特別な追加引数はプログラムの開始時に Gem の設定ファイルから読み込まれます。

@param cmd コマンド名を指定します。

• Gem::Command

Gem::Command.specific_extra_args_hash -> Hash (18304.0)

• 3.2

• 特異メソッド

特別な追加引数へのアクセスを提供します。

特別な追加引数へのアクセスを提供します。

• Gem::Command

絞り込み条件を変える

Gem::CommandManager.instance -> Gem::CommandManager (18304.0)

• 3.2

• 特異メソッド

自身をインスタンス化します。

自身をインスタンス化します。

• Gem::CommandManager

Gem::DocManager.update_ri_cache (18304.0)

• 3.2

• 特異メソッド

RDoc 2 がインストールされている場合は RI のキャッシュを更新します。 そうでない場合は何もしません。

RDoc 2 がインストールされている場合は RI のキャッシュを更新します。
そうでない場合は何もしません。

• Gem::DocManager

Gem::Ext::Builder.redirector -> String (18304.0)

• 3.2

• 特異メソッド

@todo

@todo

'2>&1' という文字列を返します。

• Gem::Ext::Builder

Gem::Installer.exec_format -> String (18304.0)

• 3.2

• 特異メソッド

実行ファイル名のフォーマットを返します。

実行ファイル名のフォーマットを返します。

指定しない場合は ruby コマンドと同じフォーマットを使用します。

• Gem::Installer

Gem::Installer.exec_format=(format) (18304.0)

• 3.2

• 特異メソッド

実行ファイル名のフォーマットをセットします。

実行ファイル名のフォーマットをセットします。

@param format 実行ファイル名のフォーマットを指定します。

• Gem::Installer

絞り込み条件を変える

Gem::Installer.path_warning -> bool (18304.0)

• 3.2

• 特異メソッド

この値が 真の場合は Gem.bindir が PATH に含まれていない場合に警告を表示します。

この値が 真の場合は Gem.bindir が PATH に含まれていない場合に警告を表示します。

• Gem::Installer

Gem::Installer.path_warning=(flag) (18304.0)

• 3.2

• 特異メソッド

Gem.bindir が PATH に含まれていない場合に警告を表示するかどうかセットします。

Gem.bindir が PATH に含まれていない場合に警告を表示するかどうかセットします。

@param flag 真を指定すると、Gem.bindir が PATH に含まれていない場合に警
告を表示するようになります。

• Gem::Installer

Gem::Platform.match(platform) -> bool (18304.0)

• 3.2

• 特異メソッド

@todo ???

@todo ???

• Gem::Platform

Gem::Requirement.create(input) -> Gem::Requirement (18304.0)

• 3.2

• 特異メソッド

Gem::Requirement のインスタンスを作成するためのファクトリメソッドです。

...のいずれかを指定します。

@return 上記以外の値を input に指定するとデフォルト値を返します。

//emlist[][ruby]{
pp Gem::Requirement.create("~> 3.2.1")
# => Gem::Requirement.new(["~> 3.2.1"])
//}

@see Gem::Requirement.new, Gem::Requirement.default...

• Gem::Requirement
• Gem::Version

Gem::Security.add_trusted_cert(cert, options = {}) -> nil (18304.0)

• 3.2

• 特異メソッド

信頼済み証明書リストに与えられた証明書を追加します。

信頼済み証明書リストに与えられた証明書を追加します。

Note: しばらくの間 OPT[:trust_dir] に保存されますが、今後変更される可能性があります。

@param cert 証明書を指定します。

@param options オプションを指定します。

• Gem::Security

絞り込み条件を変える

Gem::Security.build_cert(name, key, options = {}) -> OpenSSL::X509::Certificate (18304.0)

• 3.2

• 特異メソッド

与えられた DN と秘密鍵を使用して証明書を作成します。

与えられた DN と秘密鍵を使用して証明書を作成します。

@param name DN を指定します。

@param key 秘密鍵を指定します。

@param options オプションを指定します。

• Gem::Security

Gem::Security.build_self_signed_cert(email_addr, options = {}) -> Hash (18304.0)

• 3.2

• 特異メソッド

与えられたメールアドレスを元にして自己署名証明書を作成します。

与えられたメールアドレスを元にして自己署名証明書を作成します。

@param email_addr メールアドレスを指定します。

@param options オプションを指定します。

@return 鍵と証明書とそれらを保存したパスを表すハッシュを返します。

• Gem::Security

Gem::Security.sign_cert(cert, signing_key, signing_cert, options = {}) -> OpenSSL::X509::Certificate (18304.0)

• 3.2

• 特異メソッド

与えられた署名用の鍵と証明書を用いて証明書に署名します。

与えられた署名用の鍵と証明書を用いて証明書に署名します。

@param cert 署名する証明書を指定します。

@param signing_key 署名にしようする鍵を指定します。

@param signing_cert 署名に使用する証明書を指定します。

@param options オプションを指定します。

@return 署名された証明書を返します。

• Gem::Security

Gem::Security.verify_trust_dir(path, perms) (18304.0)

• 3.2

• 特異メソッド

信頼するディレクトリが存在することを確認します。

信頼するディレクトリが存在することを確認します。

与えられたパスが存在する場合、ディレクトリであることを確認します。
そうでない場合は、ディレクトリを作成してパーミッションを変更します。

@param path 確認するパスを指定します。

@param perms ディレクトリを作成する場合のパーミッションを指定します。

@raise Gem::Security::Exception path がディレクトリでない場合に発生します。

• Gem::Security

Gem::SourceIndex.from_installed_gems(*deprecated) -> Gem::SourceIndex (18304.0)

• 3.2

• 特異メソッド

与えられたパスをもとに、インスタンスを作成するファクトリメソッドです。

与えられたパスをもとに、インスタンスを作成するファクトリメソッドです。

@param deprecated この引数は非推奨です。後方互換性のためにのみ提供されているので使用すべきではありません。

@see Gem::SourceIndex.from_gems_in

• Gem::SourceIndex

絞り込み条件を変える