الفرق بين المراجعتين لصفحة: «Ruby/Kernel/Array»

من موسوعة حسوب
< Ruby‏ | Kernel
لا ملخص تعديل
ط مراجعة وتدقيق
 
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Kernel]]
[[تصنيف: Ruby Kernel]]
يعيد التابع <code>Array</code>  الوسيط المعطى <code>arg</code> (انظر فقرة البنية العامة) على شكل مصفوفة (<code>[[Ruby/Array|Array]]</code>).
يعيد التابع <code>Array</code>  المعامل الممرَّر إليه على شكل مصفوفة (<code>[[Ruby/Array|Array]]</code>).


في البدء يحاول التابع <code>Array</code> استدعاء <code>to_ary</code> على <code>arg</code>، ثم يستدعي <code>to_a</code>. إذا لم يستجب <code>arg</code> إلى كل من <code>to_ary</code> و <code>to_a</code>، فستُعاد مصفوفة <code>Array</code> أحادية تحتوي <code>arg</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">Array(arg)    → array‎</syntaxhighlight>في البدء، يحاول التابع <code>Array</code> استدعاء <code>to_ary</code> على <code>arg</code>، ثم يستدعي <code>to_a</code>. إذا لم يستجب <code>arg</code> إلى كل من <code>to_ary</code> و <code>to_a</code>، فستُعاد مصفوفة <code>Array</code> أحادية تحوي <code>arg</code>.


إذا لم تكن القيمة المٌعادة من <code>to_ary</code> أو <code>to_a</code> من الصنف [[Ruby/Array|<code>Array</code>]]، فسيٌطلق خطأ <code>TypeError</code>.
إذا لم تكن القيمة المٌعادة من <code>to_ary</code> أو <code>to_a</code> من الصنف [[Ruby/Array|<code>Array</code>]]، فسيٌطلق الخطأ <code>[[Ruby/TypeError|TypeError]]</code>.
 
==البنية العامة==
<syntaxhighlight lang="ruby">Array(arg)    → array‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>arg‎</code>===
===<code>arg‎</code>===


الكائن المراد تحويله إلى مصفوفة.
الكائن المراد تحويله إلى مصفوفة.
==القيمة المُعادة==
==القيمة المعادة==
يعيد التابع <code>Array</code> الوسيط المعطى <code>arg</code> على شكل مصفوفة.
يعاد المعامل <code>arg</code> المعطى على شكل مصفوفة.


==أمثلة==
==أمثلة==
سطر 27: سطر 25:
‎</syntaxhighlight>
‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* صفحة الصنف<code>[[Ruby/Kernel|Kernel]]</code>
* التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول المعامل الممرَّر إليه إلى جدول Hash.
* التابع <code>[[Ruby/Kernel/Hash|Hash]]</code>: يحول التابع <code>Hash</code> الوسيط <code>arg</code>  إلى قاموس (<code>Hash).</code>
==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-Array قسم التابع Array‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-Array قسم التابع Array‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 08:20، 15 نوفمبر 2018

يعيد التابع Array المعامل الممرَّر إليه على شكل مصفوفة (Array).

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

Array(arg)     array

في البدء، يحاول التابع Array استدعاء to_ary على arg، ثم يستدعي to_a. إذا لم يستجب arg إلى كل من to_ary و to_a، فستُعاد مصفوفة Array أحادية تحوي arg.

إذا لم تكن القيمة المٌعادة من to_ary أو to_a من الصنف Array، فسيٌطلق الخطأ TypeError.

المعاملات

arg‎

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

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

يعاد المعامل arg المعطى على شكل مصفوفة.

أمثلة

مثال على استخدام التابع Array‎:

Array(["a", "b"])  #=> ["a", "b"]
Array(1..5)        #=> [1, 2, 3, 4, 5]
Array(key: :value) #=> [[:key, :value]]
Array(nil)         #=> []
Array(1)           #=> [1]

انظر أيضا

  • التابع Hash: يحول المعامل الممرَّر إليه إلى جدول Hash.

مصادر