Ruby/Array/try convert

يحاول التابع try_convert()‎ أن يحوّل كائنًا obj إلى مصفوفة بالاستعانة بالتابع to_ary. يمكن كذلك استخدام هذا التابع للتحقق مما إذا كان الوسيط المُمرّر إليه مصفوفةً أم لا.

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

 try_convert(obj) → array or nil

المعاملات

obj

الكائن المراد تحويله إلى مصفوفة.

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

تعاد مصفوفة جديدة تضم محتوى الكائن obj، أو القيمة nil في حالة تعذر تحويل الكائن obj لسبب ما.

أمثلة

بعض الأمثلة لاستخدام التابع try_convert()‎:

 Array.try_convert([1])   #=> [1]
Array.try_convert("1")   #=> nil

if tmp = Array.try_convert(arg)
 # يكون الوسيط هنا مصفوفة
elsif tmp = String.try_convert(arg)
 # يكون الوسيط هنا سلسلة نصية
end

انظر أيضًا

• التابع to_ary: يعيد المصفوفة التي استُدعيت معه.
• التابع to_h: يعيد التابع to_h نتيجة تحويل المصفوفة التي استُدعي عبرها إلى مصفوفة مكونة من أزواج [key, value].
• التابع inspect: يحول مصفوفة إلى سلسلة نصية.

مصادر

• قسم الدالة try_convert()‎ في الصنف Array في توثيق روبي الرسمي.