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

المراجعة الحالية بتاريخ 16:41، 26 نوفمبر 2018

يبحث التابع assoc ضمن الكائن Hash عن طريق موازنة الكائن المُمرَّر إليه بمفاتيحه باستخدام المعامل == ثم يعيد الزوج قيمة-مفتاح (مصفوفة من عنصرين) أو nil إذا لم يعثر على أي تطابق.

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

assoc(obj) → an_array or nil

المعاملات

`obj`

الكائن الذي يمثِّل المفتاح المراد البحث عنه ضمن الكائن Hash المعطى.

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

تعاد مصفوفة من عنصرين تحوي الزوج قيمة-مفتاح إن عُثِر على المفتاح المطابق لقيمة المعامل obj، أو تعاد القيمة nil لم يعثر على أي تطابق.

أمثلة

مثال على استعمال التابع assoc:

h = {"colors"  => ["red", "blue", "green"],
     "letters" => ["a", "b", "c" ]}
h.assoc("letters")  #=> ["letters", ["a", "b", "c"]]
h.assoc("foo")      #=> nil

انظر أيضا

التابع assoc: يبحث في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة nil في حالة عدم العثور على ذلك الكائن.
التابع rassoc: يبحث خلال الكائن Hash الذي استدعي معه عن طريق مقارنة القيمة التي مُمرِّرت إليه مع قيم ذلك الكائن باستخدام المعامل == ثم يعيد أول زوج قيمة-مفتاح متطابق.

مصادر

قسم التابع assoc في الصنف Hash في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Hash]]
-يعيد التابع <code>assoc</code> ت
+يبحث التابع <code>assoc</code> ضمن الكائن <code>[[Ruby/Hash|Hash]]</code> عن طريق موازنة الكائن المُمرَّر إليه بمفاتيحه باستخدام المعامل <code>[[Ruby/Hash/equal|==]]</code> ثم يعيد الزوج قيمة-مفتاح (مصفوفة من عنصرين) أو <code>nil</code> إذا لم يعثر على أي تطابق.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">assoc(obj) → an_array or nil</syntaxhighlight>
 ==المعاملات==
+=== <code>obj</code> ===
+الكائن الذي يمثِّل المفتاح المراد البحث عنه ضمن الكائن <code>[[Ruby/Hash|Hash]]</code> المعطى.
 ==القيمة المعادة==
-تعاد
+تعاد [[Ruby/Array|مصفوفة]] من عنصرين تحوي الزوج قيمة-مفتاح إن عُثِر على المفتاح المطابق لقيمة المعامل <code>obj</code>، أو تعاد القيمة <code>nil</code> لم يعثر على أي تطابق.
+== أمثلة ==
+مثال على استعمال التابع <code>assoc</code>:<syntaxhighlight lang="ruby">
+h = {"colors"  => ["red", "blue", "green"],
+     "letters" => ["a", "b", "c" ]}
+h.assoc("letters")  #=> ["letters", ["a", "b", "c"]]
+h.assoc("foo")      #=> nil
+</syntaxhighlight>
 ==انظر أيضا==
-*
+* التابع <code>[[Ruby/Array/assoc|assoc]]</code>: يبحث في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة <code>nil</code> في حالة عدم العثور على ذلك الكائن.
+* التابع <code>[[Ruby/Hash/rassoc|rassoc]]</code>: يبحث خلال الكائن <code>[[Ruby/Hash|Hash]]</code> الذي استدعي معه عن طريق مقارنة القيمة التي مُمرِّرت إليه مع قيم ذلك الكائن باستخدام المعامل <code>[[Ruby/Hash/equal|==]]</code> ثم يعيد أول زوج قيمة-مفتاح متطابق.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-assoc قسم التابع assoc في الصنف Hash في توثيق روبي الرسمي.]