検索結果

Exception#exception(error_message) -> Exception (81697.0)

• 2.4.0

• インスタンスメソッド

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

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

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

@param error_message エラーメッセージを表す文字列を指定します。

//emlist[例][ruby]{
begin
# ... # 何か処理
rescue => e
raise e.exception("an error occurs during hogeho...

• Exception

Exception#exception -> self (81397.0)

• 2.4.0

• インスタンスメソッド

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

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

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

@param error_message エラーメッセージを表す文字列を指定します。

//emlist[例][ruby]{
begin
# ... # 何か処理
rescue => e
raise e.exception("an error occurs during hogeho...

• Exception

DRb::DRbUnknown#exception -> DRb::DRbUnknownError (54307.0)

• 2.4.0

• インスタンスメソッド

マーシャリングされたオブジェクトが元のオブジェクトに変換できなかった、 ということを意味する例外オブジェクトを返します。

マーシャリングされたオブジェクトが元のオブジェクトに変換できなかった、
ということを意味する例外オブジェクトを返します。

この例外オブジェクトの DRb::DRbUnknownError#unknown を
呼び出すと、 self が返されます。

• DRb::DRbUnknown

Exception2MessageMapper#def_exception(exception_name, message_format, superclass = StandardError) -> Class (27676.0)

• 2.4.0

• インスタンスメソッド

exception_name という名前の例外クラスを定義します。

exception_name という名前の例外クラスを定義します。

@param exception_name 定義する例外クラスの名前をシンボルで指定します。

@param message_format メッセージのフォーマット。

@param superclass 定義する例外のスーパークラスを指定します。
省略すると StandardError を使用します。

• Exception2MessageMapper

Exception#cause -> Exception | nil (27307.0)

• 2.4.0

• インスタンスメソッド

self の前の例外(self が rescue 節や ensure 節の中で発生した例外の場合、 その前に発生していた元々の例外)を返します。存在しない場合は nil を返し ます。

self の前の例外(self が rescue 節や ensure 節の中で発生した例外の場合、
その前に発生していた元々の例外)を返します。存在しない場合は nil を返し
ます。

//emlist[例][ruby]{
begin
begin
raise "inner"
rescue
raise "outer"
end
rescue
p $! # => #<RuntimeError: outer>
p $!.cause # => #<RuntimeError: inner>
end
//}

• Exception

絞り込み条件を変える

Exception#backtrace_locations -> [Thread::Backtrace::Location] (27142.0)

• 2.4.0

• インスタンスメソッド

バックトレース情報を返します。Exception#backtraceに似ていますが、 Thread::Backtrace::Location の配列を返す点が異なります。

バックトレース情報を返します。Exception#backtraceに似ていますが、
Thread::Backtrace::Location の配列を返す点が異なります。

現状では Exception#set_backtrace によって戻り値が変化する事はあり
ません。

//emlist[例: test.rb][ruby]{
require "date"
def check_long_month(month)
return if Date.new(2000, month, -1).day == 31
raise "#{month} is not long month"
end
...

• Exception
• Thread::Backtrace::Location

Exception#==(other) -> bool (27076.0)

• 2.4.0

• インスタンスメソッド

自身と指定された other のクラスが同じであり、 message と backtrace が == メソッドで比較して 等しい場合に true を返します。そうでない場合に false を返します。

自身と指定された other のクラスが同じであり、
message と backtrace が == メソッドで比較して
等しい場合に true を返します。そうでない場合に false を返します。

@param other 自身と比較したいオブジェクトを指定します。
自身と異なるクラスのオブジェクトを指定した場合は
Exception#exception を実行して変換を試みます。

//emlist[例][ruby]{
require "date"
def check_long_month(month)
return if D...

• Exception

Exception#inspect -> String (27040.0)

• 2.4.0

• インスタンスメソッド

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

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

//emlist[例][ruby]{
begin
raise "exception"
rescue
p $!.inspect # => "#<RuntimeError: exception>"
end
//}

• Exception

Exception#backtrace -> [String] (27022.0)

• 2.4.0

• インスタンスメソッド

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

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

デフォルトでは

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

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

//emlist[例][ruby]{
def methd
raise
end

begin
methd
rescue => e
p e.backtrace
end

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

• Exception
• String

Exception#message -> String (27004.0)

• 2.4.0

• インスタンスメソッド

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

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

//emlist[例][ruby]{
begin
1 + nil
rescue => e
p e.message #=> "nil can't be coerced into Fixnum"
end
//}

• Exception

絞り込み条件を変える

Exception#set_backtrace(errinfo) -> nil | String | [String] (27004.0)

• 2.4.0

• インスタンスメソッド

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

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

@param errinfo nil、String あるいは String の配列のいずれかを指定します。

//emlist[例][ruby]{
begin
begin
raise "inner"
rescue
raise "outer"
end
rescue
$!.backtrace # => ["/path/to/test.rb:5:in `rescue in <main>'", "/path/to/test.rb:2:in `<main>'"]
$!.se...

• Exception
• String

Exception#to_json(*args) -> String (27004.0)

• 2.4.0

• インスタンスメソッド

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

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

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

@param args 引数はそのまま JSON::Generator::GeneratorMethods::Hash#to_json に渡されます。

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

begin
0/0
rescue => e
e.to_json # => "{\"json_class\":\"ZeroDivis...

• Exception

Exception#to_s -> String (27004.0)

• 2.4.0

• インスタンスメソッド

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

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

//emlist[例][ruby]{
begin
1 + nil
rescue => e
p e.message #=> "nil can't be coerced into Fixnum"
end
//}

• Exception

TracePoint#raised_exception -> Exception (18628.0)

• 2.4.0

• インスタンスメソッド

発生した例外を返します。

発生した例外を返します。

@raise RuntimeError :raise イベントのためのイベントフックの外側で実行し
た場合に発生します。

//emlist[例][ruby]{
trace = TracePoint.new(:raise) do |tp|
tp.raised_exception # => #<ZeroDivisionError: divided by 0>
end
trace.enable
begin
0/0
rescue
end
//}

• TracePoint

Thread#report_on_exception -> bool (18454.0)

• 2.4.0

• インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

デフォルトはスレッド作成時の Thread.report_on_exception です。

@param newstate スレッド実行中に例外発生した場合、その内容を報告するかどうかを true か false で指定します。

//emlist[例][ruby]{
a = Thread.new{ Thread.stop; raise }
a.report_on_exception = true
a.report_on_exception # => true
a.run
# => #<Th...

• Thread

絞り込み条件を変える

Thread#report_on_exception=(newstate) (18454.0)

• 2.4.0

• インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

真の場合、そのスレッドが例外によって終了した時に、その内容を $stderr に報告します。

デフォルトはスレッド作成時の Thread.report_on_exception です。

@param newstate スレッド実行中に例外発生した場合、その内容を報告するかどうかを true か false で指定します。

//emlist[例][ruby]{
a = Thread.new{ Thread.stop; raise }
a.report_on_exception = true
a.report_on_exception # => true
a.run
# => #<Th...

• Thread

Thread#abort_on_exception -> bool (18382.0)

• 2.4.0

• インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、インタプリタ 全体を中断させます。false の場合、あるスレッドで起こった例 外は、Thread#join などで検出されない限りそのスレッ ドだけをなにも警告を出さずに終了させます。

真の場合、そのスレッドが例外によって終了した時に、インタプリタ
全体を中断させます。false の場合、あるスレッドで起こった例
外は、Thread#join などで検出されない限りそのスレッ
ドだけをなにも警告を出さずに終了させます。

デフォルトは偽です。c:Thread#exceptionを参照してください。

@param newstate 自身を実行中に例外発生した場合、インタプリタ全体を終了させるかどうかを true か false で指定します。

//emlist[例][ruby]{
thread = Thread.new { sleep 1 }
thread.abort_o...

• Thread

Thread#abort_on_exception=(newstate) (18382.0)

• 2.4.0

• インスタンスメソッド

真の場合、そのスレッドが例外によって終了した時に、インタプリタ 全体を中断させます。false の場合、あるスレッドで起こった例 外は、Thread#join などで検出されない限りそのスレッ ドだけをなにも警告を出さずに終了させます。

真の場合、そのスレッドが例外によって終了した時に、インタプリタ
全体を中断させます。false の場合、あるスレッドで起こった例
外は、Thread#join などで検出されない限りそのスレッ
ドだけをなにも警告を出さずに終了させます。

デフォルトは偽です。c:Thread#exceptionを参照してください。

@param newstate 自身を実行中に例外発生した場合、インタプリタ全体を終了させるかどうかを true か false で指定します。

//emlist[例][ruby]{
thread = Thread.new { sleep 1 }
thread.abort_o...

• Thread

BigDecimal#save_exception_mode { ... } -> object (18307.0)

• 2.4.0

• インスタンスメソッド

例外処理に関する BigDecimal.mode の設定を保存してブロックを評価し ます。ブロック中で変更した設定はブロックの評価後に復元されます。

例外処理に関する BigDecimal.mode の設定を保存してブロックを評価し
ます。ブロック中で変更した設定はブロックの評価後に復元されます。

ブロックの評価結果を返します。

• BigDecimal

Exception2MessageMapper#def_e2message(exception_class, message_format) -> Class (9427.0)

• 2.4.0

• インスタンスメソッド

すでに存在する例外クラス exception_class に、 エラーメッセージ用フォーマット message_format を関連づけます。

すでに存在する例外クラス exception_class に、
エラーメッセージ用フォーマット message_format を関連づけます。

このフォーマットは Exception2MessageMapper#Raise,
Exception2MessageMapper#Fail で使用します。

@param exception_class メッセージを登録する例外クラスを指定します。

@param message_format メッセージのフォーマットを指定します。
Kernel.#sprintf のフォーマット文字列と同じ形式を使用できます...

• Exception2MessageMapper

絞り込み条件を変える

Exception2MessageMapper#Fail(exception_class = nil, *rest) -> () (9382.0)

• 2.4.0

• インスタンスメソッド

登録されている情報を使用して、例外を発生させます。

登録されている情報を使用して、例外を発生させます。

@param exception_class 例外クラス。

@param rest メッセージに埋め込む値。

@raise Exception2MessageMapper::ErrNotRegisteredException 指定された例外クラスに対応するメッセージが存在しない場合に発生します。

例:

class Foo
extend Exception2MessageMapper
p def_exception :NewExceptionClass, "message...%d, %d and %d" # =>...

• Exception2MessageMapper

Exception2MessageMapper#Raise(exception_class = nil, *rest) -> () (9382.0)

• 2.4.0

• インスタンスメソッド

登録されている情報を使用して、例外を発生させます。

登録されている情報を使用して、例外を発生させます。

@param exception_class 例外クラス。

@param rest メッセージに埋め込む値。

@raise Exception2MessageMapper::ErrNotRegisteredException 指定された例外クラスに対応するメッセージが存在しない場合に発生します。

例:

class Foo
extend Exception2MessageMapper
p def_exception :NewExceptionClass, "message...%d, %d and %d" # =>...

• Exception2MessageMapper

Exception2MessageMapper#fail(exception_class = nil, *rest) -> () (9343.0)

• 2.4.0

• インスタンスメソッド

登録されている情報を使用して、例外を発生させます。

登録されている情報を使用して、例外を発生させます。

@param exception_class 例外クラス。

@param rest メッセージに埋め込む値。

@raise Exception2MessageMapper::ErrNotRegisteredException 指定された例外クラスに対応するメッセージが存在しない場合に発生します。

• Exception2MessageMapper

Exception2MessageMapper#bind(cl) -> () (9004.0)

• 2.4.0

• インスタンスメソッド

@todo

@todo

@param cl xxx

• Exception2MessageMapper

Net::HTTPExceptions#response -> Net::HTTPResponse (9004.0)

• 2.4.0

• インスタンスメソッド

例外の原因となったレスポンスオブジェクトを返します。

例外の原因となったレスポンスオブジェクトを返します。

//emlist[例][ruby]{
require 'net/http'

uri = "http://www.example.com/invalid.html"
response = Net::HTTP.get_response(URI.parse(uri))
begin
response.value
rescue => e
e.response # => #<Net::HTTPNotFound 404 Not Found readbody=true>
end
//}

• Net::HTTPExceptions

絞り込み条件を変える

REXML::ParseException#context -> [Integer, Integer, Integer] (9004.0)

• 2.4.0

• インスタンスメソッド

パースエラーが起きた(XML上の)場所を返します。

パースエラーが起きた(XML上の)場所を返します。

要素3個の配列で、
[position, lineno, line]
という形で返します。
position, line は
REXML::ParseException#position
REXML::ParseException#line
と同じ値です。
lineno は IO#lineno が返す意味での行数です。
通常は line と同じ値です。

• REXML::ParseException

REXML::ParseException#line -> Integer (9004.0)

• 2.4.0

• インスタンスメソッド

パースエラーが起きた(XML上の)場所を行数で返します。

パースエラーが起きた(XML上の)場所を行数で返します。

• REXML::ParseException

REXML::ParseException#position -> Integer (9004.0)

• 2.4.0

• インスタンスメソッド

パースエラーが起きた(XML上の)場所を先頭からのバイト数で返します。

パースエラーが起きた(XML上の)場所を先頭からのバイト数で返します。

• REXML::ParseException

REXML::ParseException#to_s -> String (9004.0)

• 2.4.0

• インスタンスメソッド

例外情報を文字列化して返します。

例外情報を文字列化して返します。

• REXML::ParseException

SignalException#signm -> String (9004.0)

• 2.4.0

• インスタンスメソッド

self.message のエイリアスです。

self.message のエイリアスです。

//emlist[例][ruby]{
begin
Process.kill('HUP', Process.pid)
sleep
rescue SignalException => e
puts e.signm # => SIGHUP
end
//}

• SignalException

絞り込み条件を変える

SignalException#signo -> Integer (9004.0)

• 2.4.0

• インスタンスメソッド

self のシグナル番号を返します。

self のシグナル番号を返します。

//emlist[例][ruby]{
p Signal.signame(1) # => "HUP"
begin
Process.kill('HUP', Process.pid)
sleep
rescue SignalException => e
p e.signo # => 1
end
//}

• SignalException

StringIO#read_nonblock(maxlen, outbuf = nil, exception: true) -> String | nil (373.0)

• 2.4.0

• インスタンスメソッド

StringIO#readに似ていますが、 exception オプションに false を指定すると EOFError を発生させず nil を返します。

StringIO#readに似ていますが、 exception オプションに false を指定すると EOFError を発生させず nil を返します。

@param len 読み込みたい長さを整数で指定します。StringIO#read と同じです。

@param outbuf 読み込んだ文字列を出力するバッファを文字列で指定します。指定した文字列オブジェクトが
あらかじめ length 長の領域であれば、余計なメモリの割当てが行われません。指定した文字列の
長さが length と異なる場合、その文字列は一旦 length ...

• StringIO

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

• 2.4.0

• インスタンスメソッド

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

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

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

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

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

=== 注意

timeout に...

• Kernel
• Timeout::Error
• resolv-replace

ARGF.class#read_nonblock(maxlen, outbuf = nil, exception: true) -> String | Symbol | nil (325.0)

• 2.4.0

• インスタンスメソッド

処理中のファイルからノンブロッキングモードで最大 maxlen バイト読み込みます。 詳しくは IO#read_nonblock を参照してください。

処理中のファイルからノンブロッキングモードで最大 maxlen バイト読み込みます。
詳しくは IO#read_nonblock を参照してください。

ARGF.class#read などとは違って複数ファイルを同時に読み込むことはありません。

@param maxlen 読み込む長さの上限を整数で指定します。
@param outbuf 読み込んだデータを格納する String オブジェクトを指定します。
@param exception 読み込み時に Errno::EAGAIN、
Errno::EWOULDBLOCK が発生する代わりに
...

• ARGF.class
• Errno::EAGAIN
• String

Gem::SpecFetcher#warn_legacy(exception) { ... } -> bool (325.0)

• 2.4.0

• インスタンスメソッド

Gem::SpecFetcher#fetch で例外が発生した場合に呼び出されます。

Gem::SpecFetcher#fetch で例外が発生した場合に呼び出されます。

RubyGems 1.2 未満で作成したリポジトリにアクセスした事が原因で例外が発生した場合には
警告が表示されます。またこの場合、ブロックを与えていればブロックは評価されます。

それ以外の原因で例外が発生した場合は偽を返します。

@param exception 例外オブジェクトを指定します。

@see Gem::SpecFetcher#fetch

• Gem::SpecFetcher

絞り込み条件を変える

IO#read_nonblock(maxlen, outbuf = nil, exception: true) -> String | Symbol | nil (325.0)

• 2.4.0

• インスタンスメソッド

IO をノンブロッキングモードに設定し、 その後で read(2) システムコールにより 長さ maxlen を上限として読み込み、文字列として返します。 EAGAIN, EINTR などは Errno::EXXX 例外として呼出元に報告されます。

IO をノンブロッキングモードに設定し、
その後で read(2) システムコールにより
長さ maxlen を上限として読み込み、文字列として返します。
EAGAIN, EINTR などは Errno::EXXX 例外として呼出元に報告されます。

発生した例外 がErrno::EAGAIN、 Errno::EWOULDBLOCK である場合は、
その例外オブジェクトに IO::WaitReadable が Object#extend
されます。

なお、バッファが空でない場合は、read_nonblock はバッファから読み込みます。この場合、read(2) システムコールは呼ばれません...

• Errno::EAGAIN
• Errno::EXXX
• IO
• IO::WaitReadable

IO#write_nonblock(string, exception: true) -> Integer | :wait_writable (325.0)

• 2.4.0

• インスタンスメソッド

IO をノンブロッキングモードに設定し、string を write(2) システムコールで書き出します。

IO をノンブロッキングモードに設定し、string を write(2) システムコールで書き出します。

write(2) が成功した場合、書き込んだ長さを返します。
EAGAIN, EINTR などは例外 Errno::EXXX として呼出元に報告されます。

書き込んだバイト数(つまり返り値)は String#bytesize の
値より小さい可能性があります。

発生した例外 がErrno::EAGAIN、 Errno::EWOULDBLOCK である場合は、
その例外オブジェクトに IO::WaitWritable が Object#extend
されます。よって IO::Wai...

• Errno::EAGAIN
• Errno::EWOULDBLOCK
• Errno::EXXX
• IO
• IO::WaitWritable

Encoding::Converter#last_error -> Exception | nil (307.0)

• 2.4.0

• インスタンスメソッド

直前に変換器で発生した例外に相当する例外オブジェクトを返します。 直前の変換で例外が発生していない場合は nil を返します。

直前に変換器で発生した例外に相当する例外オブジェクトを返します。
直前の変換で例外が発生していない場合は nil を返します。

//emlist[][ruby]{
ec = Encoding::Converter.new("utf-8", "iso-8859-1")
p ec.primitive_convert(src="\xf1abcd", dst="") #=> :invalid_byte_sequence
p ec.last_error #=> #<Encoding::InvalidByteSequenceError: "\xF1" followed by "a"...

• Encoding::Converter

JSON::State#generate(obj) -> String (52.0)

• 2.4.0

• インスタンスメソッド

Generates a valid JSON document from object obj and returns the result. If no valid JSON document can be created this method raises a GeneratorError exception.

Generates a valid JSON document from object obj and returns the
result. If no valid JSON document can be created this method raises a
GeneratorError exception.

• JSON::State

Kernel#timeout(sec) {|i| .... } -> object (43.0)

• 2.4.0

• インスタンスメソッド

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

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

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

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

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

=== 注意

timeout に...

• Kernel
• Timeout::Error
• resolv-replace

絞り込み条件を変える

Gem::Commands::LockCommand#complain(message) -> () (22.0)

• 2.4.0

• インスタンスメソッド

指定されたメッセージを表示します。--strict が有効な場合は例外が発生します。

指定されたメッセージを表示します。--strict が有効な場合は例外が発生します。

@param message 表示するメッセージを指定します。

@raise Gem::Exception コマンドラインオプションに --strict が指定されている場合に発生します。

• Gem::Commands::LockCommand

Gem::Security::Policy#verify_gem(signature, data, chain, time = Time.now) -> Array (22.0)

• 2.4.0

• インスタンスメソッド

与えられたデータを与えられた署名と証明書チェーンで検証します。

与えられたデータを与えられた署名と証明書チェーンで検証します。

@param signature 署名を指定します。

@param data 検証するデータを指定します。

@param chain 検証で使用する証明書チェーンを指定します。

@param time この時刻に有効であることを検証する。

@raise Gem::Security::Exception 検証に失敗した場合に発生します。

• Gem::Security::Policy