kind=added
names=transfer
visibility=public 

--- transfer(*args) -> object

自身が表すファイバーへコンテキストを切り替えます。

自身は [[m:Fiber#resume]] を呼んだファイバーの子となります。
[[m:Fiber#resume]] との違いは、ファイバーが終了したときや [[m:Fiber.yield]] が呼ばれたときは、
ファイバーの親へ戻らずにメインファイバーへ戻ります。

@param args メインファイバーから呼び出した [[m:Fiber#resume]] メソッドの返り値として渡したいオブジェクトを指定します。

@return コンテキスト切り替えの際に、[[m:Fiber#resume]] メソッドに与えられた引数を返します。

@raise FiberError 自身が既に終了している場合、コンテキストの切り替えが [[c:Thread]] クラスが表すスレッド間をまたがる場合、
                  [[m:Fiber#resume]] を呼んだファイバーがその親か先祖である場合に発生します。

例:

  require 'fiber'
  
  fr1 = Fiber.new do |v|
    :fugafuga
  end
  
  fr2 = Fiber.new do |v|
    fr1.transfer
    :fuga
  end
  
  fr3 = Fiber.new do |v|
    fr2.resume
    :hoge
  end
  
  p fr3.resume # => :fugafuga


