التابع 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
في حالة عدم العثور على ذلك الكائن. - التابع
rassoc
: يبحث خلال الكائنHash
الذي استدعي معه عن طريق مقارنة القيمة التي مُمرِّرت إليه مع قيم ذلك الكائن باستخدام المعامل==
ثم يعيد أول زوج قيمة-مفتاح متطابق.