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

المراجعة الحالية بتاريخ 05:17، 18 نوفمبر 2018

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

لاحظ أنَّ ‎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: يعيد مؤشرًا لعدد المعاملات المقبولة من قبل التابع.
التابع call: يستدعي كتلة التابع الذي استٌدعي معه، ويضبط معاملات الكتلة عند القيم المعطاة باستخدام صياغة مشابهة لصياغة استدعاء التوابع ثم يعيد قيمة آخر تعبير تم تقييمه في الكتلة.

مصادر

قسم المعامل []‎ في الصنف Method‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>‎[]‎‎</code> الخاص بالصنف <code>Method</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: المعامل <code>‎[]‎‎</code> الخاص بالصنف <code>Method</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
-[[تصنيف: Ruby Method]]
+[[تصنيف: Ruby Operator]]
-[[تصنيف: Ruby Method]]
+[[تصنيف: Ruby Method Class]]
-يستدعي التابع <code>[]</code> الكتلة البرمجية للتابع، ويضبط قيم وسائط الكتلة عند القيم المعطاة params باستخدام صياغة مشابهة لاستدعاء التوابع. يعيد التابع <code>[]</code> قيمة آخر تعبير تم تقييمه في الكتلة.
+يستدعي معامل الفهرسة <code>[]</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>
-==القيمة المُعادة==
+==القيمة المعادة==
+تعاد قيمة آخر تعبير تم تقييمه في الكتلة.
 ==أمثلة==
-مثال على استخدام التابع <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[9, 1, 2, 3]         #=> [9, 18, 27]
@@ سطر 21: / سطر 21: @@
 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 إن كانت استدعاء تلك التوابع يأخذ عددًا متغيرًا من الوسائط.
+*التابع <code>[[Ruby/Method/call|call]]</code>: يستدعي كتلة التابع الذي استٌدعي معه، ويضبط معاملات الكتلة عند القيم المعطاة باستخدام صياغة مشابهة لصياغة استدعاء التوابع ثم يعيد قيمة آخر تعبير تم تقييمه في الكتلة.
 ==مصادر==
-*[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>]