検索結果

static void warning_unless_e_option(const char *str) (78301.0)

• 3.1

• 関数

ruby -e で与えたプログラムの評価中ではなく、 しかも $VERBOSE が真ならば、警告メッセージ str を出力する。

ruby -e で与えたプログラムの評価中ではなく、
しかも $VERBOSE が真ならば、警告メッセージ str を出力する。

Rake::TestTask#warning -> bool (54304.0)

• 3.1

• インスタンスメソッド

この値が真である場合、テスト実行時に ruby -w を実行したのと同じ効果が生じます。

この値が真である場合、テスト実行時に ruby -w を実行したのと同じ効果が生じます。

• Rake::TestTask

Ripper#warning(fmt, *args) -> nil (54304.0)

• 3.1

• インスタンスメソッド

解析した Ruby プログラムの中に重要な警告($-w が false の時だけ出 力される警告)を出力するようなものがあった場合に実行されます。

解析した Ruby プログラムの中に重要な警告($-w が false の時だけ出
力される警告)を出力するようなものがあった場合に実行されます。

@param fmt エラーメッセージのフォーマット文字列です。

@param args エラーメッセージのフォーマットされる引数です。

サブクラスでオーバライドして使用します。

引数のエラーメッセージは printf フォーマットに従って渡されます。

• Ripper

Syslog.#warning(message, *arg) -> self (45304.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Warning.warn(message, category: nil) -> nil (27091.0)

• 3.1

• 特異メソッド

引数 message を標準エラー出力 $stderr に出力します。

引数 message を標準エラー出力 $stderr に出力します。

本メソッドはRubyが出力する全ての警告に対して呼び出されます。
そのため本メソッドをオーバーライドすることで Ruby から出力される警告の動作を変更できます。
またオーバーライドしたメソッドからは super を呼び出すことで、デフォルトの動作である $stderr への出力ができます。

//emlist[][ruby]{
module Warning
# 警告メッセージに category を表示し、message 末尾に !!! を追加する
def self.warn(message, categor...

• Warning

絞り込み条件を変える

Warning.[]=(category, flag) -> flag (27067.0)

• 3.1

• 特異メソッド

category の警告を表示するかどうかのフラグを設定します。 サポートされている category については Warning.[] を参照してください。

category の警告を表示するかどうかのフラグを設定します。
サポートされている category については Warning.[] を参照してください。

@param category 警告の種類を指定します。
@param flag 真、または偽を指定します。

@see Warning.[]

• Warning

Warning#warn(message, category: nil) -> nil (27055.0)

• 3.1

• インスタンスメソッド

引数 message を標準エラー出力 $stderr に出力します。

引数 message を標準エラー出力 $stderr に出力します。

Kernel.#warnの挙動を変更する際は、このメソッドではなくクラスメソッドであるWarning.warnをオーバーライドする必要があります。

@param message 出力するオブジェクトを指定します。

@param category 警告のカテゴリを指定します。サポートされている category については Warning.[] を参照してください。


@see Kernel.#warn, Warning.warn

• Warning

Warning.[](category) -> bool (27001.0)

• 3.1

• 特異メソッド

category の種類の警告を表示するかどうかのフラグを返します。

@param category 警告の種類を指定します。

サポートされている category は以下の通りです。

: :deprecated
非推奨の警告。
例: nil ではない値を $, や $; に設定する、キーワード引数、ブロックなしで proc / lambda を呼び出す、等

: :experimental
実験的な機能。

例: パターンマッチング

• Warning

Gem::StreamUI#alert_warning(statement, question = nil) -> String | nil (18352.0)

• 3.1

• インスタンスメソッド

WARNING レベルのアラートを表示します。

WARNING レベルのアラートを表示します。

@param statement 表示する文字列を指定します。

@param question 必要であれば質問を指定します。

@return question を指定した場合は、それに対する回答を返します。
question を指定しない場合は nil を返します。

@see Gem::StreamUI#ask

• Gem::StreamUI

Gem::UserInteraction#alert_warning(*args) -> () (18352.0)

• 3.1

• インスタンスメソッド

WARNING レベルのアラートを出力します。

WARNING レベルのアラートを出力します。

@param args 委譲先のメソッドに与える引数です。

• Gem::UserInteraction

絞り込み条件を変える

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

• 3.1

• 特異メソッド

この値が真の場合、ホームディレクトリに Gem をインストールしようとすると警告を表示します。

この値が真の場合、ホームディレクトリに Gem をインストールしようとすると警告を表示します。

• Gem::Installer

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

• 3.1

• 特異メソッド

ホームディレクトリに Gem をインストールしようとすると警告を表示するかどうかセットします。

ホームディレクトリに Gem をインストールしようとすると警告を表示するかどうかセットします。

@param flag 真を指定するとホームディレクトリに Gem をインストールしよう
とすると警告を表示するようになります。

• Gem::Installer

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

• 3.1

• 特異メソッド

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

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

• Gem::Installer

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

• 3.1

• 特異メソッド

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

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

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

• Gem::Installer

Rake::TestTask#warning=(flag) (18304.0)

• 3.1

• インスタンスメソッド

テスト実行時に警告を表示させるかどうかをセットします。

テスト実行時に警告を表示させるかどうかをセットします。

@param flag 真または偽を指定します。

• Rake::TestTask

絞り込み条件を変える

Warning (18037.0)

• 3.1

• モジュール

警告を出力するためのモジュールです。

警告を出力するためのモジュールです。

本モジュールは warn インスタンスメソッドのみで構成されます。しかし、本モジュールは自身を extend するため、.warn メソッドも利用可能です。warn メソッドは Ruby が出力する全ての警告に対して呼び出されます。デフォルトでは全ての警告が $stderr に出力されます。

Warning.warn をオーバーライドする事で Ruby から出力される警告の動作を変更する事ができます。例えばエラーメッセージのフィルタリングや、$stderr 以外に警告を出力といった変更が可能です。Warning.warn をオーバーライドする際は su...

Syslog::Level::LOG_WARNING -> Integer (9304.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

ruby 1.6 feature (397.0)

• 3.1

• 文書

ruby 1.6 feature ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン になります。

ruby 1.6 feature
ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン
になります。

((<stable-snapshot|URL:ftp://ftp.netlab.co.jp/pub/lang/ruby/stable-snapshot.tar.gz>)) は、日々更新される安定版の最新ソースです。

== 1.6.8 (2002-12-24) -> stable-snapshot

: 2003-01-22: errno

EAGAIN と EWOULDBLOCK が同じ値のシステムで、EWOULDBLOCK がなくなっ
ていま...

1.6.8から1.8.0への変更点(まとめ) (217.0)

• 3.1

• 文書

1.6.8から1.8.0への変更点(まとめ) * ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>)) * ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>)) * ((<1.6.8から1.8.0への変更点(まとめ)/文法の変更>)) * ((<1.6.8から1.8.0への変更点(まとめ)/正規表現>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Marshal>)) * ((<1.6.8から1.8.0への変更点(まとめ)/Windows 対応>)) * ((<1.6.8から1.8.0への変更点(まとめ)/廃止された(される予定の)機能>)) * ((<1.6.8から1.8.0への変更点(まとめ)/ライブラリ>)) * ((<1.6.8から1.8.0への変更点(まとめ)/拡張ライブラリAPI>)) * ((<1.6.8から1.8.0への変更点(まとめ)/バグ修正>)) * ((<1.6.8から1.8.0への変更点(まとめ)/サポートプラットフォームの追加>))

1.6.8から1.8.0への変更点(まとめ)
* ((<1.6.8から1.8.0への変更点(まとめ)/インタプリタの変更>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたクラス／モジュール>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加されたメソッド>))
* ((<1.6.8から1.8.0への変更点(まとめ)/追加された定数>))
* ((<1.6.8から1.8.0への変更点(まとめ)/拡張されたクラス／メソッド(互換性のある変更)>))
* ((<1.6.8から1.8.0への変更点(まとめ)/変更されたクラス／メソッド(互換性のない変更)>))...

NEWS for Ruby 2.7.0 (217.0)

• 3.1

• 文書

NEWS for Ruby 2.7.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

...も1個のエスケープされた文字があるときに2~5倍速くなりました。
https://github.com/ruby/ruby/pull/2226

* CSV
* 3.1.2に更新されました。
https://github.com/ruby/csv/blob/master/NEWS.md

* Date
* Date.jisx0301, Date#jisx0301, Date.parseが新...

.../NEWS.md

* RubyGems
* RubyGems 3.1.2に更新されました。
* https://github.com/rubygems/rubygems/releases/tag/v3.1.0
* https://github.com/rubygems/rubygems/releases/tag/v3.1.1
* https://github.com/rubygems/rubygems/releases/tag/v3.1.2

* StringScanner
* 1.0.3に...

• Array
• Bundler
• CGI
• CSV
• Comparable
• Comparable#clamp
• Complex
• Date
• Delegator
• Dir
• ERB
• Encoding
• Enumerable
• Enumerator
• FalseClass
• Fiber
• File
• FrozenError
• GC
• Hash
• ...

絞り込み条件を変える

NEWS for Ruby 3.0.0 (127.0)

• 3.1

• 文書

NEWS for Ruby 3.0.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

...r
* Update to Bundler 2.2.3
* CGI
* Update to 0.2.0
* This version is Ractor compatible.
* CSV
* Update to CSV 3.1.9
* Date
* Update to Date 3.1.1
* This version is Ractor compatible.
* Digest
* Update to Digest 3.0.0
* This version is Ractor compatible.
* E...

Kernel.#warn(*message, uplevel: nil, category: nil) -> nil (109.0)

• 3.1

• モジュール関数

message を 標準エラー出力 $stderr に出力します。 $VERBOSE フラグ が nil のときは何も出力しません。

message を 標準エラー出力 $stderr に出力します。 $VERBOSE
フラグ が nil のときは何も出力しません。

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

uplevel を指定しない場合は、
このメソッドは以下と同じです。

//emlist[][ruby]{
$stderr.puts(*message) if !$VERBOSE.nil? && !message.empty?
nil
//}

@param message 出力するオブジェクトを任意個指定します。
@param upleve...

• Kernel

Module#deprecate_constant(*name) -> self (73.0)

• 3.1

• インスタンスメソッド

name で指定した定数を deprecate に設定します。 deprecate に設定した定数を参照すると警告メッセージが表示されます。

name で指定した定数を deprecate に設定します。
deprecate に設定した定数を参照すると警告メッセージが表示されます。

Ruby 2.7.2 から Warning[:deprecated] のデフォルト値が false に変更になったため、
デフォルトでは警告が表示されません。

コマンドラインオプション(詳細はd:spec/rubycmd#cmd_option参照)で、
「-w」か「-W2」などを指定するか、実行中に「Warning[:deprecated] = true」で
変更すると表示されるようになります。

「$VERBOSE = true」は「Warnin...

• Module
• String
• Symbol

NEWS for Ruby 2.4.0 (55.0)

• 3.1

• 文書

NEWS for Ruby 2.4.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

NEWS for Ruby 2.4.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリストは ChangeLog ファイルか bugs.ruby-lang.org の issue を参照してください。

== 2.3.0 以降の変更

=== 言語仕様の変更

* 条件式での多重代入ができるようになりました 10617
* Symbol#to_proc でメソッド呼び出し元での Refinements が有効になりました 9451
* Ob...

• Array
• Comparable
• Dir
• Enumerable
• Enumerator
• Enumerator::Lazy
• File
• Float
• Hash
• IO
• Integer
• Kernel
• MatchData
• Module
• Numeric
• Process
• Rational
• Regexp
• String
• StringIO
• ...

Syslog::Logger#error(message = nil, &block) -> true (49.0)

• 3.1

• インスタンスメソッド

ERROR 情報を出力します。syslog の warning の情報として記録されます。

ERROR 情報を出力します。syslog の warning の情報として記録されます。

ブロックを与えなかった場合は、message をメッセージとしてログを出力します。

ブロックを与えた場合は、ブロックを評価した結果をメッセージとして ログを出力します。

引数とブロックを同時に与えた場合は、message をメッセージとしてログを出
力します(ブロックは評価されません)。

@see Syslog::Logger::LEVEL_MAP, Logger#error

• Syslog::Logger

絞り込み条件を変える

Syslog::Logger#error? -> bool (49.0)

• 3.1

• インスタンスメソッド

self が ERROR 以上の(syslog の warning)ログレベルのメッセージを記録する 場合に true を返します。

self が ERROR 以上の(syslog の warning)ログレベルのメッセージを記録する
場合に true を返します。

• Syslog::Logger

Kernel$$= -> bool (37.0)

• 3.1

• 変数

過去との互換性のために残されていますが、もはや何の意味もありません。

過去との互換性のために残されていますが、もはや何の意味もありません。

値は常に false です。代入しても無視されます。

この変数はグローバルスコープです。

//emlist[例][ruby]{
$= = true # => warning: variable $= is no longer effective; ignored
$= # => warning: variable $= is no longer effective
# false
//}

• Kernel

Kernel$$IGNORECASE -> bool (37.0)

• 3.1

• 変数

過去との互換性のために残されていますが、もはや何の意味もありません。

過去との互換性のために残されていますが、もはや何の意味もありません。

値は常に false です。代入しても無視されます。

$= の別名

require "English"

$IGNORECASE = true # => warning: variable $= is no longer effective; ignored
$IGNORECASE # => warning: variable $= is no longer effective
# false

• Kernel

Kernel.#lambda { ... } -> Proc (37.0)

• 3.1

• モジュール関数

与えられたブロックから手続きオブジェクト (Proc のインスタンス) を生成して返します。Proc.new に近い働きをします。

与えられたブロックから手続きオブジェクト (Proc のインスタンス)
を生成して返します。Proc.new に近い働きをします。


また、lambda に & 引数を渡すのは推奨されません。& 引数ではなくてブロック記法で記述する必要があります。

& 引数を渡した lambda は Warning[:deprecated] = true のときに警告メッセージ
「warning: lambda without a literal block is deprecated; use the proc without lambda instead」
を出力します。

@raise Argum...

• Kernel
• LocalJumpError
• Proc

Kernel.#proc { ... } -> Proc (37.0)

• 3.1

• モジュール関数

与えられたブロックから手続きオブジェクト (Proc のインスタンス) を生成して返します。Proc.new に近い働きをします。

与えられたブロックから手続きオブジェクト (Proc のインスタンス)
を生成して返します。Proc.new に近い働きをします。


また、lambda に & 引数を渡すのは推奨されません。& 引数ではなくてブロック記法で記述する必要があります。

& 引数を渡した lambda は Warning[:deprecated] = true のときに警告メッセージ
「warning: lambda without a literal block is deprecated; use the proc without lambda instead」
を出力します。

@raise Argum...

• Kernel
• LocalJumpError
• Proc

絞り込み条件を変える

Module#const_set(name, value) -> object (37.0)

• 3.1

• インスタンスメソッド

モジュールに name で指定された名前の定数を value とい う値として定義し、value を返します。

モジュールに name で指定された名前の定数を value とい
う値として定義し、value を返します。

そのモジュールにおいてすでにその名前の定数が定義されている場合、警
告メッセージが出力されます。

@param name Symbol,String で定数の名前を指定します。
@param value セットしたい値を指定します。

//emlist[例][ruby]{
module Foo; end

# Symbolを指定した場合
Foo.const_set(:FOO, 123)
Foo::FOO # => 123

# Stringを指定した場合
Foo.const_...

• Module
• String
• Symbol

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

• 3.1

• モジュール関数

開いていた syslog を最初にクローズする点を除いてSyslog.#open と同じです。

開いていた syslog を最初にクローズする点を除いてSyslog.#open と同じです。

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

@param options Syslog.open や Syslog.log の動作を制御するフラグを指定します。
指定しない場合は、Syslog::LOG_PID|Syslog::LOG_CONSの値が使われ
...

• Syslog

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

• 3.1

• モジュール関数

開いていた syslog を最初にクローズする点を除いてSyslog.#open と同じです。

開いていた syslog を最初にクローズする点を除いてSyslog.#open と同じです。

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

@param options Syslog.open や Syslog.log の動作を制御するフラグを指定します。
指定しない場合は、Syslog::LOG_PID|Syslog::LOG_CONSの値が使われ
...

• Syslog

ruby 1.8.4 feature (37.0)

• 3.1

• 文書

ruby 1.8.4 feature ruby 1.8.4 での ruby 1.8.3 からの変更点です。

ruby 1.8.4 feature
ruby 1.8.4 での ruby 1.8.3 からの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

# * カテゴリ
# * [ruby]: ruby インタプリタの変更
# * [api]: 拡張ライブラリ API
# * [lib]: ライブラリ
* レベル
* [bug]: バグ修正
* [new]: 追加され...

制御構造 (37.0)

• 3.1

• 文書

制御構造 条件分岐: * if * unless * case 繰り返し: * while * until * for * break * next * redo * retry 例外処理: * raise * begin その他: * return * BEGIN * END

制御構造
条件分岐:
* if
* unless
* case
繰り返し:
* while
* until
* for
* break
* next
* redo
* retry
例外処理:
* raise
* begin
その他:
* return
* BEGIN
* END

Rubyでは(Cなどとは異なり)制御構造は式であって、何らかの値を返すものが
あります(返さないものもあります。値を返さない式を代入式の右辺に置くと
syntax error になります)。

R...

• Interrupt
• Kernel
• RuntimeError
• StandardError
• SyntaxError
• SystemExit
• TypeError
• _builtin
• spec/terminate

絞り込み条件を変える

Hash#fetch(key) -> object (19.0)

• 3.1

• インスタンスメソッド

key に関連づけられた値を返します。該当するキーが登録されてい ない時には、引数 default が与えられていればその値を、ブロッ クが与えられていればそのブロックを評価した値を返します。

key に関連づけられた値を返します。該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。

fetchはハッシュ自身にデフォルト値が設定されていても単に無視します（挙動に変化がありません）。

@param key 探索するキーを指定します。
@param default 該当するキーが登録されていない時の返り値を指定します。
@raise KeyError 引数defaultもブロックも与えられてない時、キーの探索に失敗すると発生します。

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

• Hash

Hash#fetch(key) {|key| ... } -> object (19.0)

• 3.1

• インスタンスメソッド

key に関連づけられた値を返します。該当するキーが登録されてい ない時には、引数 default が与えられていればその値を、ブロッ クが与えられていればそのブロックを評価した値を返します。

key に関連づけられた値を返します。該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。

fetchはハッシュ自身にデフォルト値が設定されていても単に無視します（挙動に変化がありません）。

@param key 探索するキーを指定します。
@param default 該当するキーが登録されていない時の返り値を指定します。
@raise KeyError 引数defaultもブロックも与えられてない時、キーの探索に失敗すると発生します。

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

• Hash

Hash#fetch(key, default) -> object (19.0)

• 3.1

• インスタンスメソッド

key に関連づけられた値を返します。該当するキーが登録されてい ない時には、引数 default が与えられていればその値を、ブロッ クが与えられていればそのブロックを評価した値を返します。

key に関連づけられた値を返します。該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。

fetchはハッシュ自身にデフォルト値が設定されていても単に無視します（挙動に変化がありません）。

@param key 探索するキーを指定します。
@param default 該当するキーが登録されていない時の返り値を指定します。
@raise KeyError 引数defaultもブロックも与えられてない時、キーの探索に失敗すると発生します。

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

• Hash

IO#sysseek(offset, whence = IO::SEEK_SET) -> Integer (19.0)

• 3.1

• インスタンスメソッド

lseek(2) と同じです。IO#seek では、 IO#sysread, IO#syswrite と併用すると正しく動作しないので代わりにこのメソッドを使います。 位置 offset への移動が成功すれば移動した位置(ファイル先頭からのオフセット)を返します。

...IO::SEEK_END: ファイルの末尾から
* IO::SEEK_DATA: offset 以降の次にデータがある位置へ(lseek の man ページ参照。Linux 3.1 以降のみ)
* IO::SEEK_HOLE: offset 以降の次にホールがある位置へ(同上)

@raise IOError 読み込み用にバッファリング...

• IO

Integer#**(other) -> Numeric (19.0)

• 3.1

• インスタンスメソッド

算術演算子。冪(べき乗)を計算します。

算術演算子。冪(べき乗)を計算します。

@param other 二項演算の右側の引数(対象)
@param modulo 指定すると、計算途中に巨大な値を生成せずに (self**other) % modulo と同じ結果を返します。
@return 計算結果
@raise TypeError 2引数 pow で Integer 以外を指定した場合に発生します。
@raise RangeError 2引数 pow で other に負の数を指定した場合に発生します。

//emlist[][ruby]{
2 ** 3 # => 8
2 ** 0 # => 1
0 ** 0 # => 1
...

• Integer

絞り込み条件を変える

Integer#pow(other) -> Numeric (19.0)

• 3.1

• インスタンスメソッド

算術演算子。冪(べき乗)を計算します。

算術演算子。冪(べき乗)を計算します。

@param other 二項演算の右側の引数(対象)
@param modulo 指定すると、計算途中に巨大な値を生成せずに (self**other) % modulo と同じ結果を返します。
@return 計算結果
@raise TypeError 2引数 pow で Integer 以外を指定した場合に発生します。
@raise RangeError 2引数 pow で other に負の数を指定した場合に発生します。

//emlist[][ruby]{
2 ** 3 # => 8
2 ** 0 # => 1
0 ** 0 # => 1
...

• Integer

Integer#pow(other, modulo) -> Integer (19.0)

• 3.1

• インスタンスメソッド

算術演算子。冪(べき乗)を計算します。

算術演算子。冪(べき乗)を計算します。

@param other 二項演算の右側の引数(対象)
@param modulo 指定すると、計算途中に巨大な値を生成せずに (self**other) % modulo と同じ結果を返します。
@return 計算結果
@raise TypeError 2引数 pow で Integer 以外を指定した場合に発生します。
@raise RangeError 2引数 pow で other に負の数を指定した場合に発生します。

//emlist[][ruby]{
2 ** 3 # => 8
2 ** 0 # => 1
0 ** 0 # => 1
...

• Integer

NEWS for Ruby 3.1.0 (19.0)

• 3.1

• 文書

NEWS for Ruby 3.1.0 このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

...NEWS for Ruby 3.1.0
このドキュメントは前回リリース以降のバグ修正を除くユーザーに影響のある機能の変更のリストです。

それぞれのエントリーは参照情報があるため短いです。
十分な情報と共に書かれた全ての変更のリス...

...{
foo[0] = bar
//}

* 次の評価順序になります。

//emlist{
1. `foo`
2. `bar`
3. `[]=` called on the result of `foo`
//}

* Ruby 3.1.0より前は、多重代入の評価順序が上記のようではありませんでした。このコードでは、

//emlist[][ruby]{
foo[0], b...

...//emlist{
1. `a`
2. `b`
3. `foo`
4. `[]=` called on the result of `foo`
5. `bar`
6. `baz=` called on the result of `bar`
//}

* Ruby 3.1.0から単一代入と評価順序が一致するようになり、左が右より先に評価されます。

//emlist{
1. `foo`
2. `bar`
3....

• ArgumentError
• Array
• Class
• Enumerable
• Enumerator::Lazy
• File
• GC
• Integer
• Kernel
• Marshal
• MatchData
• Method
• Module
• Process
• Refinement
• String
• Struct
• Thread
• Thread::Queue
• Time
• ...

Psych.safe_load(yaml, legacy_permitted_classes=[], legacy_permitted_symbols=[], legacy_aliases=false, legacy_filename=nil) -> object (19.0)

• 3.1

• 特異メソッド

安全に YAML フォーマットの文書を読み込み Ruby のオブジェクトを生成して返します。

安全に YAML フォーマットの文書を読み込み Ruby のオブジェクトを生成して返します。

デフォルトでは以下のクラスのオブジェクトしか変換しません。

* TrueClass
* FalseClass
* NilClass
* Numeric
* String
* Array
* Hash

再帰的なデータ構造はデフォルトでは許可されていません。

任意のクラスを許可するにはキーワード引数 permitted_classes を指定すると、
そのクラスが追加されます。例えば Date クラスを許可するには
以下のように書いてください:

//emlist[permitte...

• Psych
• Psych::SyntaxError
• Symbol

Psych.safe_load(yaml, permitted_classes: [], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false) -> object (19.0)

• 3.1

• 特異メソッド

安全に YAML フォーマットの文書を読み込み Ruby のオブジェクトを生成して返します。

安全に YAML フォーマットの文書を読み込み Ruby のオブジェクトを生成して返します。

デフォルトでは以下のクラスのオブジェクトしか変換しません。

* TrueClass
* FalseClass
* NilClass
* Numeric
* String
* Array
* Hash

再帰的なデータ構造はデフォルトでは許可されていません。

任意のクラスを許可するにはキーワード引数 permitted_classes を指定すると、
そのクラスが追加されます。例えば Date クラスを許可するには
以下のように書いてください:

//emlist[permitte...

• Psych
• Psych::SyntaxError
• Symbol

絞り込み条件を変える

Regexp#~ -> Integer | nil (19.0)

• 3.1

• インスタンスメソッド

変数 $_ の値との間でのマッチをとります。

変数 $_ の値との間でのマッチをとります。

ちょうど以下と同じ意味です。

//emlist[][ruby]{
self =~ $_
//}

//emlist[例][ruby]{
$_ = "hogehoge"

if /foo/
puts "match"
else
puts "no match"
end
# => no match
# ただし、警告がでる。warning: regex literal in condition

reg = Regexp.compile("foo")

if ~ reg
puts "match"
else
puts "no matc...

• Regexp

Rubyの起動 (19.0)

• 3.1

• 文書

Rubyの起動 * cmd_option * shebang

Rubyの起動
* cmd_option
* shebang

Rubyインタプリタの起動は以下の書式のコマンドラインにより行います。

ruby [ option ...] [ -- ] [ programfile ] [ argument ...]

ここで、option は後述のcmd_option
のいずれかを指定します。-- は、オプション列の終りを明示するため
に使用できます。programfile は、Ruby スクリプトを記述したファイ
ルです。これを省略したり`-' を指定した場合には標準入力を Ruby ス
クリプトとみなします。

programfile が...

• platform/Win32

String#to_f -> Float (19.0)

• 3.1

• インスタンスメソッド

文字列を 10 進数表現と解釈して、浮動小数点数 Float に変換します。

文字列を 10 進数表現と解釈して、浮動小数点数 Float に変換します。

浮動小数点数とみなせなくなるところまでを変換対象とします。
途中に変換できないような文字列がある場合、それより先の文字列は無視されます。

//emlist[][ruby]{
p "-10".to_f # => -10.0
p "10e2".to_f # => 1000.0
p "1e-2".to_f # => 0.01
p ".1".to_f # => 0.1

p "1_0_0".to_f # => 100.0 # 数値リテラルと同じように区切りに _ を使える
p " \n10".to_f ...

• Float
• String

Struct.new(*args, keyword_init: nil) -> Class (19.0)

• 3.1

• 特異メソッド

Struct クラスに新しいサブクラスを作って、それを返します。

...す。
@param keyword_init true を指定すると、キーワード引数で初期化する構造体を定義します。
Ruby 3.1 では互換性に影響のある使い方をしたときに警告が出るため、
従来の挙動を期待する構造体に...

• String
• Struct
• Symbol

Struct.new(*args, keyword_init: nil) {|subclass| block } -> Class (19.0)

• 3.1

• 特異メソッド

Struct クラスに新しいサブクラスを作って、それを返します。

...す。
@param keyword_init true を指定すると、キーワード引数で初期化する構造体を定義します。
Ruby 3.1 では互換性に影響のある使い方をしたときに警告が出るため、
従来の挙動を期待する構造体に...

• String
• Struct
• Symbol

絞り込み条件を変える

Syslog (19.0)

• 3.1

• モジュール

UNIXのsyslogのラッパーモジュール。 syslog の詳細については syslog(3) を参照してください。

UNIXのsyslogのラッパーモジュール。
syslog の詳細については syslog(3) を参照してください。

require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
Syslog.close
# 書き込まれているか確かめる。
# 但し、実行環境によってログの場所が違う。くわしくはsyslog.confを参照。
File.foreach('/var/log/system.log'...

Syslog.#close -> nil (19.0)

• 3.1

• モジュール関数

syslogを閉じます。

syslogを閉じます。

@raise RuntimeError syslog がopen されていない場合発生します。

使用例
require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
Syslog.close

• Syslog

Syslog.#mask -> Integer | nil (19.0)

• 3.1

• モジュール関数

ログの優先度のマスクを取得または設定します。 マスクは永続的であり、 Syslog.openやSyslog.close ではリセットされません。

ログの優先度のマスクを取得または設定します。
マスクは永続的であり、
Syslog.openやSyslog.close
ではリセットされません。

@param mask ログの優先度のマスクを設定します。

@raise RuntimeError syslog がオープンされていない場合、発生します。

使用例

require 'syslog'
include Syslog::Constants
# ログの場所は実行環境によって異なる。詳しくはsyslog.conf を参照
log = '/var/log/ftp.log'

Syslog.open('ftpd', L...

• Syslog

Syslog.#mask=(mask) (19.0)

• 3.1

• モジュール関数

ログの優先度のマスクを取得または設定します。 マスクは永続的であり、 Syslog.openやSyslog.close ではリセットされません。

ログの優先度のマスクを取得または設定します。
マスクは永続的であり、
Syslog.openやSyslog.close
ではリセットされません。

@param mask ログの優先度のマスクを設定します。

@raise RuntimeError syslog がオープンされていない場合、発生します。

使用例

require 'syslog'
include Syslog::Constants
# ログの場所は実行環境によって異なる。詳しくはsyslog.conf を参照
log = '/var/log/ftp.log'

Syslog.open('ftpd', L...

• Syslog

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

• 3.1

• モジュール関数

与えられた引数で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 (19.0)

• 3.1

• モジュール関数

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

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

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

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

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

@param options Syslog.open ...

• RuntimeError
• Syslog
• Syslog::Constants

Syslog.#opened? -> bool (19.0)

• 3.1

• モジュール関数

syslog をオープンしていれば真を返します。

syslog をオープンしていれば真を返します。

使用例
require 'syslog'

p Syslog.opened? #=> false
Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
p Syslog.opened? #=> true

• Syslog

cgi/session (19.0)

• 3.1

• ライブラリ

CGI のセッション管理を行うライブラリ。

CGI のセッション管理を行うライブラリ。

セッションとは、HTTP の一連のリクエストとレスポンスが属するべき
コンテクスト (状況) のことをいいます。
セッション管理には従来通り cgi ライブラリが提供する
クッキーを使用してもいいですが、
この cgi/session を使用した方がよりわかりやすいでしょう。
セッション情報は Hash ライクなインターフェースです。

セッションはセッション ID とプログラムが記録した
セッション情報から構成されます。
デフォルトでは CGI::Session::FileStore が使用され、
記録できるのは文字列のみです。

セッション情報...

• CGI::Session
• CGI::Session::FileStore
• CGI::Session::MemoryStore
• CGI::Session::NoSession
• CGI::Session::NullStore
• cgi/session/pstore

ruby 1.8.3 feature (19.0)

• 3.1

• 文書

ruby 1.8.3 feature *((<ruby 1.8 feature>)) *((<ruby 1.8.2 feature>))

ruby 1.8.3 feature
*((<ruby 1.8 feature>))
*((<ruby 1.8.2 feature>))

ruby 1.8.2 から ruby 1.8.3 までの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ...

ruby 1.9 feature (19.0)

• 3.1

• 文書

ruby 1.9 feature ruby version 1.9.0 は開発版です。 以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。 1.9.1 以降は安定版です。 バグ修正がメインになります。

ruby 1.9 feature
ruby version 1.9.0 は開発版です。
以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。
1.9.1 以降は安定版です。
バグ修正がメインになります。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
* [parser]: 文法の変更
* [regexp]: 正規表現の機能拡張
* [marshal]: Marshal ファイルのフォーマット変更
* ...

絞り込み条件を変える

クラス／メソッドの定義 (19.0)

• 3.1

• 文書

クラス／メソッドの定義 * クラス／メソッドの定義: * class * singleton_class * module * method * operator * nest_method * eval_method * singleton_method * class_method * limit * 定義に関する操作: * alias * undef * defined

クラス／メソッドの定義
* クラス／メソッドの定義:
* class
* singleton_class
* module
* method
* operator
* nest_method
* eval_method
* singleton_method
* class_method
* limit
* 定義に関する操作:
* alias
* undef
* defined

===[a:class] クラス定義

//emlist[例][ruby]{
class Foo < S...

• Class
• Module
• NameError
• Proc
• Symbol
• spec/operator

Struct.[](*args) -> Struct (4.0)

• 3.1

• 特異メソッド

(このメソッドは Struct の下位クラスにのみ定義されています) 構造体オブジェクトを生成して返します。

(このメソッドは Struct の下位クラスにのみ定義されています)
構造体オブジェクトを生成して返します。

@param args 構造体の初期値を指定します。メンバの初期値は指定されなければ nil です。

@return 構造体クラスのインスタンス。

@raise ArgumentError 構造体のメンバの数よりも多くの引数を指定した場合に発生します。

//emlist[例][ruby]{
Foo = Struct.new(:foo, :bar)
foo = Foo.new(1)
p foo.values # => [1, nil]
//}

• Struct

Struct.new(*args) -> Struct (4.0)

• 3.1

• 特異メソッド

(このメソッドは Struct の下位クラスにのみ定義されています) 構造体オブジェクトを生成して返します。

(このメソッドは Struct の下位クラスにのみ定義されています)
構造体オブジェクトを生成して返します。

@param args 構造体の初期値を指定します。メンバの初期値は指定されなければ nil です。

@return 構造体クラスのインスタンス。

@raise ArgumentError 構造体のメンバの数よりも多くの引数を指定した場合に発生します。

//emlist[例][ruby]{
Foo = Struct.new(:foo, :bar)
foo = Foo.new(1)
p foo.values # => [1, nil]
//}

• Struct

Syslog.#alert(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Syslog.#crit(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

絞り込み条件を変える

Syslog.#debug(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Syslog.#emerg(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Syslog.#err(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Syslog.#info(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

Syslog.#notice(message, *arg) -> self (4.0)

• 3.1

• モジュール関数

Syslog#log()のショートカットメソッド。 システムによっては定義されていないものもあります。

Syslog#log()のショートカットメソッド。
システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg)
と同じです。

@param message フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。

@param arg フォーマットされる引数です。

@raise ArgumentError 引数が1つ以上でない場合に発生します。

@raise RuntimeError syslog がop...

• Syslog

絞り込み条件を変える

Syslog::Level::LOG_ALERT -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

Syslog::Level::LOG_CRIT -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

Syslog::Level::LOG_DEBUG -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

Syslog::Level::LOG_EMERG -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

Syslog::Level::LOG_ERR -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

絞り込み条件を変える

Syslog::Level::LOG_INFO -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level

Syslog::Level::LOG_NOTICE -> Integer (4.0)

• 3.1

• 定数

優先度(priorities)を示す定数。 定数 の詳細については syslog(3) を参照してください。

優先度(priorities)を示す定数。
定数 の詳細については syslog(3) を参照してください。

• Syslog::Level