الفرق بين المراجعتين لصفحة: «Ruby/Array/try convert»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يحاول التابع | يحاول التابع <code>try_convert()</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>: | ||
<syntaxhighlight lang="ruby"> Array.try_convert([1]) #=> [1] | <syntaxhighlight lang="ruby"> Array.try_convert([1]) #=> [1] | ||
Array.try_convert("1") #=> nil | Array.try_convert("1") #=> nil | ||
| سطر 25: | سطر 26: | ||
</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, value]</code>. | ||
* التابع [[Ruby/Array/inspect | <code>inspect</code>]]: يحول مصفوفة إلى سلسلة نصية. | * التابع [[Ruby/Array/inspect | <code>inspect</code>]]: يحول مصفوفة إلى سلسلة نصية. | ||
مصادر | ==مصادر== | ||
* قسم الدالة try_convert() في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-c-try_convert قسم الدالة try_convert() في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 05:40، 2 أكتوبر 2018
يحاول التابع try_convert() أن يحوّل كائنًا إلى مصفوفة بالاستعانة بالتابع 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: يعيد نتيجة تحويل المصفوفة التي استُدعي عبرها إلى مصفوفة مكونة من أزواج[key, value]. - التابع
inspect: يحول مصفوفة إلى سلسلة نصية.