الفرق بين المراجعتين ل"Ruby/Array/new"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Array.new</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Arra...') |
|||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
تنشئ الدالة <code>ne</code><code>w</code> مصفوفةً جديدةً. | تنشئ الدالة <code>ne</code><code>w</code> مصفوفةً جديدةً. | ||
| − | + | البنية يالعامة | |
| − | < | + | <code>new</code>([[Ruby/Array/size | <code>size</code>]]=0, <code>default</code>=<code>nil</code>) |
| − | new(array) | + | <code>new</code>(<code>array</code>) |
| − | new(size) {|index| block } | + | <code>new</code>([[Ruby/Array/size | <code>size</code>]]) {|[[Ruby/Array/index | <code>index</code>]]| <code>block</code> } |
| − | إن لم تمرَّر أيَّة وسائط إلى الدالة | + | إن لم تمرَّر أيَّة وسائط إلى الدالة <code>ne</code><code>w</code>()، فستنشئ مصفوفة جديدة فارغة. إن مُرِّر الوسيطان [[Ruby/Array/size | <code>size</code>]] و <code>default</code> الذان يمثلان حجم المصفوفة والقيم الأولية لعناصرها، فستُنشَأ مصفوفة جديدة حجمها [[Ruby/Array/size | <code>size</code>]] ومكونة من القيم <code>default</code> المعطاة. لاحظ أنَّ جميع العناصر تشير إلى الكائن <code>default</code> نفسه. |
| − | first_array = ["Matz", "Guido"] | + | <code>first_array</code> = ["<code>"Matz"</code>", "<code>"Guido"</code>"] |
| − | تنشئ الدالة | + | تنشئ الدالة <code>ne</code><code>w</code>() أيضًا نسخة من مصفوفة أخرى عبر تمريرها كوسيط (تنشئ تلك المصفوفة عبر استدعاء التابع [[Ruby/Array/to_ary | <code>to_ary</code>]] مع الوسيط المعطى). |
| − | second_array = Array.new(first_array) #=> ["Matz", "Guido"] | + | <code>second_array</code> = [[Ruby/Array/Array | <code>Array</code>]].<code>new</code>(<code>first_array</code>) #=> ["<code>"Matz"</code>", "<code>"Guido"</code>"] |
| − | يمكن إنشاء مصفوفة بحجم size مع حساب قيمة كل عنصر عناصرها وذلك عبر تمرير فهرس العنصر إلى كتلة برمجية محددة. | + | يمكن إنشاء مصفوفة بحجم [[Ruby/Array/size | <code>size</code>]] مع حساب قيمة كل عنصر عناصرها وذلك عبر تمرير فهرس العنصر إلى كتلة برمجية محددة. |
| − | Array.new(3){ |index| index ** 2 } # => [0, 1, 4] | + | [[Ruby/Array/Array | <code>Array</code>]].<code>new</code>(3){ |[[Ruby/Array/index | <code>index</code>]]| [[Ruby/Array/index | <code>index</code>]] ** 2 } # => [0, 1, 4] |
| − | |||
==المعاملات== | ==المعاملات== | ||
[[Ruby/Array/size | <code>size</code>]] | [[Ruby/Array/size | <code>size</code>]] | ||
مراجعة 10:16، 3 سبتمبر 2018
تنشئ الدالة new مصفوفةً جديدةً.
البنية يالعامة
new( size=0, default=nil)
new(array)
new( size) {| index| block }
إن لم تمرَّر أيَّة وسائط إلى الدالة new()، فستنشئ مصفوفة جديدة فارغة. إن مُرِّر الوسيطان size و default الذان يمثلان حجم المصفوفة والقيم الأولية لعناصرها، فستُنشَأ مصفوفة جديدة حجمها size ومكونة من القيم default المعطاة. لاحظ أنَّ جميع العناصر تشير إلى الكائن default نفسه.
first_array = [""Matz"", ""Guido""]
تنشئ الدالة new() أيضًا نسخة من مصفوفة أخرى عبر تمريرها كوسيط (تنشئ تلك المصفوفة عبر استدعاء التابع to_ary مع الوسيط المعطى).
second_array = Array.new(first_array) #=> [""Matz"", ""Guido""]
يمكن إنشاء مصفوفة بحجم size مع حساب قيمة كل عنصر عناصرها وذلك عبر تمرير فهرس العنصر إلى كتلة برمجية محددة.
Array.new(3){ | index| index ** 2 } # => [0, 1, 4]
المعاملات
size
عدد صحيح يمثل حجم المصفوفة التي يراد إنشاؤها.
default
القيم الأولية لعناصر المصفوفة التي يراد إنشاؤها.
array
مصفوفة موجودة مسبقًا يراد إنشاء نسخةً أخرى منها.
القيم المعادة
تعاد المصفوفة التي أنشئت.
أخطاء شائعة
عند تمرير الوسيط الثاني، سيُستخدم الكائن نفسه كقيمة لجميع عناصر المصفوفة:
a = Array.new(2, Hash.new)
- => [{}, {}]
a[0]['cat'] = 'feline'
a # => [{""cat""=>""feline""}, {""cat""=>""feline""}]
a[1]['cat'] = 'Felix'
a # => [{""cat""=>""Felix""}, {""cat""=>""Felix""}]
لمَّا كانت جميع عناصر المصفوفة تُخزِّن قيمة Hash نفسها، فستؤثر التغييرات التي تطرأ على أيٍّ منها على جميع العناصر الأخرى.
إن كنت تريد عدة نسخ، فاستخدم الكتلة block، إذ يُستخدَم حينئذٍ ناتج تلك الكتلة في كل مرَّة يحتاج فيها أحد عناصر المصفوفة إلى التهيئة:
a = Array.new(2) { Hash.new }
a[0]['cat'] = 'feline'
a # => [{""cat""=>""feline""}, {}]
[ 1, 'a', /^A/ ] # => [1, ""a"", /^A/]
انظر أيضًا
- الدالة
Array[]: تنشئ مصفوفة جديدة.
مصادر
- قسم الدالة new في الصنف Array في توثيق روبي الرسمي.