التابع Hash.assoc في روبي

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

مصادر