التابع Array.assoc‎ في روبي

يبحث التابع assoc في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة nil في حالة عدم العثور على ذلك الكائن. تُجرَى عملية الموازنة بين العنصر الأول من كل مصفوفة فرعية والكائن obj باستعمال المعامل ==.

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

 assoc(obj) → element_ary or nil

المعاملات

obj الكائن المراد البحث في العناصر الأولى من المصفوفات الفرعية.

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

تعاد أول مصفوفة فرعية يتساوى عنصرها الأول مع الكائن obj المعطى، أو القيمة nil إن لم يعثر على ذلك الكائن في العناصر الأولى من المصفوفات الفرعية الموجودة في المصفوفة المعطاة.

أمثلة

بعض الأمثلة على استخدام التابع any?‎:

 s1 = [ "colors", "red", "blue", "green" ]
s2 = [ "letters", "a", "b", "c" ]
s3 = "foo"
a  = [ s1, s2, s3 ]
a.assoc("letters")  #=> [ "letters", "a", "b", "c" ]
a.assoc("foo")      #=> nil

انظر أيضًا

• التابع rassoc: يبحث عن عنصر محدد في العناصر الثانية للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه ثم يعيد المصفوفة الفرعية التي يعثر فيها على ذلك العنصر‎.

مصادر

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