الفرق بين المراجعتين لصفحة: «Ruby/Method/index»

من موسوعة حسوب
< Ruby‏ | Method
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>‎[]‎‎</code> الخاص بالصنف <code>Method</code> في روبي}}</noinclude> تصنيف: Ruby تصن...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
يستدعي التابع <code>[]</code> الكتلة البرمجية للتابع، ويضبط قيم وسائط الكتلة عند القيم المعطاة params باستخدام صياغة مشابهة لاستدعاء التوابع. يعيد التابع <code>[]</code> قيمة آخر تعبير تم تقييمه في الكتلة.
يستدعي معامل الفهرسة<code>[]</code> الكتلة البرمجية للتابع، ويضبط قيم وسائط الكتلة عند القيم المعطاة <code>params</code> باستخدام صياغة مشابهة لاستدعاء التوابع. ثم يعيد قيمة آخر تعبير تم تقييمه في الكتلة.


لاحظ أن <code>prc.()</code> يستدعي <code>prc.call()</code> مع الوسائط المعطاة. هي صياغة مختصرة لإخفاء "call".
لاحظ أن <code>prc.()</code> يستدعي <code>prc.call()</code> مع تمرير الوسائط المعطاة. وهي صياغة مختصرة لإخفاء التابع "<code>call</code>".
بالنسبة لكائنات procs الذي تم إنشاؤه باستخدام <code>lambda</code> أو <code>->()</code>، قسيُطلق خطأ إذا كان عدد الوسائط الممررة إلى proc غير مناسب. بالنسبة لكائنات proc التي تم إنشاؤها باستخدام <code>Proc.new</code> أو <code>Kernel.proc</code> ، يتم تجاهل الوسائط الإضافية بصمت، وتُعطى للوسائط غير المُمررة القيمة <code>nil</code>.


انظر أيضا <code>Proc#lambda?</code>.
بالنسبة للكائنات <code>procs</code> التي تم إنشاؤها باستخدام <code>lambda</code> أو ‎<code>->()‎‎‎</code>، قسيُطلق خطأ إذا كان عدد الوسائط الممررة إلى <code>proc</code> غير صحيح. بالنسبة لكائنات <code>proc</code> التي تم إنشاؤها باستخدام <code>[[Ruby/Proc/new|Proc.new]]</code> أو <code>[[Ruby/Kernel/proc|Kernel.proc]]</code> ، فسيتم تجاهل الوسائط الإضافية بصمت، وتُعطى للوسائط غير المُمررة القيمة <code>nil</code>.
 
انظر أيضا <code>[[Ruby/Proc/lambda-3F|Proc#lambda?]]‎</code>.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">prc[params,...]  → obj‎</syntaxhighlight>
<syntaxhighlight lang="ruby">prc[params,...]  → obj‎</syntaxhighlight>
==القيمة المُعادة==
==القيمة المُعادة==
يعيد قيمة آخر تعبير تم تقييمه في الكتلة.


==أمثلة==
==أمثلة==
مثال على استخدام التابع <code>[]‎</code>:
مثال على استخدام المعامل<code>[]‎</code>:
<syntaxhighlight lang="ruby">a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } }
<syntaxhighlight lang="ruby">a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } }
a_proc.call(9, 1, 2, 3)    #=> [9, 18, 27]
a_proc.call(9, 1, 2, 3)    #=> [9, 18, 27]
سطر 21: سطر 23:
a_proc.yield(9, 1, 2, 3)  #=> [9, 18, 27]‎</syntaxhighlight>
a_proc.yield(9, 1, 2, 3)  #=> [9, 18, 27]‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/Method/3D-3D-3D|===]]</code>: يستدعي  الكتلة مع تمرير المعامل <code>obj</code> كوسيط لـ proc مثل <code>Proc#call</code>.  يسمح لكائن proc أن يكون هدفًا للكتلة <code>when</code> في التعليمة case.
* التابع <code>[[Ruby/Method/arity|arity]]</code>: يعيد  مؤشرا لعدد الوسائط المقبولة من قبل التابع.
* التابع <code>[[Ruby/Method/arity|arity]]</code>: يعيد  مؤشرا لعدد الوسائط المقبولة من قبل التابع. يعيد عددًا صحيحًا غير سالب للتوابع التي تأخذ عددًا محددًا من الوسائطا. بالنسبة لتوابع روبي التي تأخذ عددًا متغيرًا من الوسائط، يًعاد العدد -n-1، حيث n هو عدد الوسائط المطلوبة. الوسائط المسماة (Keyword arguments) ستُعد وسيطاً إضافيًا واحدًا، وسيكون ذلك الوسيط إلزاميا إن كان أيٌّ من الوسائط المسماة كذلك. بالنسبة للتوابع المكتوبة بلغة C، سيُعاد العدد -1 إن كانت استدعاء تلك التوابع يأخذ عددًا متغيرًا من الوسائط.


==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Method.html#method-i-5B-5D قسم  التابع []‎ في الصنف Method‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Method.html#method-i-5B-5D <nowiki>قسم  المعامل []‎ في الصنف Method‎ في توثيق روبي الرسمي.</nowiki>]

مراجعة 19:46، 25 أكتوبر 2018

يستدعي معامل الفهرسة[] الكتلة البرمجية للتابع، ويضبط قيم وسائط الكتلة عند القيم المعطاة params باستخدام صياغة مشابهة لاستدعاء التوابع. ثم يعيد قيمة آخر تعبير تم تقييمه في الكتلة.

لاحظ أن ‎prc.()‎ يستدعي prc.call()‎ مع تمرير الوسائط المعطاة. وهي صياغة مختصرة لإخفاء التابع "call".

بالنسبة للكائنات procs التي تم إنشاؤها باستخدام lambda أو ‎->()‎‎‎، قسيُطلق خطأ إذا كان عدد الوسائط الممررة إلى proc غير صحيح. بالنسبة لكائنات proc التي تم إنشاؤها باستخدام Proc.new أو Kernel.proc ، فسيتم تجاهل الوسائط الإضافية بصمت، وتُعطى للوسائط غير المُمررة القيمة nil.

انظر أيضا Proc#lambda?.

البنية العامة

prc[params,...]   obj

القيمة المُعادة

يعيد قيمة آخر تعبير تم تقييمه في الكتلة.

أمثلة

مثال على استخدام المعامل[]‎:

a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } }
a_proc.call(9, 1, 2, 3)    #=> [9, 18, 27]
a_proc[9, 1, 2, 3]         #=> [9, 18, 27]
a_proc.(9, 1, 2, 3)        #=> [9, 18, 27]
a_proc.yield(9, 1, 2, 3)   #=> [9, 18, 27]‎

انظر أيضا

  • التابع arity: يعيد مؤشرا لعدد الوسائط المقبولة من قبل التابع.

مصادر