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

Ruby 3.2 リファレンスマニュアル

class LocalJumpError

[edit]

要約

ブロックを伴わずに呼び出されたメソッドの中で yield を実行すると発生します。

def call_block
  yield 42
end
call_block  # => no block given (yield) (LocalJumpError)

また、Proc オブジェクト内で return や break を実行しようとしたとき、その飛び先となるはずのメソッド呼び出しがすでに終了している(またはそもそも存在しない)場合にも発生します。例えば、Proc オブジェクトを生成したメソッド呼び出しが終了した後に、その Proc オブジェクトに対して return を実行しようとした場合などです。

詳しくは 手続きオブジェクトの挙動の詳細/orphan な手続きオブジェクトの挙動 を参照してください。

目次

インスタンスメソッド

継承しているメソッド

Exceptionから継承している特異メソッド
Exceptionから継承しているメソッド

インスタンスメソッド

exit_value -> object[permalink][rdoc][edit]

例外 LocalJumpError を発生する原因となった break や return に渡した値を返します。

意図的に LocalJumpError を起こして exit_value を確認
def foo
  proc { return 10 }
end
  
begin
  foo.call
rescue LocalJumpError => err
  p err              # => #<LocalJumpError: unexpected return>
  p err.exit_value   # => 10
end

begin
  Proc.new { break 5 }.call
rescue LocalJumpError => err
  p err              # => #<LocalJumpError: break from proc-closure>
  p err.exit_value   # => 5
end
reason -> Symbol[permalink][rdoc][edit]

例外を発生させた原因をシンボルで返します。

返す値は以下のいずれかです。

  • :break
  • :redo
  • :retry
  • :next
  • :return
  • :noreason
意図的に LocalJumpError を起こして reason を確認
def foo
  proc { return 10 }
end
  
begin
  foo.call
rescue LocalJumpError => err
  p err              # => #<LocalJumpError: unexpected return>
  p err.reason       # => :return
end

begin
  Proc.new { break 5 }.call
rescue LocalJumpError => err
  p err              # => #<LocalJumpError: break from proc-closure>
  p err.reason       # => :break
end