نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
المصفوفات في PHP
المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...
المصفوفات في أردوينو
المصفوفة هي مجموعة من المتغيرات الموضوعة في وعاء واحد والتي يمكن الوصول إليها عبر رقم فهرس كلٍّ منها. يمكن أن تكون المصفوفات في لغة C، التي ترتكز عليها لغة أردونيو، معقدةً بعض الشيء ولكنَّ استعمال المصفوفات بأبسط شكل لها هو أمر سهل ويسير. إنشاء مصفوفة يوجد عدة طرائق لإنشاء مصفوفة منها: int myInts[6];
int myPins[] = {2, 4, 8, 3, 6};
int mySensVals[6] = {2, 4, -8, 3, 2};
char message[6] = "hello";
يمكنك التصريح عن مصفوفة دون تهيئتها ووضع قيم فيها كما في ...
المصفوفات في PHP
المصفوفة في PHP هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...
المصفوفات في PHP
تسمح لك هذه الدوال بالتعامل مع المصفوفات وتعديلها بطرائق عديدة. المصفوفات عنصر أساسي لتخزين وإدارة والتعامل مع مجموعاتٍ من المتغيرات. تدعم لغة PHP المصفوفات أحادية ومتعددة الأبعاد، ويمكن أن ينتجها المستخدم بنفسه أو أن يستخدم دوالًا أخرى لإنشائها. توجد كذلك دوال متخصصة للتعامل مع قواعد البيانات وملأ المصفوفات من نواتج استعلامات قواعد البيانات، وتعيد الكثير من الدوال مصفوفاتٍ أيضًا. رجاءً تصفَّح نوع البيانات الخاص بالمصفوفات من هذا التوثيق للحصول على شرح تفصيلي عن كيفية استعمال المصفوفات في لغة PHP. انظر ...
المصفوفات في Bash
إنشاء المصفوفات المصفوفة هي متغير يحتوي قيمًا متعددة، وأي متغير قد يُستخدم كمصفوفة، كذلك لا يوجد حد أقصى لحجم المصفوفة ولا يُشترط أن تُفهرس المتغيرات داخل المصفوفة أو تُعيَّن في وقت واحد، وقد تكون المصفوفات صفرية القاعدة أي يُفهرس أول عنصر برقم صفر. ينفَّذ التصريح غير المباشر عن المتغير (indirect declaration) باستخدام البنية اللغوية التالية: ARRAY[INDEXNR]=value
يعامَل المفهرِس INDEXER على أنه تعبير حسابي يجب أن يٌقدَّر بعدد موجب، ويتم التصريح الواضح (explicit declaration) للمصفوفة باستخدام أمر declare: declare -a ARRAYNAME
يُقبَل التصريح ...
عوامل المصفوفات في PHP
المثال الاسم النتيجة $a + $b الاندماج اندماج $a و $b. $a == $b المساواة TRUE إن كان $a و $b يمتلكان نفس أزواج مفتاح/قيمة. $a === $b التطابق TRUE إن كان $a و $b يمتلكان نفس أزواج مفتاح/قيمة وبنفس الترتيب ومن نفس النوع. $a != $b عدم المساواة TRUE إن كان $a و $b غير متساويين. $a <> $b عدم المساواة TRUE إن كان $a و $b غير متساويين. $a !== $b عدم التطابق TRUE إن كان $a و $b غير ...
مصفوفات البايتات في بايثون
مصفوفات البايتات bytearray هي الكائنات القابلة للتغيير والتي تقابل كائنات البايتات bytes. يُعيد الصّنف bytearray() (والذي يُعامَل مُعاملة الدّالة) مصفوفة بايتات جديدة، ويكون الصّنف تسلسُلًا قابلًا للتّغيير يحتوي على الأعداد الصّحيحة ضمن المدى 0 <= x < 256. ويملك مُعظم التّوابع التي تملكها التّسلسلات الأخرى (كالقوائم والصّفوف مثلًا)، والمشروحة في صفحة أنواع التسلسلات القابلة للتّغيير، إضافةً إلى امتلاك مُعظم التّوابع التي يملكها النّوع bytes. البنية العامة bytearray([source[, encoding[, errors]]])
المعاملات source مُعامل اختياريّ يُستعمل لتهيئة المصفوفة عبر عدّة طُرق مختلفة: ...
ترتيب المصفوفات في PHP
تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...
عوامل المصفوفات في PHP
المثال الاسم النتيجة $a + $b الاندماج اندماج $a و $b. $a == $b المساواة TRUE إن كان $a و $b يمتلكان نفس أزواج مفتاح/قيمة. $a === $b التطابق TRUE إن كان $a و $b يمتلكان نفس أزواج مفتاح/قيمة وبنفس الترتيب ومن نفس النوع. $a != $b عدم المساواة TRUE إن كان $a و $b غير متساويين. $a <> $b عدم المساواة TRUE إن كان $a و $b غير متساويين. $a !== $b عدم التطابق TRUE إن كان $a و $b غير ...
ترتيب المصفوفات في PHP
تحتوي لغة PHP على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...
تبديل المصفوفات بكائنات (Replace Array with Object)
تقنية إعادة التصميم هذه هي حالة خاصة من تبديل قيم البيانات إلى كائنات. المشكلة لديك مصفوفة تحتوي على أنواع مختلفة من البيانات. الحل استبدال المصفوفة بكائن يكون له حقول منفصلة لكل عنصر. مثال قبل إعادة التصميم احتواء المصفوفة row على نوعين مختلفين من البيانات (سلسلة نصية وعدد): في لغة Java: String[] row = new String[2];
row[0] = "Liverpool";
row[1] = "15";
في لغة C#: string[] row = new string[2];
row[0] = "Liverpool";
row[1] = "15";
في لغة PHP: $row = array();
$row[0] = "Liverpool";
$row[1] = 15;
في لغة ...
الصنف Array في روبي
المصفوفات هي مجموعات مُرتَّبة ومُفهرسة بالأعداد الصحيحة (integer-indexed) ومُكونة من أي نوع من الكائنات. تبدأ فهارس المصفوفات بالعدد 0، كما هو الحال في لغتي C و Java. ويفترض أن يُحسب الفهرس السالب بدءًا من نهاية المصفوفة، أي أنَّ الفهرس ذا القيمة -1 يشير إلى العنصر الأخير في المصفوفة، والفهرس -2 يمثل موضع العنصر ما قبل الأخير، وهلم جرًا. إنشاء المصفوفات يمكن إنشاء مصفوفة جديدة باستخدام المعامل [] الباني. يمكن أن تحتوي المصفوفة نفسها على أنواع مختلفة من الكائنات. على سبيل ...
عمليات البايتات ومصفوفات البايتات في بايثون
تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc"
b = a.replace("a", "f")
و: ...
عمليات البايتات ومصفوفات البايتات في بايثون
تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc"
b = a.replace("a", "f")
و: ...
Python/array
تعرف هذه الوحدة كائنًا يمكن عن طريقه تمثيل مصفوفة من القيم الأساسية مثل الحروف والأعداد الصحيحة والأعداد ذات الفاصلة العائمة بشكل مضغوط. تعد المصفوفات نوعًا من أنواع التسلسلات وتشبه القوائم في عملها على نحو كبير، باستثناء أن أنواع الكائنات التي يمكن تخزينها في المصفوفات محدودة. أنواع الكائنات التي يمكن تخزينها في المصفوفات يجب تحديد نوع الكائنات عند إنشاء المصفوفة وذلك باستخدام رمز النوع وهو عبارة عن حرف واحد فقط. يبين الجدول التالي رموز الأنواع المتاحة: رمز النوع النوع في لغة ...
التابع Array.[] الباني في روبي
ينشئ التابع Array.[] مصفوفةً جديدةً تحوي الكائنات المُمرّرة إليها. القيم المعادة تعاد مصفوفة جديدة تحوي الكائنات المعطاة. أمثلة مثالٌ يوضح عدة طرائق لاستعمال الدالة Array.[] في إنشاء مصفوفة: Array.[]( 1, 'a', /^A/ ) # => [1, "a", /^A/]
Array[ 1, 'a', /^A/ ] # => [1, "a", /^A/]
[ 1, 'a', /^A/ ] # => [1, "a", /^A/]
انظر أيضًا الدالة new(): تنشئ مصفوفةً جديدةً. مصادر قسم التابع Array.[] في الصنف Array في توثيق روبي الرسمي.
التابع Array.[] الباني في روبي
ينشئ التابع Array.[] مصفوفةً جديدةً تحوي الكائنات المُمرّرة إليها. القيم المعادة تعاد مصفوفة جديدة تحوي الكائنات المعطاة. أمثلة مثالٌ يوضح عدة طرائق لاستعمال الدالة Array.[] في إنشاء مصفوفة: Array.[]( 1, 'a', /^A/ ) # => [1, "a", /^A/]
Array[ 1, 'a', /^A/ ] # => [1, "a", /^A/]
[ 1, 'a', /^A/ ] # => [1, "a", /^A/]
انظر أيضًا التابع new(): ينشئ مصفوفةً جديدةً. مصادر قسم التابع [] في الصنف Array في توثيق روبي الرسمي.
الكائن Array في JavaScript
الكائن Array يُستخدَم في إنشاء المصفوفات، والتي هي قوائم شبيهة بالكائنات. إنشاء مصفوفة var fruits = ['Apple', 'Banana'];
console.log(fruits.length);
// 2
الوصول إلى عنصر من عناصر المصفوفة var first = fruits[0];
// Apple
var last = fruits[fruits.length - 1];
// Banana
المرور على عناصر المصفوفة بحلقة تكرار fruits.forEach(function(item, index, array) {
console.log(item, index);
});
// Apple 0
// Banana 1
إضافة عنصر في نهاية المصفوفة var newLength = fruits.push('Orange');
// ["Apple", "Banana", "Orange"]
إزالة عنصر من نهاية المصفوفة var last = fruits.pop(); // إزالة Orange (من النهاية)
// ["Apple", ...
الدالة array() في PHP
(PHP 4, PHP 5, PHP 7) تنشئ الدالة array() مصفوفة جديدة. الوصف array array ([ mixed $... ] )
تنشئ هذه الدالة مصفوفة جديدة. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array. المعاملات ... يُعرَّف التركيب "الفهرس => القيم" كلًا من الفهرس والقيمة المقابلة وتفصل الفاصلة , بين تلك الأزواج. قد يكون الفهرس من نوع السلاسل النصية أو الأعداد الصحيحة. إذا حُذِفَ الفهرس فسيتولّد فهرس من نوع الأعداد الصحيحة تلقائيًا بدءًا من 0. وإذا كان الفهرس عددًا صحيحًا، فسيكون ...
المعامل - الخاص بالصنف Array في روبي
يعيد المعامل - مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة الأخرى. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. يوازن المعامل - العناصر باستخدام التابعين ()hash و ()eql? للحصول على أعلى كفاءة. البنية العامة ary - other_ary → new_ary
القيم المعادة تعاد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى. أمثلة مثالٌ عن استعمال المعامل -: [ 1, 1, 2, 2, 3, 3, ...
المعامل + الخاص بالصنف Array في روبي
يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة ary + other_ary → new_ary
القيم المعادة تعاد مصفوفة جديدة تضم المصفوفة ary والمصفوفة other_ary معًا. أمثلة مثالٌ عن استخدام المعامل +: [ 1, 2, 3 ] + [ 4, 5 ] #=> [ 1, 2, 3, 4, 5 ]
a = [ "a", "b", "c" ]
c = a + [ "d", "e", "f" ]
c ...
المعامل <=> الخاص بالصنف Array في روبي
يعيد معامل الموازنة <=> عددًا صحيحًا (-1 أو 0 أو +1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي. يوازن كل كائن من كل مصفوفة باستخدام المعامل <=>. يوازن بين المصفوفات عنصرًا عنصرًا؛ بعبارة أخرى، يوازن العنصر الأول من المصفوفة الأولى مع العنصر الأول من المصفوفة الثانية باستخدام المعامل <=>، ثم يوازن العنصر الثاني فالثالث وهكذا دواليك. متى ما أعطيت نتيجة مغايرة للصفر لأيٍّ من تلك الموازنات التي تجرى على العناصر تباعًا ...
المعامل & الخاص بالصنف Array في روبي
يعيد المعامل & مصفوفةً جديدةً تحتوي على العناصر المشتركة بين مصفوفتين دون تكرارها. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. توازن العناصر باستخدام التابعين ()hash و ()eql? للحصول على أعلى كفاءة. البنية العامة ary & other_ary → new_ary
القيم المعادة تعاد مصفوفة جديدة تحتوي على العناصر المشتركة بين المصفوفة ary والمصفوفة other_ary دون تكرارها. أمثلة مثالٌ عن استخدام المعامل &: [ 1, 1, 3, 5 ] & [ 3, 2, 1 ] ...
المعامل * الخاص بالصنف Array في روبي
إن استعمل المعامل * مع مصفوفة وسلسلة نصية، فسيُكافئ حينئذٍ العبارة ary.join(str). أمَّا إن استعمل مع مصفوفة وعدد، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. البنية العامة ary * int → new_ary
ary * str → new_string
القيم المعادة تعاد مصفوفة أو سلسلة نصية جديدة. أمثلة مثالٌ عن استخدام المعامل * مرةً مع عدد وأخرى مع سلسلة نصية: [ 1, 2, 3 ] * 3 #=> [ 1, 2, ...
المعامل >> الخاص بالصنف Array في روبي
يضيف المعامل >> كائنًا مُحدَّدًا إلى نهاية المصفوفة الأصلية ثم يعيد المصفوفة نفسها، لذا يمكن تكرار هذا المعامل عدة مرات وبشكل متسلسل. البنية العامة ary << obj → ary
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj إليها. أمثلة أمثلة عن استخدام المعامل >>: a = [ 1, 2 ]
a << "c" << "d" << [ 3, 4 ]
#=> [ 1, 2, "c", "d", [ 3, 4 ] ...
المعامل == الخاص بالصنف Array في روبي
يتحقق المعامل == من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل عنصر من المصفوفة الأولى مساويًا لنظيره في المصفوفة الثانية. البنية العامة ary == other_ary → bool
القيم المعادة تُعاد القيمة true المنطقية إن كانت المصفوفتان متساويتين، أو القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: [ "a", "c" ] == [ "a", "c", 7 ] #=> false
[ "a", "c", ...
معامل التعيين [] الخاص بالصنف Array في روبي
يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة -1 فهرس العنصر الأخير. بالنسبة للوسيطين ...
معامل الفهرسة [] الخاص بالصنف Array في روبي
يجلب المعامل [] عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة -1 فهرس العنصر الأخير. بالنسبة للوسيطين start و range، يكون فهرس البداية قبل العنصر. إضافةً إلى ذلك، ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة ary[index] → obj or nil
ary[start, length] → new_ary or nil
ary[range] → new_ary ...
معامل التعيين [] الخاص بالصنف Array في روبي
يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة -1 فهرس العنصر الأخير. بالنسبة للوسيطين ...
التابع Array.product في روبي
يوزِّع التابع product عناصر المصفوفة التي استدعيت معه على جميع عناصر المصفوفات الممرَّرة إليه. طول المصفوفة الناتجة يساوي جداء طول المصفوفة التي استُدعيت مع التابع بأطوال المصفوفات المُمرّرة إليه. عندما يُستدعى التابع product مع كتلة برمجية، فسيُعِدّ التابع كل التبديلات الممكنة بين عناصر المصفوفات ثم يعيد المصفوفة نفسها. البنية العامة product(other_ary, ...) → new_ary
product(other_ary, ...) { |p| block } → ary
المعاملات other_ary مصفوفة يراد توزيع عناصر المصفوفة المعطاة على عناصرها. … مصفوفات أخرى يراد توزيع عناصر المصفوفة المعطاة ...
التوابع في روبي
تتضمّن التوابع في لغة روبي الوظائف التي يقوم بها برنامجك. إليك هذا المثال لتعريف تابع بسيط: def one_plus_one
1 + 1
end
تعريف التابع يتكوّن من الكلمة المحجوزة def يتبعها اسم التابع، ثمّ جسم التابع، فالقيمة المعادة وفي النهاية الكلمة المحجوزة end. فعند تنفيذ التابع في المثال السابق، ستُعاد القيمة 2. هذا القسم سيغطّي تعريف التّوابع. ارجع إلى توثيق استدعاء التوابع لتتعرف على الصيغ المستخدمة لذلك الغرض. تسمية التوابع يمكن أن تستخدم لاسم التابع أحد المعاملات، وإلا فعليك أن تبتدئه بحرف أبجديّ أو ...
التابع Array.zip في روبي
يحول التابع zip الوسائط الممرَّرة إليه إلى مصفوفات ثم يدمج عناصر المصفوفة التي استُدعيت معه مع العناصر المقابلة في الوسائط (المصفوفات) المُمرَّرة. يولد هذا التابع عددًا من المصفوفات تحوي كلًّا منها n عنصر، إذ n هو عدد الوسائط الممررة مضافًا إليها 1. إن كان حجم أحد الوسائط أصغر من حجم المصفوفة الأصلية، فسيعوض التابع القيمة nil مكان القيم الناقصة. في حال تمرير كتلة برمجية كوسيط، ستُستدعى تلك الكتلة مع كل مصفوفة من المصفوفات الناتجة عن عملية الدمج، وإلا فستعاد تلك ...
التابع Array.shift في روبي
يحذف التابع shift أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. إن مرِّر عدد n كوسيط إلى التابع shift، فسيحذف أول n عنصر من المصفوفة ثمَّ يعيدها في مصفوفة جديدة وهذا مشابه تمامًا لاستدعاء التابع slice! بالشكل: array.slice!(0, n). ستحتوي المصفوفة الأصلية حينئذٍ العناصر المتبقية فقط دون العناصر التي أزيحت ووُضعت في المصفوفة الجديدة المُعادة. البنية العامة shift → obj or nil
shift(n) → new_ary
المعاملات n عدد صحيح يمثل عدد العناصر ...
التابع Array.rotate في روبي
يعيد التابع rotate مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. إن كان العدد الممرر إليها سالبًا، فسيُدوّر التابع rotate المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو -1. البنية العامة rotate(count=1) → new_ary
المعاملات count عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. القيمة المعادة تعاد مصفوفة ...
التابع Array.concat في روبي
يضيف التابع concat جميع عناصر المصفوفات المُمرّرة إليه إلى المصفوفة التي استُدعيت معه. البنية العامة concat(other_ary1, other_ary2,...) → ary
المعاملات other_ary1 المصفوفة الأولى المراد إضافة عناصرها إلى المصفوفة المعطاة. other_ary2 المصفوفة الثانية المراد إضافة عناصرها إلى المصفوفة المعطاة. … المصفوفات الأخرى المراد إضافة عناصرها إلى المصفوفة المعطاة. القيم المعادة تعاد المصفوفة المعطاة بعد إضافة المصفوفات other_ary1 و other_ary2 ...إلخ. المُمرَّرة إلى التابع إليها. أمثلة أمثلة على استخدام التابع concat: [ "a", "b" ].concat( ["c", "d"] ) #=> [ ...
التابع Array.pop في روبي
يحذف التابع pop آخر عنصر أو آخر n عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. البنية العامة pop → obj or nil
pop(n) → new_ary
المعاملات n عدد صحيح يحدد عدد العناصر الأخيرة التي يراد حذفها من المصفوفة المعطاة. القيم المعادة يعاد العنصر المحذوف من آخر المصفوفة المعطاة، أو مصفوفة جديدة تحوي العناصر n الأخيرة المحذوفة من المصفوفة، أو القيمة nil إن كانت المصفوفة فارغة. أمثلة أمثلة على استخدام التابع pop: a = [ "a", "b", ...
التابع Array.transpose في روبي
يفترض التابع transpose أنَّ المصفوفة التي استُدعيت معه مكونةٌ من مصفوفات فيعمل على قلب (transposes) الأعمدة إلى أسطر والأسطر إلى أعمدة. البنية العامة transpose → new_ary
القيم المعادة تعاد مصفوفة جديدة تحوي المصفوفات الفرعية الموجودة في المصفوفة المعطاة بعد قلب أعمدتها إلى أسطر وأسطرها إلى أعمدة. أمثلة مثالٌ على استخدام التابع transpose: a = [[1,2], [3,4], [5,6]]
a.transpose #=> [[1, 3, 5], [2, 4, 6]]
انظر أيضًا التابع reverse: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...
التابع Array.reverse في روبي
يعكس التابع reverse ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة جديدة. البنية العامة reverse → new_ary
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة ولكن بترتيب معكوس. أمثلة أمثلة على استخدام التابع reverse: [ "a", "b", "c" ].reverse #=> ["c", "b", "a"]
[ 1 ].reverse #=> [1]
انظر أيضًا التابع reverse!:يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. التابع rotate: ...
التابع Array.sort في روبي
يرتب التابع sort عناصر المصفوفة التي استُدعيت معه ويعيدها في مصفوفة جديدة. ستجرى عملية الموازنة بين عناصر المصفوفة المراد ترتيبها باستعمال المعامل <=> أو باستعمال كتلة برمجية محددة. إن استعملت الكتلة البرمجية block في ترتيب العناصر، فيجب أن تجري موازنة بين العنصر a والعنصر b وتعيد عددًا سالبًا إن كان b أكبر من a، أو العدد 0 إن كانا متساويين، أو عددًا موجبًا إن كان b أصغر من a. مع ذلك، لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن ...
التابع Array.first في روبي
يجلب التابع first أول عنصر أو أول n عنصر من مصفوفة. البنية العامة first → obj or nil
first(n) → new_ary
المعاملات n عدد صحيح يحدد عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأول من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي أول n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة أمثلة ...
التابع Array.initialize_copy في روبي
يبدل التابع initialize_copy محتوى المصفوفة المُمرّرة إليه مكان محتوى المصفوفة التي استُدعيت معه مع تغيير طول المصفوفة عند الضرورة. البنية العامة initialize_copy(other_ary) → ary
المعاملات other_ary المصفوفة التي ستحل محتوياتها مكان كامل محتويات المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة مع تغيير محتواها إلى محتوى المصفوفة other_ary. أمثلة مثالٌ على استخدام التابع initialize_copy: a = [ "a", "b", "c", "d", "e" ]
a.initialize_copy([ "x", "y", "z" ]) #=> ["x", "y", "z"]
a ...
الدالة Array.new في روبي
تنشئ الدالة 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 مع الوسيط المعطى). ...
التابع Array.reject في روبي
يعيد التابع reject مصفوفة جديدة تحتوي جميع عناصر المصفوفة التي استُدعيت معها والتي لم تحقق شرطًا محددًا. يُحافَظ على ترتيب العناصر المرفوضة المعادة بنفس ترتيبها كما كانت في المصفوفة الأصلية. إن لم تُمرَّر أية كتلة إلى التابع reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject {|item| block } → new_ary
reject → Enumerator
القيم المعادة تعاد مصفوفة جديد تحوي جميع عناصر المصفوفة المعطاة التي لم تعاد معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع ...
التابع Array.combination في روبي
يجمِّع التابع combination عناصر المصفوفة المعطاة مع بعضها بعضًا في مصفوفات بطول يساوي القيمة n الممررة إليه ثم يضع هذه المصفوفات في المصفوفة نفسها المعطاة ويعيدها. لا يوجد أي ضمان للتنبؤ بترتيب العناصر المجمَّعة المعادة. إن لم تمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة combination(n) { |c| block } → ary
combination(n) → Enumerator
المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تجميع عناصر المصفوفة المعطاة ضمنها. القيم المعادة تعاد المصفوفة ...
التابع Array.map في روبي
يستدعي التابع map كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع الناتج الذي تعيده هذه الكتلة لكل عنصر في مصفوفة جديدة وتعيدها. إن لم تمرَّر أية كتلة إلى التابع map، فسيعيد كائنًا من النوع Enumerator. البنية العامة map { |item| block } → new_ary
map → Enumerator
القيم المعادة تعاد مصفوفة جديدة تحوي ناتج تطبيق الكتلة block على كل عنصر من عناصر المصفوفة المعطاة، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة أمثلة ...
التابع Array.drop في روبي
يحذف التابع drop أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. إن مرِّر عددٌ سالبٌ إلى هذا التابع، فسيُطلَق الخطأ ArgumentError. البنية العامة drop(n) → new_ary
المعاملات n عدد صحيح يحدد عدد العناصر الأولى المراد حذفها من المصفوفة. القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء أول n عنصر منها. أمثلة مثالٌ على استخدام التابع drop: a = [1, 2, 3, 4, 5, 0]
a.drop(3) ...
التابع Array.reverse! في روبي
يعكس التابع reverse! ترتيب عناصر المصفوفة التي استُدعيت معه. البنية العامة reverse! → ary
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد عكس ترتيب عناصرها. أمثلة أمثلة على استخدام التابع reverse!: a = [ "a", "b", "c" ]
a.reverse! #=> ["c", "b", "a"]
a #=> ["c", "b", "a"]
انظر أيضًا التابع reverse: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...
التابع Array.map! في روبي
يستدعي التابع !map كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي طُبِّقَت عليه. إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة map! {|item| block } → ary
map! → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة block عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من النوع ...
التابع Array.unshift في روبي
يضيف التابع unshift الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. البنية العامة unshift(obj, ...) → ary
المعاملات obj الكائن المراد إضافته في بداية المصفوفة المعطاة. … الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj والكائنات الأخرى الممررة إلى بدايتها. أمثلة بعض أمثلة على استخدام التابع unshift: a = [ "b", "c", "d" ]
a.unshift("a") #=> ["a", "b", "c", "d"]
a.unshift(1, 2) ...
التابع Array.assoc في روبي
يبحث التابع assoc في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة nil في حالة عدم العثور على ذلك الكائن. تُجرَى عملية الموازنة بين العنصر الأول من كل مصفوفة فرعية والكائن obj باستعمال المعامل . البنية العامة assoc(obj) → element_ary or nil
المعاملات obj الكائن المراد البحث في العناصر الأولى من المصفوفات الفرعية. القيم المعادة تعاد أول مصفوفة ...
التابع Array.prepend في روبي
يعدُّ هذا التابع اسمًا بديلًا للتابع unshift. انظر أيضًا التابع unshift: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. التابع push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. التابع shift: يحذف أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع take: يعيد أول ...
التابع Array.join في روبي
يجمع التابع join جميع عناصر المصفوفة التي استُدعيت معها سويةً في سلسلة نصية ويفصل بينها بفاصل معين. البنية العامة join(separator=$,) → str
المعاملات separator المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي nil، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من separator و $ هي nil، فسيستخدم التابع سلسلة نصية فارغة كفاصل. القيم المعادة تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل separator. ...
التابع Array.sample في روبي
يختار التابع sample عنصرًا واحدًا أو عدة عناصر بشكل عشوائي من المصفوفة التي استُدعيت معه. يتم اختيار العناصر باستخدام فهارس عشوائية وفريدة لضمان عدم اختيار العنصر نفسه مجدَّدًا ما لم تحتوِ المصفوفة على عناصر متكررة. البنية العامة sample → obj
sample(random: rng) → obj
sample(n) → new_ary
sample(n, random: rng) → new_ary
المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي للأعداد التي تمثل فهارس العناصر العشوائية المراد جلبها. قيمته الافتراضية هي: rng. n عدد صحيح يحدد عدد العناصر العشوائية المراد ...
التابع Array.reject! في روبي
يحذف التابع reject! جميع عناصر المصفوفة التي لم تحقق شرطًا محددًا. قد لا تتغيير المصفوفة مباشرةً في كل مرة تستدعى فيها الكتلة block الممرَّرة إلى التابع. إن لم تُمرَّر أية كتلة إلى التابع !reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject! { |item| block } → ary or nil
reject! → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف عناصرها التي لم تعاد معها القيمة true عند تطبيق الكتلة bloc عليها، أو تعاد القيمة nil إن لم يحذف أي ...
التابع Array.try_convert() في روبي
يحاول التابع 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)
...
التابع Array.slice في روبي
يجلب التابع slice عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة -1 فهرس العنصر الأخير. ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة slice(index) → obj or nil
slice(start, length) → new_ary or nil
slice(range) → new_ary or nil
المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. ...
التابع Array.permutation في روبي
يعيد التابع permutation كل التبديلات (permutations) الممكنة لجميع عناصر مصفوفة، أو كل التبديلات المكونة من n عنصر من عناصر المصفوفة فقط ثم يعيد المصفوفة نفسها. لا يوجد أي ضمان للتنبؤ بترتيب العناصر المعادة. إن لم تُمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة permutation { |p| block } → ary
permutation → Enumerator
permutation(n) { |p| block } → ary
permutation(n) → Enumerator
المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تبديل عناصر المصفوفة ...
التابع Array.last في روبي
يجلب التابع last آخر عنصر أو آخر n عنصر من مصفوفة. البنية العامة last → obj or nil
last(n) → new_ary
المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة التي يراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأخير من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي آخر n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة ...
التابع Array.rotate! في روبي
يُدوّر التابع rotate! عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع rotate! المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو -1. البنية العامة rotate!(count=1) → ary
المعاملات count عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس count ...
التابع Array.replace في روبي
يبدِّل التابع replace محتوى المصفوفة الممرَّرة إليه مكان محتوى المصفوفة المستدعاة معه مع تغيير طولها إن دعت الحاجة لذلك. البنية العامة replace(other_ary) → ary
المعاملات other_ary المصفوفة التي ستحل محتوياتها مكان كامل محتويات المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد استبدال محتوى المصفوفة other_ary بمحتواها. أمثلة أمثلة على استخدام التابع replace: a = [ "a", "b", "c", "d", "e" ]
a.replace([ "x", "y", "z" ]) #=> ["x", "y", "z"]
a ...
التابع Array.sort! في روبي
يرتب التابع sort! عناصر المصفوفة التي استُدعيت معه. ستجرى عملية الموازنة بين عناصر المصفوفة المراد ترتيبها باستعمال المعامل <=> أو باستعمال كتلة برمجية محددة. إن استعملت الكتلة البرمجية block في ترتيب العناصر، فيجب أن تجري موازنة بين العنصر a والعنصر b وتعيد عددًا سالبًا إن كان b أكبر من a، أو العدد 0 إن كانا متساويين، أو عددًا موجبًا إن كان b أصغر من a. مع ذلك، لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب العناصر المتساوية ...
التابع Array.slice! في روبي
يقتطع التابع slice! عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice! العناصر المحذوفة، أو nil إن كان index خارج النطاق. البنية العامة slice!(index) → obj or nil
slice!(start, length) → new_ary or nil
slice!(range) → new_ary or nil
المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر ...
التابع Array.at في روبي
يجلب التابع at عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه. البنية العامة at(index) → obj or nil
المعاملات index فهرس العنصر المراد جلبه من المصفوفة المعطاة. القيم المعادة يعاد العنصر ذو الفهرس index من المصفوفة المعطاة، أو القيمة nil إن كان الفهرس index يقع خارج مجال عناصر المصفوفة. إن كانت قيمة الفهرس index سالبة، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة. أمثلة بعض الأمثلة على استخدام التابع at: a = [ "a", "b", "c", "d", "e" ]
a.at(0) ...
التابع Array.select في روبي
يحدد التابع select جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة. إن لم تمرَّر أية كتلة إلى التابع select، فسيعيد كائنًا من النوع Enumerator. البنية العامة select { |item| block } → new_ary
select → Enumerator
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة التي أعيدت معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة أمثلة على استخدام التابع select: [1,2,3,4,5].select { |num| num.even? ...
التابع Array.fetch في روبي
يجلب التابع fetch عنصرًا ذا فهرس محدَّد من مصفوفة. إن كان الفهرس المعطى لعنصرٍ يقع خارج نطاق المصفوفة، فسيُطلَق الخطأ IndexError. يمكن تجنب إطلاق هذا الخطأ بتمرير وسيطٍ ثانٍ أو كتلة برمجية إلى التابع fetch ليُظهَر أو تُنفَّذ في مثل هذه الحالة. البنية العامة fetch(index) → obj
fetch(index, default) → obj
fetch(index) { |index| block } → obj
المعاملات index عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة. default قيمة افتراضية تُطبَع -بدلًا من إطلاق الخطأ IndexError- عندما يشير ...
التابع Array.to_a في روبي
يعيد التابع to_a المصفوفة التي استُدعيت معه. في حال استدعاء هذا التابع مع كائن من صنف فرعي (subclass) من الصنف Array، فسيُحوَل ذلك الكائن إلى كائن من الصنف Array. البنية العامة to_a → ary
القيم المعادة تعاد المصفوفة نفسها المعطاة. أمثلة مثالٌ على استخدام التابع to_a: [ "a", nil, "b", nil, "c", nil ].to_a #=> [ "a", nil, "b", nil, "c", nil ]
انظر أيضًا التابع to_ary: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة ...
التابع Array.take في روبي
يجلب التابع take أول n عنصر من مصفوفة. إن مرِّر عدد سالب إلى هذا التابع، فسيُطلَق الخطأ ArgumentError. البنية العامة take(n) → new_ary
المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي العناصر n الأولى الموجودة في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع take: a = [1, 2, 3, 4, 5, 0]
a.take(3) #=> [1, 2, 3]
انظر ...
التابع Array.sum في روبي
يجمع التابع sum عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا. إن مُرِّرت كتلة برمجية إلى هذا التابع، فستُطبَّق تلك الكتلة على كل عنصر من عناصر المصفوفة ثم ستُجمَع النواتج المعادة لجميع العناصر. في حال كانت المصفوفة فارغة، ستُعاد القيمة المُمرّرة إلى هذا التابع. يمكن استخدام هذا التابع مع المصفوفات التي تحوي قيمًا غير عددية بتحديد قيمة مناسبة للوسيط init. يجدر التنبيه إلى أنّ التابعين join و flatten هما أسرع من التابع sum بالنسبة للمصفوفات التي تضم سلاسل نصية أو ...
التابع Array.values_at في روبي
يجلب التابع values_at عنصرًا واحدًا أو أكثر ذا فهرس محدد من مصفوفة. البنية العامة values_at(selector, ...) → new_ary
المعاملات selector عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة. … أعداد صحيحة تمثل فهارس العناصر المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي عنصرًا واحدًا أو أكثر ذي الفهرس selector من المصفوفة المعطاة. إن كان الوسيط selector مجالًا، فستُجلَب العناصر التي تقع فهارسها ضمن ذلك المجال وتوضع في المصفوفة المعادة. إن وقع فهرس عنصر خارج مجال ...
التابع Array.dig في روبي
يستخرج التابع dig العنصر المتشعِّب (nested value) المحدَّد بسلسلة المعاملات الممرَّرة إليه من مصفوفة متعددة الأبعاد وذلك عبر استدعاء dig عند كل مستوى تشعب. البنية العامة dig(idx, ...) → object
المعاملات idx عدد صحيح يمثل فهرسًا يشير إلى عنصر محدد (مصفوفة فرعية) من المصفوفة الخارجية. … أعداد صحيحة يشير أول عدد منها إلى عنصر محدد (قد يكون مصفوفة فرعية) من المصفوفة الفرعية التي حدِّدت عبر المعامل idx، وثاني عدد منها إلى عنصر محدد من المصفوفة الفرعية التي حدِّدت عبر ...
التابع Array.compact! في روبي
يحذف التابع compact! كل العناصر ذات القيمة nil من المصفوفة التي استدعيت معه ثم يعيدها. إن لم تحوي المصفوفة أي عنصر يساوي nil، فسيعيد التابع compact! القيمة nil. البنية العامة compact! → ary or nil
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع العناصر ذات القيمة nil منها، أو تعاد القيمة nil إن لم تحوِ تلك المصفوفة على أي عنصر تساوي قيمة القيمة nil. أمثلة أمثلة على استخدام التابع compact!: [ "a", nil, "b", nil, "c" ].compact! ...
التابع Array.rassoc في روبي
يبحث التابع rassoc عن عنصر محدد في العناصر الثانية للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه ثم يعيد المصفوفة الفرعية التي يُعثَر فيها على ذلك العنصر. تُجرَى عملية الموازنة بين العنصر الثاني من كل مصفوفة فرعية والقيمة الممررة إلى التابع باستعمال المعامل ==. البنية العامة rassoc(obj) → element_ary or nil
المعاملات obj الكائن المراد البحث عنه. القيم المعادة تعاد المصفوفة الفرعية الموجودة في المصفوفة المعطاة والتي تطابقت القيمة obj مع العنصر الثاني فيها، أو تعاد القيمة nil إن لم يتطابق ...
التابع Array.to_ary في روبي
يعيد التابع to_ary المصفوفة التي استُدعيت معه. البنية العامة to_ary → ary
القيم المعادة تعاد المصفوفة نفسها المعطاة. أمثلة مثالٌ على استخدام التابع to_ary: [ "a", nil, "b", nil, "c", nil ].to_ary #=> [ "a", nil, "b", nil, "c", nil ]
انظر أيضًا التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. التابع inspect: يحول مصفوفة إلى سلسلة نصية. التابع try_convert: يحاول أن ...
التابع Array.collect في روبي
يستدعي التابع collect كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة collect { |item| block } → new_ary
collect → Enumerator
القيم المعادة تعاد مصفوفة جديدة تحوي القيم التي تعيدها الكتلة block عند تطبيقها على كل عنصر من عناصر المصفوفة المعطاة، أو يعاد كائنٌ من النوع Enumeratorإن لم تمرَّر الكتلة block. أمثلة أمثلة على ...
التابع Array.delete_at في روبي
يحذف التابع delete_at عنصرًا ذا فهرس محدَّد من مصفوفة. البنية العامة delete_at(index) → obj or nil
المعاملات index عدد صحيح يمثل فهرس العنصر المراد حذفه. القيم المعادة يعاد العنصر المحذوف ذو الفهرس index من المصفوفة المعطاة، أو تعاد القيمة nil إن كان الفهرس index المعطى يقع خارج مجال المصفوفة. أمثلة أمثلة على استخدام التابع delete_at: a = ["ant", "bat", "cat", "dog"]
a.delete_at(2) #=> "cat"
a ...
التابع Array.repeated_combination في روبي
يشبه التابع repeated_combination التابع combination باستثناء أنه يمكنه تجميع العناصر مع نفسها (أي تكرار العناصر نفسها). لا يوجد أي ضمان للتنبؤ بترتيب العناصر المجمَّعة المعادة. إن لم تمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة repeated_combination(n) { |c| block } → ary
repeated_combination(n) → Enumerator
المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تجميع عناصر المصفوفة المعطاة ضمنها. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تجميع عناصرها مع نفسها ومع العناصر الأخرى بترتيب ...
التابع Array.compact في روبي
يعيد التابع compact نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي nil منها. البنية العامة compact → new_ary
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر ذات القيمة nil. أمثلة مثالٌ على استخدام التابع compact: [ "a", nil, "b", nil, "c", nil ].compact
#=> [ "a", "b", "c" ]
انظر أيضًا التابع compact! ...
التابع Array.shuffle في روبي
يعيد التابع shuffle ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة. البنية العامة huffle → new_ary
shuffle(random: rng) → new_ary
المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: rng. القيم المعادة تعاد مصفوفة جديدة تحوي عناصر المصفوفة المعطاة مرتَّبةً بشكل عشوائي. أمثلة أمثلة على استخدام التابع shuffle: a = [ 1, 2, 3 ] #=> [1, 2, 3]
a.shuffle ...
التابع Array.flatten! في روبي
يشبه التابع flatten! التابع flatten في جميع النواحي باستثناء أنه لا يضع الناتج في مصفوفة جديدة وإنما يعدِّل على المصفوفة الأصلية نفسها. يقبل هذا التابع تمرير المعامل level الاختياري الذي يحدد مستوى التعاودية (recursion level). البنية العامة flatten! → ary or nil
flatten!(level) → ary or nil
المعاملات level عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. القيم المعادة تعاد المصفوفة نفسه المعطاة بعد تحويلها إلى مصفوفة أحادية البعد أي بعد استخراج العناصر المتشعبة منها ...
التابع Array.delete في روبي
يحذف التابع delete جميع عناصر المصفوفة المساوية لقيمة محددة ثم يعيد آخر عنصر حذفه، أو القيمة nil أو ناتج تطبيق كتلة برمجية محددة إن لم يعثر على أي عنصر لحذفه. البنية العامة delete(obj) → item or nil
delete(obj) { block } → item or result of block
المعاملات obj الكائن المراد حذفه -أينما وجد- في المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف العناصر المساوي للوسيط obj منها، أو تعاد القيمة nil إن لم يعثر على عنصر مساوٍ ...
التابع Array.clear في روبي
يزيل التابع clear كل عناصر المصفوفة. البنية العامة clear → ary
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع عناصرها. أمثلة مثال على استخدام التابع clear: a = [ "a", "b", "c", "d", "e" ]
a.clear #=> [ ]
انظر أيضًا التابع delete_at: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع compact: يعيد نسخةً جديدة من المصفوفة التي استُدعي ...
التابع Array.sort_by! روبي
يُرتِّب التابع sort_by! المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة. لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. في حال عدم تمرير كتلة برمجية إلى التابع sort_by!، سيعيد كائنًا من النوع Enumerator. البنية العامة sort_by! { |obj| block } → ary
sort_by! → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها وفقًا للقيمة التي تعيدها ...
التابع Array.select! في روبي
يختار التابع !select جميع عناصر المصفوفة المحققة لشرط معين ويحذف العناصر الأخرى المتبقية التي لم تحقق هذا الشرط. قد لا تتغير المصفوفة مباشرةً في كل مرة تُستدعى فيها الكتلة البرمجية الممررة إلى هذا التابع، وستعاد القيمة nil إن لم يجرى أي تعديل على المصفوفة. إن لم تمرَّر أية كتلة إلى التابع !select، فسيعيد كائنًا من النوع Enumerator. البنية العامة select! {|item| block } → ary or nil
select! → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد الإبقاء على العناصر التي ...
التابع Array.delete_if في روبي
يحذف التابع delete_if جميع عناصر المصفوفة التي تعيد الكتلة البرمجية المعطاة عند تطبيقها على كل عنصر منها القيمة true. يُعدَّل على المصفوفة مباشرةً في كل مرَّة تستدعى فيها الكتلة، وليس بعد انتهاء التكرار (iteration). إن لم تمرَّر أي كتلة إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة delete_if { |item| block } → ary
delete_if → Enumerator
القيم المعادة تعاد المصفوفة نفسها بعد حذف العناصر التي أعيدت معها القيمة true عند تطبيق الكتلة block على كلٍّ منها، أو ...
التابع Array.uniq في روبي
يحذف التابع uniq العناصر المتكررة من مصفوفة ثم يضع العناصر المتبقية في مصفوفة جديدة. إن مرِّرت كتلة برمجية، فستُستخدَم القيمة التي تعيدها هذه الكتلة لكل عنصر في عملية الموازنة. يوازن التابع uniq القيم باستخدام التابع hash والتابع eql? لأجل تحسين الأداء. كما يقتطع التابع العناصر المتكررة من مصفوفة بالترتيب، إذ يحتفظ بالظهور الأول للقيمة المتكررة ويحذف القيمة الأخرى المتماثلة. البنية العامة uniq → new_ary
uniq { |item| ... } → new_ary
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة ...
التابع Array.drop_while في روبي
يحذف التابع drop_while عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. إن لم تمرَّر أيَّة كتلة، فسيعيد التابع drop_while كائنًا من النوع Enumerator. البنية العامة drop_while { |obj| block } → new_ary
drop_while → Enumerator
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر الأولى التي تعيد كل منها القيمة true عند تطبيق الكتلة البرمجيَّة block عليها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على ...
التابع Array.include? في روبي
يتحقق التابع include? إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه (أي إذا كان هنالك عنصر من المصفوفة يساوي الوسيط الممرر بحسب المعامل ==) البنية العامة include?(object) → true or false
المعاملات object الكائن الذي يراد التحقق من وجوده في المصفوفة المعطاة. القيم المعادة تعاد القيمة true إن كان العنصر object موجودًا في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع include?: a = [ "a", "b", "c" ]
a.include?("b") #=> true
a.include?("z") #=> ...
التابع Array.max في روبي
يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية. البنية العامة max → obj
max { |a, b| block } → obj
max(n) → array
max(n) { |a, b| block } → array
المعاملات ...
التابع Array.uniq! في روبي
يحذف التابع uniq! العناصر المتكررة من مصفوفة. إن مرِّرت كتلة برمجية، فستُستخدَم القيمة التي تعيدها هذه الكتلة لكل عنصر في عملية الموازنة. يوازن التابع uniq! القيم باستخدام التابع hash والتابع eql? لأجل تحسين الأداء. كما يقتطع التابع العناصر المتكررة من مصفوفة بالترتيب، إذ يحتفظ بالظهور الأول للقيمة المتكررة ويحذف القيمة الأخرى المتماثلة. البنية العامة uniq! → ary or nil
uniq! { |item| ... } → ary or nil
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة العناصر المتكررة منها، أو تعاد ...
التابع Array.min في روبي
يعيد التابع min أصغر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أما الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مُرِّر الوسيط n، فسيعيد التابع مصفوفةً تحوي أصغر n عنصر موجود في المصفوفة الأصلية. البنية العامة min → obj
min {| a,b | block } → obj
min(n) → array
min(n) {| a,b | block } → array
المعاملات ...
التابع Array.push في روبي
يضيف التابع push جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. يعيد هذا التابع المصفوفة نفسها، لذلك يمكن تطبيقه بشكل متسلسل. البنية العامة push(obj, ... ) → ary
المعاملات obj الكائن المراد إضافته إلى نهاية المصفوفة المعطاة … الكائنات الأخرى المراد إضافتها إلى نهاية المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj والكائنات الأخرى الممررة إليها. أمثلة أمثلة على استخدام التابع push: a = [ "a", "b", "c" ]
a.push("d", "e", "f")
...
التابع Array.to_h في روبي
يعيد التابع to_h نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. البنية العامة to_h → hash
القيم المعادة يعاد ناتج تحويل المصفوفة المعطاة إلى خريطة (map) مكونة من الأزواج key/value. أمثلة مثالٌ على استخدام التابع to_h: [[:foo, :bar], [1, 2]].to_h # => {:foo => :bar, 1 => 2}
انظر أيضًا التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع inspect: يحول مصفوفة إلى سلسلة نصية. التابع try_convert: يحاول أن يحوّل كائنًا obj ...
التابع Array.each_index في روبي
يستدعي التابع each_index كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. إن لم تمرَّر أيَّة كتلة إلى التابع each_index، فسيُعيد كائنًا من النوع Enumerator. البنية العامة each_index { |index| block } → ary
each_index → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام ...
التابع Array.cycle في روبي
يستدعي التابع cycle كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة nil. أمَّا إن مُرِّرت إليه قيمة سالبة أو كانت المصفوفة فارغة، فلن يفعل هذا التابع أي شيء. يعيد التابع القيمة nil إن انتهت سلسلة الاستدعاءات المطبقة على كل عنصر دون مقاطعة.إن لم تمرَّر أي كتلة، فسيعيد التابع cycle كائنا من النوع Enumerator. البنية العامة cycle(n=nil) { |obj| block } → nil
cycle(n=nil) → Enumerator
المعاملات ...
التابع Array.empty? في روبي
يتحقق التابع empty? إن كانت مصفوفةٌ فارغةً أم لا. البنية العامة empty? → true or false
القيم المعادة تعاد القيمة true المنطقية إن كانت المصفوفة المعطاة فارغة، أو القيمة false خلا ذلك. أمثلة بعض الأمثلة على استخدام التابع empty?: [].empty? #=> true
[1, 5].empty? #=> false
انظر أيضًا التابع include?: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. التابع frozen?: يتحقق إن كانت مصفوفةٌ مُجمَّدةً ( frozen) بشكل دائم أو مؤقت ...
التابع Array.collect! في روبي
يستدعي التابع !collect كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه. إن لم يمرَّر أي شيء إلى هذا التابع، فسيعيد كائنا من النوع Enumerator. البنية العامة collect! {|item| block } → ary
collect! → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تبديل القيمة الجديدة التي تعيدها الكتلة block عند تطبيقها على كل عنصر من عناصر تلك المصفوفة مكان القيمة القديمة لذلك العنصر، أو يعاد كائنٌ من ...
التابع Array.insert في روبي
يُدرج التابع insert القيم المُمرّرة إليه قبل عنصرٍ ذي فهرس محدد. البنية العامة insert(index, obj...) → ary
المعاملات index عدد صحيح يمثل فهرس العنصر المراد إدراج محتوى المعامل ...obj قبله. إن أعطيت قيمة سالبة للفهرس index، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة وستضاف تلك القيم المعطاة بعد العنصر، إذ يمثِّل الفهرس -1 مثلًا آخر عنصر في المصفوفة وستضاف القيم الممررة في نهاية المصفوفة. ...obj الكائنات المراد إدراجها قبل العنصر ذي الفهرس index في المصفوفة المعطاة. القيم المعادة تعاد ...
التابع Array.flatten في روبي
يجعل التابع flatten المصفوفة التي تحوي عناصر متشعبة ضمنها مصفوفةً أحادية البعد بشكل تعاودي (recursively)؛ أي أنَّ كل عنصر من عناصر المصفوفة المعطاة والذي قد يكون نفسه مصفوفةً متشعبةً من مستوًى واحدٍ أو أكثر ستُستخلَص عناصره وتضاف إلى مصفوفة جديدة. يقبل هذا التابع تمرير المعامل level الاختياري الذي يحدد مستوى التعاودية (recursion level). البنية العامة flatten → new_ary
flatten(level) → new_ary
المعاملات level عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. القيم المعادة تعاد مصفوفة ...
التابع Array.keep_if في روبي
يٌبقِي التابع keep_if على جميع عناصر المصفوفة التي تحقق شرطًا معينًا ويحذف العناصر الأخرى المتبقية. إن لم تمرَّر كتلة برمجية، فسيعيد التابع keep_if كائنًا من النوع Enumerator. البنية العامة keep_if { |item| block } → ary
keep_if → Enumerator
القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة جميع العناصر الغير محققة للشرط الذي تحدده الكتلة block، أو يعاد كائن من النوع إن Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام التابع keep_if: a = %w{ a b c d ...
عرض (500 السابقة | 500 التالية) (20 | 50 | 100 | 250 | 500).