التابع Hash.assoc
في روبي
يبحث التابع 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
يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح.