الفرق بين المراجعتين لصفحة: «Ruby/Array/try convert»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يحاول التابع <code>try_convert</code>() أن يحوّل كائنًا <code>obj</code> إلى مصفوفة بالاستعانة بالتابع ()[[Ruby/Array/to_ary | <code>to_ary</code>]]. يمكن كذلك استخدام هذا التابع للتحقق مما إذا كان الوسيط المُمرّر إليه مصفوفةً أم لا. | يحاول التابع <code>try_convert</code>() أن يحوّل كائنًا <code>obj</code> إلى مصفوفة بالاستعانة بالتابع ()[[Ruby/Array/to_ary | <code>to_ary</code>]]. يمكن كذلك استخدام هذا التابع للتحقق مما إذا كان الوسيط المُمرّر إليه مصفوفةً أم لا. | ||
البنية العامة | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> try_convert(obj) → array or nil | <syntaxhighlight lang="ruby"> try_convert(obj) → array or nil | ||
</syntaxhighlight> | </syntaxhighlight> | ||
المعاملات | ==المعاملات== | ||
<code>obj</code> | <code>obj</code> | ||
الكائن المراد تحويله إلى مصفوفة. | الكائن المراد تحويله إلى مصفوفة. | ||
القيم المعادة | ==القيم المعادة== | ||
تعاد مصفوفة جديدة تضم محتوى الكائن <code>obj</code>، أو القيمة <code>nil</code> في حالة تعذر تحويل الكائن <code>obj</code> لسبب ما. | تعاد مصفوفة جديدة تضم محتوى الكائن <code>obj</code>، أو القيمة <code>nil</code> في حالة تعذر تحويل الكائن <code>obj</code> لسبب ما. | ||
أمثلة | ==أمثلة== | ||
بعض الأمثلة لاستخدام التابع <code>try_convert</code>(): | بعض الأمثلة لاستخدام التابع <code>try_convert</code>(): | ||
<syntaxhighlight lang="ruby"> Array.try_convert([1]) #=> [1] | <syntaxhighlight lang="ruby"> Array.try_convert([1]) #=> [1] | ||
| سطر 25: | سطر 25: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
انظر أيضًا | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/to_ary | <code>to_ary</code>]]: يعيد المصفوفة التي استُدعيت معه. | * التابع [[Ruby/Array/to_ary | <code>to_ary</code>]]: يعيد المصفوفة التي استُدعيت معه. | ||
* التابع [[Ruby/Array/to_h | <code>to_h</code>]]: يعيد التابع [[Ruby/Array/to_h | <code>to_h</code>]] نتيجة تحويل المصفوفة التي استُدعي عبرها إلى مصفوفة مكونة من أزواج [<code>key</code>, <code>value</code>]. | * التابع [[Ruby/Array/to_h | <code>to_h</code>]]: يعيد التابع [[Ruby/Array/to_h | <code>to_h</code>]] نتيجة تحويل المصفوفة التي استُدعي عبرها إلى مصفوفة مكونة من أزواج [<code>key</code>, <code>value</code>]. | ||
* التابع [[Ruby/Array/inspect | <code>inspect</code>]]: يحول مصفوفة إلى سلسلة نصية. | * التابع [[Ruby/Array/inspect | <code>inspect</code>]]: يحول مصفوفة إلى سلسلة نصية. | ||
مصادر | ==مصادر== | ||
* قسم الدالة try_convert() في الصنف Array في توثيق روبي الرسمي. | * قسم الدالة try_convert() في الصنف Array في توثيق روبي الرسمي. | ||
مراجعة 23:19، 1 سبتمبر 2018
يحاول التابع 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 في توثيق روبي الرسمي.