عرض مصدر Ruby/Fiber/transfer

{{DISPLAYTITLE:التابع <code>Fiber.transfer</code> في روبي}}
ينقل التّابع <code>transfer</code> التحكّم إلى ليف (fiber) آخر، أو يستأنف عمل الليف الحالي عند آخر نقطة أوقف فيها، أو يبدأه إذا لم يُستأنَف سابقًا. سيُعلَّق الليف المُستدعَى كما في استدعاء <code>[[Ruby/Fiber/yield|Fiber.yield]]</code>. يجب عليك طلب 'fiber' قبل استخدام هذا التّابع.

يعامل الليف طلب التحويل ( عبر <code>transfer</code>) الذي يستقبله على أنَّه نداء استئنافٍ. الوسائط المُمرَّرة من أجل التحويل تعامل كتلك المُمرَّرة من أجل الاستئناف.

لا يمكنك استئناف ليفٍ حُوِّل تحكمه إلى ليفٍ آخر. سيسبّب هذا خطأ استئنافٍ مضاعفٍ. عليك إعادة تحويل التحكّم إلى الليف الأول حتى تتمكن من توليده واستئنافه مجدَّدًا.

== البنية العامة ==
<syntaxhighlight lang="ruby">
transfer(args, ...) → obj
</syntaxhighlight>

== المعاملات ==

=== <code>args</code> ===
الوسائط المراد تمريرها.

=== <code>…</code> ===
الوسائط الأخرى الإضافية المراد تمريرها أيضًا.

== القيم المعادة ==
يعاد كائنُ.

== الأمثلة ==
مثالٌ عن استخدام التّابع <code>transfer</code>:<syntaxhighlight lang="ruby">
fiber1 = Fiber.new do
  puts "In Fiber 1"
  Fiber.yield
end

fiber2 = Fiber.new do
  puts "In Fiber 2"
  fiber1.transfer
  puts "Never see this message"
end

fiber3 = Fiber.new do
  puts "In Fiber 3"
end

fiber2.resume
fiber3.resume

</syntaxhighlight>سيعطي هذا المثال عند تنفيذه الناتج:<syntaxhighlight lang="ruby">
In fiber 2
In fiber 1
In fiber 3


</syntaxhighlight>

== انظر أيضا ==
* التابع <code>[[Ruby/Fiber/yield|yield]]</code>: يتحكم مجدَّدًا بالسياق (contex) الذي استئنَفَ عمل الليف (fiber) مُمرِّرًا أيَّ وسائط قد مُرِّرت إليه.
* التابع <code>[[Ruby/Fiber/resume|resume]]</code>: يستأنف الليف (fiber) من النقطة التي استدعُي فيها التّابع <code>[[Ruby/Fiber/yield|Fiber.yield]]</code> آخر مرّة.

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Fiber.html#method-i-transfer صفحة التابع transfer في الصنف Fiber في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Fiber]]