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

مراجعة 11:30، 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 في حالة عدم العثور على ذلك الكائن.
التابع compare_by_identity: يجعل الكائن 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/compare by identity|compare_by_identity]]</code>: يجعل الكائن <code>[[Ruby/Hash|Hash]]</code> يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/Hash.html#method-i-assoc قسم التابع assoc في الصنف Hash في توثيق روبي الرسمي.]