class Exception (Ruby 1.9.3 リファレンスマニュアル)

このマニュアルは既にメンテナンスが終了したバージョンの Ruby を対象としています。最新版のマニュアルへ

要約

全ての例外の祖先のクラスです。

特異メソッド

new(error_message = nil) -> Exception[permalink][rdoc]

exception(error_message = nil) -> Exception

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

[PARAM] error_message:: エラーメッセージを表す文字列を指定します。このメッセージは属性 Exception#message の値になり、デフォルトの例外ハンドラで表示されます。

インスタンスメソッド

self == other -> bool[permalink][rdoc]

message と backtrace が == メソッドで比較して等しい場合に true を返します。そうでない場合に false を返します。

[PARAM] other:: 自身と比較したいオブジェクトを指定します。

backtrace -> [String][permalink][rdoc]

バックトレース情報を返します。

デフォルトでは

"#{sourcefile}:#{sourceline}:in `#{method}'" (メソッド内の場合)
"#{sourcefile}:#{sourceline}" (トップレベルの場合)

という形式の String の配列です。

def methd
  raise
end

begin
  methd
rescue => e
  p e.backtrace
end

#=> ["filename.rb:2:in `methd'", "filename.rb:6"]

exception -> self[permalink][rdoc]

exception(error_message) -> Exception

引数を指定しない場合は self を返します。引数を指定した場合自身のコピーを生成し Exception#message 属性を error_message にして返します。

Kernel.#raise は、実質的に、例外オブジェクトの exception メソッドの呼び出しです。

[PARAM] error_message:: エラーメッセージを表す文字列を指定します。

begin
 ...        # 何か処理
rescue => e
 raise e.exception("an error occurs during hogehoge process")  # 詳しいエラーメッセージ
end

inspect -> String[permalink][rdoc]

self のクラス名と message を文字列にして返します。

message -> String[permalink][rdoc]

to_s -> String

エラーメッセージをあらわす文字列を返します。

begin
  1 + nil
rescue => e
  p e.message   #=>  "nil can't be coerced into Fixnum"
end

set_backtrace(errinfo) -> nil | String | [String][permalink][rdoc]

バックトレース情報に errinfo を設定し、設定されたバックトレース情報を返します。

[PARAM] errinfo:: nil、String あるいは String の配列のいずれかを指定します。

追加されるメソッド

json_create(hash) -> Exception[permalink][rdoc] [added by json/add/core]

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

[PARAM] hash:: 適切なキーを持つハッシュを指定します。

taguri -> String[permalink][rdoc] [added by syck/rubytypes]

自身のタグ URI を返します。

taguri=(val)[permalink][rdoc] [added by syck/rubytypes]

自身のタグ URI を val に設定します。

[PARAM] val:: タグ URI を文字列で指定します。

to_json(*args) -> String[permalink][rdoc] [added by json/add/core]

自身を JSON 形式の文字列に変換して返します。

内部的にはハッシュにデータをセットしてから Hash#to_json を呼び出しています。

[PARAM] args:: 引数はそのまま Hash#to_json に渡されます。

[SEE_ALSO] Hash#to_json

to_yaml(opts = {}) -> String[permalink][rdoc] [added by syck/rubytypes]

自身を YAML ドキュメントに変換します。

[PARAM] opts:: YAML ドキュメント出力の際のオプションを指定します。オプションの詳細は Syck::Emitter#reset を参照してください。

yaml_new(klass, tag, val)[permalink][rdoc] [added by syck/rubytypes]

ライブラリ内部で使用します。

yaml_tag_subclasses? -> true[permalink][rdoc] [added by syck/rubytypes]

常に true を返します。

ライブラリ内部で使用します。

要約

目次

特異メソッド

インスタンスメソッド

追加されるメソッド