نتائج البحث

المصفوفة في 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 هي خريطة (map) مرتّبة، والخريطة هي نوع ترتبط فيه القيم مع المفاتيح، ولها استخدامات عديدة، فيمكن التعامل معها كمصفوفة أو قائمة (vector) أو جدول hash (نوع من الخرائط) أو قاموس (dictionary) أو مجموعة (collection) أو مكدس (stack) أو طابور (queue) وغير ذلك، حتى أن قيم المصفوفة يمكن أن تكون مصفوفات أخرى، ممّا يسمح بإنشاء مصفوفات متعددة الأبعاد. لن نشرح جميع هذه الأنواع في هذا التوثيق، لكن ستجد مثالًا واحدًا على الأقل لكلٍ منها. الصياغة إنشاء المصفوفات باستخدام ...

تسمح لك هذه الدوال بالتعامل مع المصفوفات وتعديلها بطرائق عديدة. المصفوفات عنصر أساسي لتخزين وإدارة والتعامل مع مجموعاتٍ من المتغيرات. تدعم لغة PHP المصفوفات أحادية ومتعددة الأبعاد، ويمكن أن ينتجها المستخدم بنفسه أو أن يستخدم دوالًا أخرى لإنشائها. توجد كذلك دوال متخصصة للتعامل مع قواعد البيانات وملأ المصفوفات من نواتج استعلامات قواعد البيانات، وتعيد الكثير من الدوال مصفوفاتٍ أيضًا. رجاءً تصفَّح نوع البيانات الخاص بالمصفوفات من هذا التوثيق للحصول على شرح تفصيلي عن كيفية استعمال المصفوفات في لغة PHP. انظر ...

إنشاء المصفوفات المصفوفة هي متغير يحتوي قيمًا متعددة، وأي متغير قد يُستخدم كمصفوفة، كذلك لا يوجد حد أقصى لحجم المصفوفة ولا يُشترط أن تُفهرس المتغيرات داخل المصفوفة أو تُعيَّن في وقت واحد، وقد تكون المصفوفات صفرية القاعدة أي يُفهرس أول عنصر برقم صفر. ينفَّذ التصريح غير المباشر عن المتغير (indirect declaration) باستخدام البنية اللغوية التالية: ARRAY[INDEXNR]=value يعامَل المفهرِس INDEXER على أنه تعبير حسابي يجب أن يٌقدَّر بعدد موجب، ويتم التصريح الواضح (explicit declaration) للمصفوفة باستخدام أمر declare: declare -a ARRAYNAME يُقبَل التصريح ...

المثال الاسم النتيجة ‎$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 على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...

المثال الاسم النتيجة ‎$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 على الكثير من الدوال التي تتعامل مع ترتيب المصفوفات، وهذه الصفحة تساعد على التفريق بينها. الاختلافات الرئيسية هي: ترتب بعض الدوال المصفوفات بناءً على مفاتيحها (keys)، بينما ترتبها دوالٌ أخرى بناءً على القيم المرتبطة مع كل مفتاح. قد تحافظ بعض الدوال على العلاقة ما بين المفتاح والقيمة المسجلة معه بعد عملية الترتيب. لكن هذا قد يعني أنه في بعض الأحيان سيُعاد ضبط المفاتيح إلى الوضعية الافتراضية العددية (0، 1، 2 …). طريقة الترتيب: هجائيًا من الأصغر إلى ...

تقنية إعادة التصميم هذه هي حالة خاصة من تبديل قيم البيانات إلى كائنات. المشكلة لديك مصفوفة تحتوي على أنواع مختلفة من البيانات. الحل استبدال المصفوفة بكائن يكون له حقول منفصلة لكل عنصر. مثال قبل إعادة التصميم احتواء المصفوفة 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; في لغة ...

اختبار

المصفوفات هي مجموعات مُرتَّبة ومُفهرسة بالأعداد الصحيحة (integer-indexed) ومُكونة من أي نوع من الكائنات. تبدأ فهارس المصفوفات بالعدد 0، كما هو الحال في لغتي C و Java. ويفترض أن يُحسب الفهرس السالب بدءًا من نهاية المصفوفة، أي أنَّ الفهرس ذا القيمة ‎-1 يشير إلى العنصر الأخير في المصفوفة، والفهرس ‎-2 يمثل موضع العنصر ما قبل الأخير، وهلم جرًا. إنشاء المصفوفات يمكن إنشاء مصفوفة جديدة باستخدام المعامل [] الباني. يمكن أن تحتوي المصفوفة نفسها على أنواع مختلفة من الكائنات. على سبيل ...

تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc" b = a.replace("a", "f") و: ...

تدعم كائنات البايتات ومصفوفات البايتات عمليات التسلسلات الشائعة، وتتوافق هذه الكائنات مع العوامل من النوع ذاته إضافة إلى أي كائن شبيه بالبايتات. ونظرًا لهذه المرونة العالية، يمكن استخدام البايتات في أي نوع من العمليات دون حدوث أي خطأ، ولكن النوع المعاد يعتمد على ترتيب العوامل. ملاحظة: لا يمكن تمرير سلاسل نصية كوسائط في التوابع التي تعمل على البايتات ومصفوفات البايتات كما لا يمكن تمرير البايتات في توابع السلاسل النصية. فعلى سبيل المثال يجب كتابة: a = "abc" b = a.replace("a", "f") و: ...

تعرف هذه الوحدة كائنًا يمكن عن طريقه تمثيل مصفوفة من القيم الأساسية مثل الحروف والأعداد الصحيحة والأعداد ذات الفاصلة العائمة بشكل مضغوط. تعد المصفوفات نوعًا من أنواع التسلسلات وتشبه القوائم في عملها على نحو كبير، باستثناء أن أنواع الكائنات التي يمكن تخزينها في المصفوفات محدودة. أنواع الكائنات التي يمكن تخزينها في المصفوفات يجب تحديد نوع الكائنات عند إنشاء المصفوفة وذلك باستخدام رمز النوع وهو عبارة عن حرف واحد فقط. يبين الجدول التالي رموز الأنواع المتاحة: رمز النوع النوع في لغة ...

ينشئ التابع 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.[]( 1, 'a', /^A/ ) # => [1, "a", /^A/] Array[ 1, 'a', /^A/ ]    # => [1, "a", /^A/] [ 1, 'a', /^A/ ]         # => [1, "a", /^A/] انظر أيضًا التابع new()‎: ينشئ مصفوفةً جديدةً. مصادر قسم التابع []‎ في الصنف Array في توثيق روبي الرسمي.

الكائن 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", ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة array()‎ مصفوفة جديدة. الوصف array array ([ mixed $... ] ) تنشئ هذه الدالة مصفوفة جديدة. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array. المعاملات ... يُعرَّف التركيب "الفهرس => القيم" كلًا من الفهرس والقيمة المقابلة وتفصل الفاصلة , بين تلك الأزواج. قد يكون الفهرس من نوع السلاسل النصية أو الأعداد الصحيحة. إذا حُذِفَ الفهرس فسيتولّد فهرس من نوع الأعداد الصحيحة تلقائيًا بدءًا من 0. وإذا كان الفهرس عددًا صحيحًا، فسيكون ...

يعيد المعامل - مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة الأخرى. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. يوازن المعامل - العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary - other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تمثل نسخة من جميع عناصر المصفوفة الأصلية باستثناء العناصر المشتركة مع المصفوفة other_ary الأخرى. أمثلة مثالٌ عن استعمال المعامل -: [ 1, 1, 2, 2, 3, 3, ...

يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة 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 ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي. يوازن كل كائن من كل مصفوفة باستخدام المعامل <=>. يوازن بين المصفوفات عنصرًا عنصرًا؛ بعبارة أخرى، يوازن العنصر الأول من المصفوفة الأولى مع العنصر الأول من المصفوفة الثانية باستخدام المعامل <=>، ثم يوازن العنصر الثاني فالثالث وهكذا دواليك. متى ما أعطيت نتيجة مغايرة للصفر لأيٍّ من تلك الموازنات التي تجرى على العناصر تباعًا ...

يعيد المعامل & مصفوفةً جديدةً تحتوي على العناصر المشتركة بين مصفوفتين دون تكرارها. تحافظ المصفوفة المعادة على نفس ترتيب العناصر في المصفوفة الأصلية. توازن العناصر باستخدام التابعين ()hash و ()eql?‎ للحصول على أعلى كفاءة. البنية العامة ary & other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تحتوي على العناصر المشتركة بين المصفوفة ary والمصفوفة other_ary دون تكرارها. أمثلة مثالٌ عن استخدام المعامل &: [ 1, 1, 3, 5 ] & [ 3, 2, 1 ] ...

إن استعمل المعامل * مع مصفوفة وسلسلة نصية، فسيُكافئ حينئذٍ العبارة ary.join(str)‎. أمَّا إن استعمل مع مصفوفة وعدد، فسيُعيد مصفوفة جديدة تتكرر فيها المصفوفة تلك عددًا من المرات مساويًا لذلك العدد المعطى. البنية العامة ary * int → new_ary ary * str → new_string القيم المعادة تعاد مصفوفة أو سلسلة نصية جديدة. أمثلة مثالٌ عن استخدام المعامل * مرةً مع عدد وأخرى مع سلسلة نصية: [ 1, 2, 3 ] * 3 #=> [ 1, 2, ...

يضيف المعامل >> كائنًا مُحدَّدًا إلى نهاية المصفوفة الأصلية ثم يعيد المصفوفة نفسها، لذا يمكن تكرار هذا المعامل عدة مرات وبشكل متسلسل. البنية العامة ary << obj → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj إليها. أمثلة أمثلة عن استخدام المعامل >>: a = [ 1, 2 ] a << "c" << "d" << [ 3, 4 ] #=> [ 1, 2, "c", "d", [ 3, 4 ] ...

يتحقق المعامل == من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل عنصر من المصفوفة الأولى مساويًا لنظيره في المصفوفة الثانية. البنية العامة ary == other_ary → bool القيم المعادة تُعاد القيمة true المنطقية إن كانت المصفوفتان متساويتين، أو القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: [ "a", "c" ] == [ "a", "c", 7 ] #=> false [ "a", "c", ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

يجلب المعامل [] عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين start و range، يكون فهرس البداية قبل العنصر. إضافةً إلى ذلك، ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة ary[index] → obj or nil ary[start, length] → new_ary or nil ary[range] → new_ary ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

مقدمة عندما تكون جاهزًا لنشر تطبيق Laravel على الخادوم الإنتاجي، هناك بعض الأشياء المهمة التي يمكنك القيام بها للتأكد من تشغيل التطبيق بأقصى كفاءة ممكنة. في هذا المستند، سنغطي بعض نقاط البداية الرائعة للتأكد من نشر تطبيق Laravel بشكل صحيح. ضبط الخادوم Nginx إذا كنت تقوم بنشر تطبيقك على خادوم Nginx، فيمكنك استخدام ملف التهيئة التالي كنقطة بداية لتهيئة خادوم الويب الخاص بك. على الأرجح، يجب تخصيص هذا الملف بناءً على تهيئة خادومك. إذا كنت ترغب في المساعدة في إدارة ...

الخاصية content في CSS تُستخدَم مع العنصرين الزائفين ‎::before و ‎::after لتوليد محتوى في العنصر. بطاقة الخاصية القيمة الابتدائية normal تُطبَّق على العنصرين الزائفين ‎::before و ‎::after. قابلة للوراثة لا قابلة للحركة لا القيمة المحسوبة ستكون القيمة هي normal دومًا إذا طُبِّقت هذه الخاصية على العناصر العادية. وإذا كانت القيمة normal وطُبِّقَت على العنصرين الزائفين ‎::before و ‎::after فستكون القيمة المحسوبة هي none. إذا استخدمنا روابط URL النسبية فستحوِّل إلى روابط مطلقة. إذا استخدمنا الدالة attr(x)‎ فستحوِّل القيمة إلى سلسلة نصية. ...

يُعيد التابع all_symbols مصفوفة تضم جميع الرموز الموجودة حاليًا في جدول رموز روبي. البنية العامة all_symbols => array‎ القيمة المعادة تعاد مصفوفة تضم جميع الرموز الموجودة حاليًا في جدول رموز روبي. أمثلة مثال على استعمال التابع all_symbols: Symbol.all_symbols.size #=> 903 Symbol.all_symbols[1,20] #=> [:floor, :ARGV, :Binding, :symlink, ...

يعيد التابع argv المصفوفة ARGV التي تحوي الوسائط المُمرّرة إلى ملفك البرمجي (script)، إذ يخزَّن في كلِّ عنصر من عناصرها وسيطٌ واحدٌ. البنية العامة argv → ARGV القيم المعادة تعاد المصفوفة ARGV التي تحوي الوسائط المُمرّّرة إلى ملفك البرمجي (script). أمثلة مثالٌ على استخدام التابع argv: $ ruby argf.rb -v glark.txt ARGF.argv #=> ["-v", "glark.txt"] انظر أيضًا التابع binmode: يفعِّل الوضع الثنائي (binary mode) للمجرى ARGF. مصادر قسم التابع argv في الصنف ARGF في توثيق روبي الرسمي.

يُعيد التابع to_a مصفوفة تتألف من 14 عنصرًا تحوي معلومات حول سلسلة التعليمات التي استدعي معها. البنية العامة to_a → ary‎ القيمة المعادة تعاد مصفوفة تتألف من 14 عنصرًا يمثلون سلسلة التعليمات بالبيانات التالية: magic سلسلة نصية تحدد تنسيق (format) البيانات. دائمًا تكون YARVInstructionSequence/SimpleDataFormat. major_version الإصدار الرئيسي لسلسلة التعليمات. minor_version الإصدار الثانوي لسلسلة التعليمات. format_type عدد يمثل تنسيق البيانات. تكون دائمًا 1. misc جدول Hash يحتوي على: ‎:arg_size: العدد الإجمالي للوسائط التي يأخذها التابع أو الكتلة (تساوي 0 إن لم تكن ...

يتحقق التابع any?‎ إذا كان كل عنصر من عناصر المصفوفة المعطاة مححقًا لشرط منطقي محدد أو كانت قيمة كل عنصر لا تساوي القيمة false (أي لا يعيد أي عنصر القيمة false أو nil عند التحقق من مطابقته للشرط). إن لم تمرَّر أية كتلة برمجية تمثل الشرط، فستضيف روبي الكتلة { ‎ |obj| block} ضمنيًا، وسيعيد حينئذٍ التابع any?‎ القيمة true إن لم يتساوى أي عنصر من عناصر المصفوفة مع القيمة false أو القيمة nil. إن مرِّر نمطٌ (pattern) بدلًا من ...

يعيد التابع keys جميع متغيرات البيئة في مصفوفة. البنية العامة keys → Array القيمة المعادة تُعاد مصفوفة تحوي جميع متغيرات البيئة. انظر أيضًا التابع key: يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. التابع values: يعيد جميع قيم متغيرات البيئة في مصفوفة. مصادر قسم التابع keys في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع values‎ مصفوفة تضم جميع قيم متغيرات البيئة. البنية العامة values → Array القيمة المعادة تُعاد مصفوفة تضم جميع قيم متغيرات البيئة. انظر أيضًا التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. التابع key: يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. مصادر قسم التابع values في الصنف ENV في توثيق روبي الرسمي.

يحول التابع inspect مصفوفةً إلى سلسلة نصية. البنية العامة inspect → string القيم المعادة تعاد سلسلة نصية تمثل المصفوفة المعطاة. أمثلة أمثلة على استخدام التابع inspect: [ "a", "b", "c" ].inspect #=> "[\"a\", \"b\", \"c\"]" انظر أيضًا التابع to_s: يعدُّ اسمًا بديًلا للتابع inspect. التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. مصادر قسم التابع inspect في الصنف ...

يعيد التابع rect المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. البنية العامة rect → array rectangular → array‎ القيمة المعادة تعاد المصفوفة [num, 0] إذ num يمثل العدد المعطى. انظر أيضا التابع rectangular: يعيد المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. مصادر قسم التابع rect‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يعيد التابع 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‎: يحاول أن ...

يعيد التابع 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 ...

يعيد التابع rectangular المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. البنية العامة rectangular → array‎ القيمة المعادة تعاد المصفوفة [num, 0] إذ num يمثل العدد المعطى. انظر أيضا التابع rect: يعيد المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. مصادر قسم التابع rectangular‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يعدُّ هذا التابع اسمًا بديلًا للتابع unshift. انظر أيضًا التابع unshift: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. التابع push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. التابع shift: يحذف أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع take: يعيد أول ...

يعيد التابع source_location اسم الملف المصدر لروبي ورقم السطر الذي يحتوي هذا التابع الحر، أو يعيد nil إن لم يُعرّف هذا التابع في روبي (أي أنه أصلي). البنية العامة source_location → [String, Integer]‎ القيمة المعادة تعاد مصفوفة من عنصرين تحوي اسم الملف المصدر لروبي ورقم السطر الذي يحتوي التابع الحر المعطى، أو تعاد القيمة nil إن لم يُعرّف هذا التابع في روبي. انظر أيضًا التابع parameters: يعيد معلومات عن معاملات التابع الحر الذي استُدعي معه. التابع super_method: يعيد كائنا من النوع Method ...

يعيد التابع global_variables مصفوفةً تضم أسماء المتغيرات العامة (global variables). البنية العامة global_variables → array‎ القيمة المعادة تعاد مصفوفةٌ تضم أسماء المتغيرات الكلية. أمثلة مثال على استخدام التابع global_variables‎: global_variables.grep /std/ #=> [:$stdin, :$stdout, :$stderr]‎ انظر أيضا التابع local_variables: يعيد مصفوفة تضم أسماء المتغيرات المحلية الحالية. مصادر قسم التابع global_variables‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع compact نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي nil منها. البنية العامة compact → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر ذات القيمة nil. أمثلة مثالٌ على استخدام التابع compact: [ "a", nil, "b", nil, "c", nil ].compact #=> [ "a", "b", "c" ] انظر أيضًا التابع compact! ...

يعيد التابع 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: يعيد نتيجة تحويل المصفوفة ...

يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. البنية العامة to_a → Array القيمة المعادة تُعاد مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم متغيرات البيئة. أمثلة مثال عن استخدام التابع to_a: ENV.to_a # => [["TERM", "xterm-color"], ["SHELL", "/bin/bash"], ...] انظر أيضًا التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_a في الصنف ENV في توثيق روبي الرسمي.

يُعيد التابع source_location اسم ملف روبي المصدري ورقم السَّطر الحاوي على كتلة proc محدَّدة، أو يُعيد القيمة nil إذا كانت هذه الكتلة غير مُعرَّفة في روبي (مثل native). البنية العامة source_location → [String, Integer] القيم المعادة تُعاد مصفوفةٌ تحوي سلسلةً نصيَّةً (String) تُمثِّل اسم ملف روبي المصدري وعددًا صحيحًا (Integer) يمثِّل رقم السطر الذي يحتوي كتلة proc المُحدَّدة، أو تُعاد القيمة nil إذا كانت هذه الكتلة غير مُعرَّفة في روبي. انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن ...

يزيل التابع clear كل عناصر المصفوفة. البنية العامة clear → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع عناصرها. أمثلة مثال على استخدام التابع clear: a = [ "a", "b", "c", "d", "e" ] a.clear #=> [ ] انظر أيضًا التابع delete_at: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. التابع drop: يحذف أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. التابع compact: يعيد نسخةً جديدة من المصفوفة التي استُدعي ...

يجلب التابع last آخر عنصر أو آخر n عنصر من مصفوفة. البنية العامة last → obj or nil last(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة التي يراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأخير من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي آخر n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة ...

يعيد التابع 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 المعطى على شكل مصفوفة. أمثلة مثال على استخدام ...

يعدُّ هذا التابع اسمًا بديلًا للتابع length. انظر أيضًا التابع count: يعيد عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة (يتحقق من ذلك باستعمال المعامل ==) أو عدد العناصر التي تحقق شرطًا محددًا. التابع length: يحسب عدد عناصر المصفوفة التي استدعيت معه. مصادر قسم التابع size في الصنف Array في توثيق روبي الرسمي.

يعيد التابع values مصفوفة جديدة تحوي قيم الكائن Hash الذي استدعي معه. البنية العامة values → array القيمة المعادة تعاد مصفوفة جديدة تحوي قيم الكائن Hash المعطى. أمثلة مثال على استعمال التابع values: h = { "a" => 100, "b" => 200, "c" => 300 } h.values #=> [100, 200, 300] انظر أيضا التابع keys: يعيد مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. التابع values_at: يعيد مصفوفةً تحتوي على القيم المرتبطة بمفاتيح محدَّدة من الكائن Hash الذي استدعي معه. مصادر ...

يفترض التابع transpose أنَّ المصفوفة التي استُدعيت معه مكونةٌ من مصفوفات فيعمل على قلب (transposes) الأعمدة إلى أسطر والأسطر إلى أعمدة. البنية العامة transpose → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي المصفوفات الفرعية الموجودة في المصفوفة المعطاة بعد قلب أعمدتها إلى أسطر وأسطرها إلى أعمدة. أمثلة مثالٌ على استخدام التابع transpose: a = [[1,2], [3,4], [5,6]] a.transpose #=> [[1, 3, 5], [2, 4, 6]] انظر أيضًا التابع reverse‎: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...

يعيد التابع local_variables مصفوفة تضم أسماء المتغيرات المحلية الحالية. البنية العامة local_variables → array‎ القيمة المعادة تعاد مصفوفة تضم أسماء المتغيرات المحلية الحالية. أمثلة مثال على استخدام التابع local_variables‎: fred = 1 for i in 1..10 # ... end local_variables #=> [:fred, :i]‎ انظر أيضا التابع global_variables: يعيد مصفوفةً تضم أسماء المتغيرات العامة (global variables). مصادر قسم التابع local_variables‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع local_variables أسماء المتغيرات المحلية المعرفة في Binding على شكل رموز (symbols). هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("local_variables") البنية العامة local_variables → Array القيم المعادة تعاد مصفوفة تحوي أسماء المتغيرات المحلية المعرفة في Binding. أمثلة مثال على استخدام التابع local_variables‎: def foo a = 1 2.times do |n| binding.local_variables #=> [:a, :n] end end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variable_set‎: يضبط قيمة المتغير المحلي الممرر ...

يعيد التابع local_variables أسماء المتغيرات المحلية المعرفة في Binding على شكل رموز (symbols). هذا التابع هو النسخة المختصرة للشيفرة التالية: binding. eval("local_variables") البنية العامة local_variables → Array القيم المعادة تعاد مصفوفة تحوي أسماء المتغيرات المحلية المعرفة في Binding. أمثلة مثال على استخدام التابع local_variables‎: def foo a = 1 2.times do |n| binding.local_variables #=> [:a, :n] end end انظر أيضًا التابع eval: يقدر تعابير لغة روبي الممررة إليه في السياق Binding. التابع local_variable_set‎: يضبط قيمة المتغير المحلي الممرر ...

يتحقق التابع empty?‎ إن كانت مصفوفةٌ فارغةً أم لا. البنية العامة empty? → true or false القيم المعادة تعاد القيمة true المنطقية إن كانت المصفوفة المعطاة فارغة، أو القيمة false خلا ذلك. أمثلة بعض الأمثلة على استخدام التابع empty?‎: [].empty? #=> true [1, 5].empty? #=> false انظر أيضًا التابع include?‎: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. التابع frozen?‎: يتحقق إن كانت مصفوفةٌ مُجمَّدةً ( frozen) بشكل دائم أو مؤقت ...

يجمع المعامل | عناصر مصفوفتين في مصفوفة واحدة جديدة مع استثناء العناصر المتكررة والحفاظ على ترتيب العناصر وفقًا للمصفوفة الأولى المعطاة. يوازن المعامل | القيم باستخدام hash و eql?‎ للحصول على أعلى كفاءة. البنية العامة ary | other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة ary والمصفوفة other_ary مع حذف العناصر المتكررة. أمثلة مثال عن استخدام المعامل |: [ "a", "b", "c" ] | [ "c", "d", "a" ] #=> [ "a", "b", ...

يعكس التابع reverse!‎ ترتيب عناصر المصفوفة التي استُدعيت معه. البنية العامة reverse! → ary القيم المعادة تعاد المصفوفة نفسها المعطاة بعد عكس ترتيب عناصرها. أمثلة أمثلة على استخدام التابع reverse!‎: a = [ "a", "b", "c" ] a.reverse! #=> ["c", "b", "a"] a #=> ["c", "b", "a"] انظر أيضًا التابع reverse: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة ...

يتحقق التابع eql?‎ من أن مصفوفتين تتضمنان نفس العناصر، وذلك بحسب التابع Object.eql?‎. البنية العامة eql?(other) → true or false القيم المعادة يعيد القيمة true إن كانت المصفوفتان تتضمنان نفس العناصر ، وإلا فستعيد القيمة false. انظر أيضًا المعامل <=>: يعيد عددًا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي المعامل ==: يتحقق  من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل ...

يتحقق التابع frozen?‎ إن كانت مصفوفةٌ مُجمَّدةً (frozen) بشكل دائم أو مؤقت إلى حين إعادة ترتيبها. البنية العامة frozen? → true or false القيم المعادة تعاد القيمة true المنطقية إن كانت مصفوفةٌ مُجمَّدةً (frozen) بشكل دائم أو مؤقت إلى حين إعادة ترتيبها، أو القيمة false خلاف ذلك. انظر أيضًا التابع Object.frozen?‎: يعيد حالة التجميد للكائن المستدعى معه. التابع include?‎: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. التابع empty?‎: يتحقق إن كانت مصفوفةٌ فارغةً أم ...

يعدُّ التابع to_s اسمًا بديلًا للتابع inspect. انظر أيضًا التابع inspect: يحول مصفوفة إلى سلسلة نصية. مصادر قسم التابع to_s في الصنف Array في توثيق روبي الرسمي.

يحاول التابع 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) ...

يعيد التابع polar المصفوفة [num.abs، num.arg]، إذ num هو العدد الذي استدعي معه. البنية العامة polar → array‎ القيمة المعادة تعاد المصفوفة [num.abs، num.arg] إذ num هو العدد المعطى. انظر أيضا التابع coerce: إن كان العدد المُمرَّر إلى التابع numeric من نفس نوع العدد الذي استُدعي معه، فسيعيد مصفوفة تحوي هذين العددين. خلاف ذلك، سيحول هذين العددين إلى النوع Float ويعيدهما في مصفوفة. التابع phase: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو يعيد القيمة pi خلاف ذلك. مصادر قسم التابع polar‎ ...

يتحقق التابع include?‎ إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه (أي إذا كان هنالك عنصر من المصفوفة يساوي الوسيط الممرر بحسب المعامل ==) البنية العامة include?(object) → true or false المعاملات object الكائن الذي يراد التحقق من وجوده في المصفوفة المعطاة. القيم المعادة تعاد القيمة true إن كان العنصر object موجودًا في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع include?‎: a = [ "a", "b", "c" ] a.include?("b") #=> true a.include?("z") #=> ...

يجلب التابع at عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه. البنية العامة at(index) → obj or nil المعاملات index فهرس العنصر المراد جلبه من المصفوفة المعطاة. القيم المعادة يعاد العنصر ذو الفهرس index من المصفوفة المعطاة، أو القيمة nil إن كان الفهرس index يقع خارج مجال عناصر المصفوفة. إن كانت قيمة الفهرس index سالبة، فسيُحسَب موقع العنصر بدءًا من نهاية المصفوفة. أمثلة بعض الأمثلة على استخدام التابع at: a = [ "a", "b", "c", "d", "e" ] a.at(0) ...

يعكس التابع reverse ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة جديدة. البنية العامة reverse → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة ولكن بترتيب معكوس. أمثلة أمثلة على استخدام التابع reverse: [ "a", "b", "c" ].reverse #=> ["c", "b", "a"] [ 1 ].reverse #=> [1] انظر أيضًا التابع reverse!‎:يعكس‎ ترتيب عناصر المصفوفة التي استُدعيت معه. التابع rotate: ...

يُعيد التّابع backtrace_locations أي تتبع عكسي (backtrace) مرتبط بالاستثناء. هذا التّابع شبيه بالتّابع backtrace، ولكن الأخير هو مصفوفة من Thread::Backtrace::Location. حاليًّا، لا يتأثّر هذا التّابع بالتّابع set_backtrace. البنية العامة backtrace_locations → array القيم المعادة تُعاد مصفوفة تمثل التتبع العكسي المترافق مع الاستثناء. انظر أيضا التابع backtrace: يُعيد أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء. التابع set_backtrace: يضبط معلومات المصفوفة backtrace الخاصة بكائن الاستثناء. التابع exception: يُعيد المُستقبل (receiver). مصادر صفحة التابع backtrace_locations في الصنف Exception في توثيق روبي الرسمي.

يعيد التابع captures مصفوفة الأجزاء المُطابقة (array of captures)؛ يكافئ mtch.to_a[1..-1]‎. البنية العامة captures→ array‎ القيمة المعادة تعاد مصفوفة الأجزاء المُطابقة. أمثلة مثال على استخدام التابع captures‎: f1,f2,f3,f4 = /(.)(.)(\d+)(\d)/.match("THX1138.").captures f1 #=> "H" f2 #=> "X" f3 #=> "113" f4 #=> "8"‎ انظر أيضا التابع begin: يعيد موضع (offset) بداية العنصر n من مصفوفة التطابق في السلسلة النصية. التابع end: يعيد موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية. مصادر ...

يعيد التابع to_a دائمًا مصفوفة فارغة. البنية العامة to_a → []‎ القيمة المعادة تعاد مصفوفة فارغة. أمثلة مثال على استخدام التابع to_a‎: nil.to_a #=> []‎ انظر أيضا التابع rationalize: يعيد الصفر كعدد جذري (rational). التابع to_c: يعيد الصفر كعدد عقدي. مصادر قسم التابع to_a‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

يعيد التابع readlines مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته. يشبه هذا التابع التابع gets( sep )‎. البنية العامة readlines(sep=$/) → array readlines(limit)→ array readlines(sep, limit) → array‎ المعاملات sep‎ يمثل هذا الوسيطُ الفاصل السطري بين البيانات المراد وضعها في عناصر المصفوفة المعادة. limit‎ يمثل هذا الوسيطُ الحد الأقصى للبيانات المقروءة. القيمة المعادة تعاد مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته حتى نهايته. انظر أيضا التابع readline: يقرأ التابع سطرًا واحدًا من أسطر الملف ...

يعدُّ التابع append اسمًا بديلًا للتابع push. انظر أيضًا التابع push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. مصادر قسم التابع append في الصنف Array في توثيق روبي الرسمي.

يعيد التابع values قيم هذه البنية على هيئة مصفوفة. البنية العامة values→ array‎ القيمة المعادة تعاد قيم هذه البنية على هيئة مصفوفة. أمثلة مثال على استخدام التابع values‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.to_a[1] #=> "123 Maple, Anytown NC"‎ انظر أيضًا التابع values_at: يُعيد قيم أعضاء البنية لكل معامل مُمرَّر إليه هيئة مصفوفة. مصادر قسم التابع values‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يُعيد التابع parameters معلوماتٍ عن معاملات كتلة محدَّدة من النوع proc. البنية العامة parameters → array القيم المعادة تُعاد مصفوفةٌ تتضمَّن معلوماتٍ عن معاملات الكتلة proc المعطاة. أمثلة مثالٌ عن استخدام التابع parameters: prc = lambda{|x, y=42, *other|} prc.parameters #=> [[:req, :x], [:opt, :y], [:rest, :other]] انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن proc الذي استدعي معه. التابع binding: يُعيد الرَّبط الموافق للكائن Proc الذي استدعي معه. التابع curry: يُعيد كتلة proc مقسَّمة. التابع to_s: يُعيد المُعرِّف ...

يعيد التابع length عدد عناصر المصفوفة التي استُدعيت معه. البنية العامة length → int القيم المعادة يعاد عدد صحيح يمثل عدد عناصر المصفوفة المعطاة. أمثلة أمثلة على استخدام التابع length: [ 1, 2, 3, 4, 5 ].length #=> 5 [].length #=> 0 انظر أيضًا التابع count: يعيد عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة ...

يضبط التّابع set_backtrace معلومات المصفوفة backtrace الخاصة بكائن الاستثناء. مصفوفة التتبع العكسي (backtrace) يجب أن تتكون من عدة سلاسل نصية أو سلسلة نصية واحدة بالتنسيق الموصوف في التابع backtrace. البنية العامة set_backtrace(backtrace) → array المعاملات backtrace المحتوى الجديد لمصفوفة التتبع العكسي الذي يراد تعيينه. القيم المعادة تُعاد مصفوفة backtrace جديدة بعد ضبط محتواها إلى backtrace. انظر أيضا التابع backtrace: يُعيد أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء. التابع backtrace_locations: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء. مصادر صفحة التابع set_backtrace في ...

يحول التابع to_a الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. البنية العامة to_a → array القيمة المعادة تعاد مصفوفة متشعبة من المصفوفات [ key, value ] تمثِّل ناتج تحويل الكائن Hash المعطى. أمثلة مثال على استعمال التابع to_a: h = { "c" => 300, "a" => 100, "d" => 400, "c" => 300 } h.to_a #=> [["c", 300], ["a", 100], ["d", 400]] انظر أيضًا التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا ...

يجلب التابع take أول n عنصر من مصفوفة. إن مرِّر عدد سالب إلى هذا التابع، فسيُطلَق الخطأ ArgumentError. البنية العامة take(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي العناصر n الأولى الموجودة في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع take: a = [1, 2, 3, 4, 5, 0] a.take(3) #=> [1, 2, 3] انظر ...

يعيد التابع shuffle ترتيب عناصر مصفوفة بشكل عشوائي ثم يضعها في مصفوفة جديدة. البنية العامة huffle → new_ary shuffle(random: rng) → new_ary المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: rng. القيم المعادة تعاد مصفوفة جديدة تحوي عناصر المصفوفة المعطاة مرتَّبةً بشكل عشوائي. أمثلة أمثلة على استخدام التابع shuffle: a = [ 1, 2, 3 ] #=> [1, 2, 3] a.shuffle ...

يضيف التابع concat جميع عناصر المصفوفات المُمرّرة إليه إلى المصفوفة التي استُدعيت معه. البنية العامة concat(other_ary1, other_ary2,...) → ary المعاملات other_ary1 المصفوفة الأولى المراد إضافة عناصرها إلى المصفوفة المعطاة. other_ary2 المصفوفة الثانية المراد إضافة عناصرها إلى المصفوفة المعطاة. … المصفوفات الأخرى المراد إضافة عناصرها إلى المصفوفة المعطاة. القيم المعادة تعاد المصفوفة المعطاة بعد إضافة المصفوفات other_ary1 و other_ary2 ...إلخ. المُمرَّرة إلى التابع إليها. أمثلة أمثلة على استخدام التابع concat: [ "a", "b" ].concat( ["c", "d"] ) #=> [ ...

يعيد التابع shuffle!‎ ترتيب عناصر مصفوفة بشكل عشوائي. البنية العامة shuffle! → ary shuffle!(random: rng) → ary المعاملات random يُستخدم هذا الوسيط الاختياري (إن أعطي) كمولد عشوائي لترتيب العناصر بحسب فهرسها. قيمته الافتراضية هي: rng. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها بشكل عشوائي. أمثلة أمثلة على استخدام التابع shuffle!‎: a = [ 1, 2, 3 ] #=> [1, 2, 3] a.shuffle! ...

يعيد التابع hash القيمة Hash للمصفوفة التي استُدعيت معه. إن كان لمصفوفتين نفس المحتوى، فسيكون لهما نفس قيمة Hash (وسيوازن بينهما باستخدام eql?‎). البنية العامة hash → integer القيم المعادة يعاد عدد صحيح يمثل القيمة Hash للمصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع hash: a = [ "a", "b", "c" ] a.hash # 2564204468492460516 انظر أيضًا التابع Object.hash: يعيد شيفرة Hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Array في توثيق روبي الرسمي.

يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. تتضمن هذه القائمة أسماء جميع الوحدات والأصناف المحددة في النطاق العام (global scope). البنية العامة constants→ array القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. أمثلة مثال على استخدام التابع constants‎: Module.constants.first(4) # => [:ARGF, :ARGV, :ArgumentError, :Array] Module.constants.include?(:SEEK_SET) # => false class IO Module.constants.include?(:SEEK_SET) # => true end‎ انظر أيضا التابع const_set: يضبط قيمة الثابت المعطى عند الكائن المحدد، ...

يعيد التابع ‎rect مصفوفة على هيئة [cmp.real, cmp.imag]، حيث يمثل cmp.real وcmp.imag الجزء الحقيقي والجزء التخيلي للعدد العقدي تواليا.  يُمثَّل العدد العقدي جبريًّا بالشكل: z = a + b.i. البنية العامة rect → array rectangular → array القيمة المعادة تعاد مصفوفة على هيئة [cmp.real, cmp.imag]، حيث يمثل cmp.real وcmp.imag الجزء الحقيقي والجزء التخيلي للعدد العقدي تواليا.  أمثلة أمثلة عن استخدام التابع rect: Complex(1, 2).rectangular #=> [1, 2] انظر أيضًا التابع ‎polar‎: يعيد مصفوفة على هيئة [cmp.abs, cmp.arg]، حيث يمثل ...

يجلب التابع first أول عنصر أو أول n عنصر من مصفوفة. البنية العامة first → obj or nil first(n) → new_ary المعاملات n عدد صحيح يحدد عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأول من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي أول n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة أمثلة ...

يبدل التابع 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 ...

يحذف التابع compact!‎ كل العناصر ذات القيمة nil من المصفوفة التي استدعيت معه ثم يعيدها. إن لم تحوي المصفوفة أي عنصر يساوي nil، فسيعيد التابع compact!‎ القيمة nil. البنية العامة compact! → ary or nil القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع العناصر ذات القيمة nil منها، أو تعاد القيمة nil إن لم تحوِ تلك المصفوفة على أي عنصر تساوي قيمة القيمة nil. أمثلة أمثلة على استخدام التابع compact!‎: [ "a", nil, "b", nil, "c" ].compact! ...

يبحث التابع rassoc عن عنصر محدد في العناصر الثانية للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه ثم يعيد المصفوفة الفرعية التي يُعثَر فيها على ذلك العنصر‎. تُجرَى عملية الموازنة بين العنصر الثاني من كل مصفوفة فرعية والقيمة الممررة إلى التابع باستعمال المعامل ==. البنية العامة rassoc(obj) → element_ary or nil المعاملات obj الكائن المراد البحث عنه. القيم المعادة تعاد المصفوفة الفرعية الموجودة في المصفوفة المعطاة والتي تطابقت القيمة obj مع العنصر الثاني فيها، أو تعاد القيمة nil إن لم يتطابق ...

البنية العامة to_proc() انظر أيضا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_proc في الصنف Hash في توثيق روبي الرسمي.

يعيد التابع to_s السلسلة النصية “ENV”. البنية العامة to_s → "ENV" القيمة المعادة تُعاد السلسلة النصية “ENV”. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.  التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. مصادر قسم التابع to_s في الصنف ENV في توثيق روبي الرسمي.

تُضمَّن الوحدة Kernel من طرف الصنف Object، لذلك فتوابعها متاحة في كل كائنات روبي. توابع نسخ الصنف Kernel مُوثّقة في صفحة الصنف Object، أما توابع الوحدة Kernel فهي مُوثقة هنا. تستدعى هذه التوابع بدون مستقبل (receiver)، وبالتالي يمكن استدعاؤها وفق الشكل الدالي: sprintf "%.1f", 1.234 #=> "1.2" توابع الصنف العامة (Public Class Methods) Array يعيد المعامل الممرَّر إليه على شكل مصفوفة (Array). Complex يعيد ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. Float Hash يعيد ناتج التعبير x + ...

يعيد التابع keys مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. البنية العامة keys → array القيمة المعادة تعاد مصفوفة جديدة تحوي مفاتيح الكائن Hash المعطى. أمثلة مثال على استعمال التابع keys: h = { "a" => 100, "b" => 200, "c" => 300, "d" => 400 } h.keys #=> ["a", "b", "c", "d"] انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. التابع key: يعيد المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي ...

يعيد التابع assoc‎ مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. البنية العامة assoc(name) → Array or nil المعاملات name اسم متغير البيئة المراد جلب القيمة المرتبطة به. القيمة المعادة تُعاد مصفوفةٌ تضم اسم وقيمة متغير البيئة ذي الاسم name، أو تُعاد القيمة nil في حال لم يكن ذلك المتغير موجودًا. انظر أيضًا التابع rassoc: يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي قيمة محدَّدة، أو يعيد القيمة nil ...

يعيد التابع values_at مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة. البنية العامة values_at(name, ...) → Array المعاملات name يمثل اسم متغير البيئة المراد جلب قيمته. ... تمثل أسماء متغيرات البيئة الأخرى المراد جلب قيمتها. القيمة المعادة تُعاد مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء name و ... المٌعطاة. انظر أيضًا التابع key: يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. في حال لم تكن تلك القيمة موجودة، فسيعيد التابع القيمة nil. التابع values : يعيد مصفوفة تضم جميع قيم متغيرات البيئة. مصادر قسم ...

يضيف التابع unshift الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. البنية العامة unshift(obj, ...) → ary المعاملات obj الكائن المراد إضافته في بداية المصفوفة المعطاة. … الكائنات الأخرى المراد إضافتها في بداية المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إضافة الكائن obj والكائنات الأخرى الممررة إلى بدايتها. أمثلة بعض أمثلة على استخدام التابع unshift: a = [ "b", "c", "d" ] a.unshift("a") #=> ["a", "b", "c", "d"] a.unshift(1, 2) ...

يبحث التابع assoc في العناصر الأولى للمصفوفات الفرعية الموجودة في المصفوفة المستدعاة معه عن الكائن المُمرّر إليها ثم يعيد المصفوفة الفرعية الأولى التي يكون أول عنصر فيها هو ذلك الكائن، أو يعيد القيمة nil في حالة عدم العثور على ذلك الكائن. تُجرَى عملية الموازنة بين العنصر الأول من كل مصفوفة فرعية والكائن obj باستعمال المعامل . البنية العامة assoc(obj) → element_ary or nil المعاملات obj الكائن المراد البحث في العناصر الأولى من المصفوفات الفرعية. القيم المعادة تعاد أول مصفوفة ...

يُحزِّمُ (packs) التابع pack محتويات المصفوفة التي استُدعيت معه على شكل تسلسل ثنائي (binary sequence) وفقًا للمُوجِّهات (directives) الواردة في المعامل aTemplateString؛ يمكن أن يتبع المُوجِّهات ","" و "A"" و ""a"" عددًا يحدّد عرض الحقل الناتج. قد تأخذ المُوجّهات المتبقية عددًا أيضًا مما يشير إلى عدد عناصر المصفوفة المطلوب تحويلها. إذا كان العدد يمثِّل محرف النجمة ("*")، فستُحوَّل جميع عناصر المصفوفة المتبقية. يمكن أن تُتبَع أيٌّ من المُوجّهات "sSiIlL" بشرطة سفلية ("_") أو إشارة تعجب ("!") لاستخدام الحجم الأصلي للمنصة ...