نتائج البحث

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

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

يجلب التابع rindex فهرس آخر ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس آخر عنصر يحقق شرطًا محدَّدًا. في حال عدم تمرير أي شيء إلى التابع rindex، سيعيد‎ كائنًا من النوع Enumerator. البنية العامة rindex(obj) → int or nil rindex { |item| block } → int or nil rindex → Enumerator المعاملات obj الكائن المراد جلب فهرس آخر ظهور له في المصفوفة المعطاة. القيم المعادة يعاد عددٌ صحيحٌ يمثِّل فهرس آخر ظهور للعنصر obj من المصفوفة ...

يجلب التابع index‎ فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. في حال عدم تمرير أي شيء إلى التابع index، سيعيد‎ كائنًا من النوع Enumerator. البنية العامة index(obj) → int or nil index { |item| block } → int or nil index → Enumerator المعاملات obj كائن يراد جلب قيمة فهرسه من المصفوفة المعطاة. القيم المعادة يعاد عددٌ صحيحٌ يمثِّل فهرس ...

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

يضبط التابع fill قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه (الأشكال الثلاث الأولى للتابع في قسم «البنية العامة»)، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه (الأشكال الثلاث المتبقية). البنية العامة fill(obj) → ary fill(obj, start [, length]) → ary fill(obj, range ) → ary fill { |index| block } → ary fill(start [, length] ) { |index| block } → ary fill(range) { |index| block } → ary المعاملات obj الكائن المراد أن يحل مكان عناصر محددة (باستعمال المعاملات ...

يشبه التابع repeated_permutation التابع permutation باستثناء أنَّه يستطيع إنشاء تبديلات للعناصر مع نفسها (أي تكرار العناصر نفسها) وأنه لا يمكن استدعاؤه دون تمرير عدد العناصر المراد التبديل بينها إليه. لا يوجد أي ضمان للتنبؤ بترتيب العناصر المعادة. إن لم تُمرَّر أي كتلة (block) إلى هذا التابع، فسيعيد كائنًا من النوع Enumerator. البنية العامة repeated_permutation(n) { |p| block } → ary repeated_permutation(n) → Enumerator المعاملات n عدد صحيح يحدد عدد عناصر المصفوفات الفرعية المراد تبديل عناصر المصفوفة المعطاة مع بعضها بعضًا. القيم ...

يجلب التابع find_index فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. في حال عدم تمرير أي وسيط أو كتلة برمجية إلى التابع find_index، فسيعيد كائنًا من النوع Enumerator. البنية العامة find_index(obj) → int or nil find_index { |item| block } → int or nil find_index → Enumerator المعاملات obj الكائن المراد جلب فهرسه من المصفوفة المعطاة. القيم المعادة يعاد عددٌ صحيح يمثِّل فهرس أول ظهور للعنصر obj من المصفوفة المعطاة أو فهرس أول عنصر يحقق ...

يشبه التابع reverse_each التابع each تمامًا باستثناء أنَّه يطبق الكتلة البرمجية على العناصر بدءًا من العنصر الأخير وحتى العنصر الأول. إن لم تمرَّر أيَّة كتلة إلى التابع reverse_each، فسيُعيد كائنًا من النوع Enumerator. البنية العامة reverse_each { |item| block } → ary reverse_each → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على كل عنصر من عناصرها بدءًا من العنصر الأخير وحتى العنصر الأول، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block. أمثلة أمثلة على ...

يستدعي التابع each كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة. إن لم تمرَّر أيَّة كتلة إلى التابع each، فسيُعيد كائنا من النوع Enumerator. البنية العامة each { |item| block } → ary each → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على قيمة كل عنصر من عناصرها، أو يعاد كائنٌ من النوع Enumeratorإن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام ...

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

يبحث التابع bsearch باستخدام البحث الثنائي (binary search) عن قيمة من مصفوفة تحقق شرطًا منطقيًّا محددًا ويستغرق ‎O(log n)‎، إذ n حجم المصفوفة. يوجد وضعان لاستعمال هذا التابع هما: وضع البحث عن الحد الأدنى (find-minimum mode)، ووضع البحث العام (find- any mode). في كلتا الحالتين، يجب أن تكون عناصر المصفوفة مرتبةً بالتوافق مع الكتلة البرمجية المحدَّدة. في وضع البحث عن الحد الأدنى (يعدُّ هذا خيارًا جيدًا لحالات الاستخدام الاعتياديَّة)، يجب أن تعيد الكتلة البرمجية القيمة true أو القيمة false دومًا ...

يعيد التابع end موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية. البنية العامة end(n)→ integer‎ المعاملات n‎ يحدد رقم عنصر من مصفوفة التطابق في السلسلة النصية. يمكن أن يكون سلسلة نصية أو رمزًا للإشارة إلى جزء مُطابق (capture) معيّن القيمة المعادة يعاد موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية. أمثلة مثال على استخدام التابع end‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.end(0) #=> 7 m.end(2) ...

يعيد التابع begin موضع (مقدار إزاحة [offset]) بداية العنصر n من مصفوفة التطابق في السلسلة النصية. البنية العامة begin(n)→ integer‎ المعاملات n‎ يحدد رقم عنصر من مصفوفة العناصر المتطابقة في السلسلة النصية. يمكن أن يكون سلسلةً نصيةً أو رمزًا للإشارة إلى جزء مُطابق (capture) معيّن. القيمة المعادة يعيد التابع begin موضع بداية العنصر رقم n من مصفوفة التطابق في السلسلة النصية. أمثلة مثال على استخدام التابع begin‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.begin(0) #=> 1 m.begin(2) ...

يحول التابع 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 في توثيق روبي الرسمي.

يبحث التابع bsearch_index باستخدام البحث الثنائي (binary search) عن فهرسٍ لعنصر من مصفوفة يحقق شرطًا منطقيًّا محددًا ويستغرق ‎O(log n)‎، إذ n هي حجم المصفوفة. يدعم هذا التابع وضعين بحسب نوع الكتلة المحددة؛ هذان الوضعان مشابهان للوضعين في التابع bsearch مع فارق وحيد وهو أنَّ هذا التابع يعيد فهرس العنصر بدلًا من العنصر نفسه. راجع صفحة التابع bsearch لمزيد من التفاصيل. البنية العامة bsearch_index {|x| block } → int or nil القيم المعادة يعاد عدد صحيح يمثل فهرس أول ...

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

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

يجلب التابع take_while العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى. إن لم تمرَّر أية كتلة إلى التابع take_while، فسيعيد كائنًا من النوع Enumerator. البنية العامة take_while { |obj| block } → new_ary take_while → Enumerator القيم المعادة تعاد مصفوفة جديدة تحوي العناصر الأولى التي تعاد معها القيمة true عند تطبيق الكتلة block عليها إلى أن تعاد القيمة false أو القيمة ...

يعيد التابع 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 الكائن 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 المعطى نفسه. إذا ...

يعيد التابع grep مصفوفة تحوي كل عنصر مطابق لنمط محدَّد من عناصر الكائن القابل للتعداد الذي استدعي معه. إن أعطيت كتلة، فسيُمرَّر كل عنصر مطابق للنمط إليها ثم تعاد مصفوفة تحوي النتائج المقابلة التي تعيدها هذه الكتلة للعناصر المطابقة. البنية العامة grep(pattern) → array grep(pattern) { |obj| block } → array المعاملات pattern النمط المراد مطابقته لكل عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد مصفوفة تحوي كل عنصر مطابق للنمط pattern من عناصر الكائن القابل للتعداد المعطى، أو القيم التي ...

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

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

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

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

يعيد التابع uniq مصفوفة جديدة تحوي جميع عناصر الكائن القابل للتعداد المعطى بعد حذف العناصر المتكررة منه. البنية العامة uniq → new_ary uniq { |item| ... } → new_ary القيمة المعادة تعاد مصفوفة جديدة تحوي جميع عناصر الكائن القابل للتعداد المعطى بعد حذف العناصر المتكررة منه. أمثلة مثال على استعمال التابع uniq: a = [0, 1, 2, 2, 3, 4, 4, 5, 0] a.uniq #=> [0, 1, 2, 3, 4, 5] انظر أيضًا التابع reject: يعيد مصفوفة تحوي جميع عناصر الكائن القابل للتعداد ...

يُعيد التابع lines مصفوفة كل عنصر منها سطرًا من سطور السلسلة النصية المعطاة. هذا التابع هو اختصار للاستدعاء str.each_line.to_a. في حال إعطاء كتلة، والتي هي الشكل المهمل من هذا التابع، فسيسلك هذا التابع نفس سلوك التابع each_line تمامًا. البنية العامة lines(separator=$/) → an_array المعاملات separator الفاصل الذي سيُّقسِّم محتوى السلسلة النصية إلى أجزاء لوضع كلٍّ منها في عنصر من عناصر المصفوفة المعادة. القيمة الافتراضية هي: /$ (الفاصل السطري). القيمة المعادة تُعاد مصفوفة تحوي عناصرها أجزاء السلسلة النصية المعطاة المفصولة عن ...

يدمج التابع zip بين كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه مع العناصر المقابلة له من كل معامل من المعاملات المُمرَّرة إليه. هذا يولد سلسلة من المصفوفات المكونة من n عنصر، إذ n هي عدد أكبر من عدد المعاملات المُمرَّرة بمقدار 1. طول السلسلة الناتجة ستكون enum.size. إن كان طول أي معامل أقل من enum.size، فستحل القيم nil مكان العناصر الشاغرة. إن أعطيت كتلة، فستُستدعَى لكل مصفوفة ناتجة؛ خلا ذلك، ستُعاد مصفوفة من المصفوفات الناتجة. البنية العامة zip(arg, ...) ...

الصنف MatchData هو نوع المتغير الخاص ‎$~‎ ، كما أنه نوع الكائنات المُعادة من Regexp.match و Regexp.last_match. فهو يغلف ويستوعب جميع نتائج التطابق مع تعبير نمطي. يمكن الوصول إلى النتائج من خلال المتغيرات الخاصة ‎$&‎ و ‎$'‎ و $ و ‎$`‎ و ‎$1 و ‎$2 وهكذا دواليك. توابع الصنف العامة (Public Class Methods) == يتحقق المعامل == من تطابق كائنان من النوع matchdata إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة. [] تتصرف الكائنات MatchData كمصفوفة، لذا يمكن الوصول إليها باستخدام تقنيات ...

يبحث التابع rassoc خلال الكائن Hash الذي استدعي معه عن طريق مقارنة القيمة التي مُمرِّرت إليه مع قيم ذلك الكائن باستخدام المعامل == ثم يعيد أول زوج قيمة-مفتاح متطابق. البنية العامة rassoc(obj) → an_array or nil المعاملات obj الكائن الذي سيُبحَث عنه في الكائن Hash المعطى. القيمة المعادة تعاد مصفوفة من عنصرين تحوي الزوج مفتاح/قيمة المطابقة للقيمة obj المبحوث عنها في الكائن Hash المعطى، أو تعاد القيمة nil إن لم يُعثر على شيء. أمثلة مثال على استعمال التابع rassoc: a = ...

يعيد التابع 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: يضبط قيمة الثابت المعطى عند الكائن المحدد، ...

يعدُّ التابع grep_v نسخة معاكسة للتابع grep، إذ يعيد مصفوفة تحوي كل العناصر الغير مطابقة لنمط محدَّد من عناصر الكائن القابل للتعداد المعطى. البنية العامة grep_v(pattern) → array grep_v(pattern) { |obj| block } → array المعاملات pattern النمط المراد مطابقته لكل عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد مصفوفة تحوي كل عنصر غير مطابق للنمط pattern من عناصر الكائن القابل للتعداد المعطى، أو القيم التي تعيدها الكتلة لكل عنصر غير مطابق للنمط بعد تمريره إليها. أمثلة مثال على استعمال التابع ...

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

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

يعيد التابع count عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة (يتحقق من ذلك باستعمال المعامل ==) أو عدد العناصر التي تحقق شرطًا محددًا. البنية العامة count → int count(obj) → int count { |item| block } → int المعاملات obj كائن يراد معرفة عدد العناصر المتساوية مع قيمته في المصفوفة المعطاة. القيم المعادة يعاد عدد صحيح (أي من النوع int) يمثِّل عدد عناصر المصفوفة المعطاة إن لم يمرَّر أي شيء إلى الدالة. إن مرِّرت الوسيط ...

يعيد التابع map مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة المعطاة بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة map { |obj| block } → array map → an_enumerator القيمة المعادة تعاد مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر الكائن القابل للتعداد المعادة من الكتلة block بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعاد كائن من النوع Enumerator. أمثلة مثال على استعمال التابع map: ...

يضبط التابع groups عند استدعائه بالشكل groups= array قائمة وصول المجموعات الإضافية إلى المصفوفة array المكونة من مُعرِّفات المجموعات للعملية الحالية. البنية العامة groups= array → array القيم المعادة تعاد المصفوفة array المعطاة بعد تعيينها إلى قائمة وصول المجموعات الإضافية للعملية الحالية. أمثلة مثال على استعمال التابع groups: Process.groups #=> [0, 1, 2, 3, 4, 6, 10, 11, 20, 26, 27] Process.groups = [27, 6, 10, 11] #=> [27, 6, 10, 11] Process.groups #=> [27, 6, 10, ...

يعيد التابع entries‎ مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط encoding الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات. البنية العامة entries( dirname ) → array entries( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المراد معرفة محتوياته. encoding ترميز المجلد. القيمة المعادة تُعاد مصفوفةٌ تحوي جميع أسماء الملفات في المجلد المحدد. أمثلة مثال عن استخدام التابع entries ...

يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها من الوحدة. هذا يتضمن أسماء الثوابت في الوحدات المُتضمنة إلا إن مُرِّرت القيمة false. لا يوجد ضمانة لمعرفة الترتيب الذي ستُعاد به الثوابت. البنية العامة constants(inherited)→ array‎ المعاملات inherited‎ قيمة منطقية إن كانت false، فلن تشمل المصفوفة المعادة أسماء الثوابت في الوحدات المُتضمنة. القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها من الوحدة. أمثلة مثال على استخدام التابع constants‎: IO.constants.include?(:SYNC) ...

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

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

يعيد التابع 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 : يعيد مصفوفة تضم جميع قيم متغيرات البيئة. مصادر قسم ...

يقرأ التابع readlines ملفًا بأكمله سطرًا سطرًا ثم يعيد تلك الأسطر في مصفوفة. إن كان الوسيط الأخير عبارة عن جدول Hash، فسيمثِّل الوسيط المسمى (keyword argument) المراد فتحه. البنية العامة readlines(name, sep=$/ [, getline_args, open_args]) → array readlines(name, limit [, getline_args, open_args])→ array readlines(name, sep, limit [, getline_args, open_args]) → array‎ المعاملات name‎ اسم الملف المراد قراءة أسطره ووضعها في مصفوفة. sep‎ الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: /$. getline_args‎ كائن من النوع Hash يقبل المفتاح الوحيد التالي: ‎:chomp - عندما ...

يعيد التابع children‎ مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط الاختياري encoding الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه. البنية العامة children( dirname ) → array children( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المُحدد المراد معرفة محتواه. encoding ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات. القيمة المعادة تُعاد مصفوفة تحوي جميع ...

إن كان العدد المُمرَّر إلى التابع numeric من نفس نوع العدد الذي استُدعي معه، فسيعيد مصفوفة تحوي هذين العددين. خلاف ذلك، سيحول هذين العددين إلى النوع Float ويعيدهما في مصفوفة. تُستخدَم هذه الآلية من التحويل للتعامل مع العمليات العددية التي تكون أنواع الأعداد فيها مختلفة؛ الغرض الأساسي من هذا التابع هو إيجاد نوعٍ متوافق بين عددين أو تحويلهما إلى النوع نفسه. البنية العامة coerce(numeric) → array‎ المعاملات numeric‎ العدد الثاني الذي سيُتحقق من مطابقة نوعه للعدد المعطى. القيمة ...

يرتِّب التابع sort_by عناصر الكائن القابل للتعداد الذي استدعي معه باستعمال مجموعة من المفاتيح المولدة عبر تمرير قيم العناصر إلى الكتلة المعطاة. لا يُضمَن بأن تكون النتيجة مستقرة. عندما تعيد عملية الموازنة بين مفتاحين القيمة 0، إذ لن يُتوقَع كيفية ترتيب هذين العنصرين ومن منهما سيسبق الآخر. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة sort_by { |obj| block } → array sort_by → an_enumerator التنفيذ الحالي للتابع sort_by يولد مصفوفةً من الصفوف (tuples) تحوي مجموعة العناصر الأصلية ...

يجلب التابع groups مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. البنية العامة groups → array القيم المعادة تعاد مصفوفة تحوي مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. أمثلة مثال على استعمال التابع groups: Process.groups #=> [27, 6, 10, 11] انظر أيضًا التابع getpgid: يعيد مُعرِّف المجموعة المالكة لعملية محدَّدة. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع groups=‎: يضبط عند استدعائه بالشكل groups= ...

يوفر المخلوط Enumerable مجموعة من الأصناف مع توابع بحث ونقل (traversal) عديدة قادرة على ترتيب عناصر مجموعة مع بعضها بعضًا. يجب أن يوفر الصنف التابع each الذي يعيد العضو التالي من المجموعة. إن استعمل التابع max، أو mix، أو sort، فيجب أن يُوازَن بين الكائنات في المجموعة باستعمال المعامل <=> الذي تعتمد عليه تلك التوابع في ترتيب عناصر المجموعة الواحدة مع بعضها بعضًا. توابع النسخة العامة all?‎ يتحقق إن كان كل عنصر من عناصر المجموعة التي استدعيت معه محقَّقًا للكتلة ...

لكي نسند شيئًا في لغة روبي، نستخدم رمز المساواة =؛ ففي المثال التّالي، يُسنَد العدد 5 إلى المتغيّر v المحلّي: v = 5 فالإسناد يُنشئ متغيّرًا محلّيًا جديدًا إذا لم يكن قد عُرِّفَ من قبل. أسماء المتغيرات المحلية اسم المتغيّر المحلّي يجب أن يبدأ بحرف صغير من مجموعة المحارف US-ASCII أو من مجموعة المحارف التي تُمثَّل باستخدام ثمان بتات ثنائيّة. وبشكلٍ عام، فإنّ أسماء المتغيّرات المحلّية متوافقة مع US-ASCII كون الأزرار التي تستخدم لكتابتها موجودة في جميع لوحات المفاتيح. عمومًا، جميع ...

يعيد التابع reject مصفوفة تحوي جميع عناصر الكائن القابل للتعداد الذي استدعي معه باستثناء تلك التي لم تحقق الكتلة المعطاة (أي التي أعادت معها القيمة false عند تمريرها إليها). إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة reject { |obj| block } → array reject → an_enumerator القيمة المعادة تعاد مصفوفة تحوي جميع عناصر الكائن القابل للتعداد الذي استدعي معه باستثناء تلك التي لم تحقق الكتلة المعطاة (أي التي أعادت معها القيمة false عند تمريرها إليها)، أو ...

يعيد التابع 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‎ في توثيق روبي الرسمي.

يمرر التابع select قيم كل أعضاء البنية إلى الكتلة المعطاة ويعيد مصفوفة تحتوي قيم الأعضاء التي أعادت الكتلة معها القيمة true. هذا التابع يكافئ التابع Enumerable.select. البنية العامة select {|obj| block } → array select → enumerator‎ القيمة المعادة تعاد مصفوفة تحوي أعضاء البنية التي أعيدت القيمة true معها بعد تمريرها إلى الكتلة block المعطاة. يعاد كائن من النوع enumerator إن لم تعطَ الكتلة block. أمثلة مثال على استخدام التابع select‎: Lots = Struct.new(:a, :b, :c, :d, :e, :f) l = ...

يحذف التابع drop_while العناصر الأولى المحقِّقة لشرط معيِّن من المُعدِّد المعطى ثم يعيد مصفوفة تحوي العناصر المتبقية. البنية العامة drop_while { |obj| block } → array drop_while → an_enumerator القيمة المعادة تعاد مصفوفة تحوي جميع عناصر المُعدِّد المعطى باستثناء العناصر الأولى التي لا تعاد معها القيمة nil أو false عند تمريرها إلى الكتلة. أمثلة مثال على استعمال التابع drop_while: a = [1, 2, 3, 4, 5, 0] a.drop_while { |i| i < 3 } #=> [3, 4, 5, 0] انظر أيضًا التابع ...

يحذف التابع drop أول عدة عناصر من المُعدِّد الذي استدعي معه ثم يعيد بقية العناصر في مصفوفة. البنية العامة drop(n) → array المعاملات n عدد العناصر الأولى المراد حذفها من المُعدِّد المعطى. القيمة المعادة تعاد مصفوفة تحوي جميع عناصر المُعدِّد المعطى باستثناء أول n عنصر. أمثلة مثال على استعمال التابع drop: a = [1, 2, 3, 4, 5, 0] a.drop(3) #=> [4, 5, 0] انظر أيضًا التابع detect: يمرِّر كل ...

يعيد التّابع backtrace أيَّ تتبع عكسي (backtrace) مرتبط بالاستثناء. التتبع العكسي (backtrace) هو مصفوفةٌ من السّلاسل النصية، تحوي كل واحدةٍ منها إمّا "filename:lineNo: in 'method'‎'' أو ".filename:lineNo''. البنية العامة backtrace → array القيم المعادة تُعاد مصفوفة تمثل التتبع العكسي. أمثلة مثالٌ عن استخدام التابع backtrace: def a raise "boom" end def b a() end begin b() rescue => detail print detail.backtrace.join("\n") end سيعطي هذا المثال عند تنفيذه الناتج التالي: prog.rb:2:in `a' prog.rb:6:in `b' prog.rb:10 انظر أيضا التابع backtrace_locations: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء. ...

يعيد التابع flatten مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash الذي استدعي معه. أي أنَّ لكل مفتاح أو قيمة تكون مصفوفة، تستخرج عناصرها إلى مصفوفة جديدة. على عكس Array.flatten، لا يُسطِّح هذا التابع بشكل عَودي (recursively) افتراضيًا. يمكن تحديد مستوى عودية التسطيح عبر تمرير قيمة إلى التابع. البنية العامة flatten → an_array flatten(level) → an_array المعاملات level عدد صحيح يحدد مستوى عودية التسطيح. القيمة المعادة تعاد مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash المعطى. أمثلة مثال على استعمال ...

يعيد التابع values_at مصفوفةً تحتوي على القيم المرتبطة بمفاتيح محدَّدة من الكائن Hash الذي استدعي معه. البنية العامة values_at(key, ...) → array المعاملات key المفتاح المراد جلب القيمة المرتبطة به. ... المفاتيح الأخرى المراد جلب القيم المرتبطة بها. القيمة المعادة تعاد مصفوفةً تحتوي على القيم المرتبطة بالمفاتيح key و ... من الكائن Hash المعطى. أمثلة مثال على استعمال التابع values_at: h = { "cat" => "feline", "dog" => "canine", "cow" => "bovine" } h.values_at("cow", "cat") #=> ["bovine", "feline"] انظر أيضا التابع ...

يبحث التابع scan عن نمط محدَّد ضمن السلسلة النصية التي استدعيت معه ويعيد النتائج المتطابقة في مصفوفة أو يمرِّرها إلى الكتلة المعطاة ويعيد الناتج الذي تعيده. البنية العامة scan(pattern) → array scan(pattern) {|match, ...| block } → str المعاملات pattern تعيبر نمطي أو سلسلة نصية يراد البحث عنها ومطابقتها في السلسلة النصية المعطاة. إن لم يحتوي هذا المعامل على مجموعات، فستتألف كل نتيجة فردية من السلسلة النصية المتطابقة (أي &$). أمَّا إن احتوى على مجموعات، فستكون كل نتيجة فردية مصفوفةً بحد ...

يعيد التابع used_modules مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. ترتيب الوحدات في المصفوفة الناتجة غير محدد. البنية العامة used_modules → array‎ القيمة المعادة تعاد مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. أمثلة مثال على استخدام التابع used_modules‎: module A refine Object do end end module B refine Object do end end using A using B p Module.used_modules‎ ناتج تنفيذ الشيفرة هو: [B, A] انظر أيضا التابع using: يستورد الأصناف المهذبة (class refinements) من الوحدة في التعريف الحالي للصنف أو الوحدة. ...

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

ينتظر التابع wait2 خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) تلك العملية. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. البنية العامة wait2(pid=-1, flags=0) → [pid, status] المعاملات pid مُعرِّف العملية المراد انتظارها. اطلع على صفحة التابع wait لمزيد من التفاصيل حول هذا المعامل. flags اطلع على صفحة التابع wait لمزيد من التفاصيل حول هذا المعامل. القيم المعادة تعاد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) العملية ...

يعيد التابع collect_concat مصفوفة جديدة مع نتائج متصلة لتنفيذ الكتلة المعطاة مع كل عنصر من عناصر المُعدِّد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة collect_concat { |obj| block } → array collect_concat → an_enumerator القيمة المعادة تعاد مصفوفة تحوي نتائج تنفيذ الكتلة المعطاة بشكل متصل (concatenated) مع كل عنصر من عناصر المُعدِّد المعطى، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع collect_concat: [1, 2, 3, 4].collect_concat ...

يفكك التابع digits‎ العدد الذي استٌدعي معه عبر تقسيم الأرقام التي تكوّنه من اليسار إلى اليمين، بحيث تكون أصغر من الوسيط الممرر إليه ثم يضعها في مصفوفة، مع وضع الرقم الأقل أهمية (least significant digit) في بداية المصفوفة. البنية العامة digits → array digits(base) → array‎ المعاملات base‎ عدد صحيح يمثل الأساس. يجب أن تكون قيمته أكبر من أو تساوي 2. القيمة الافتراضية: 10. القيمة المعادة تعاد مصفوفة تضم ناتج تفكيك العدد الذي استٌدعي معه. أمثلة مثال على ...

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

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

يُعيد التابع chars محارف السلسلة النصية على شكل مصفوفة. هذا التابع هو اختصار للاستدعاء str.each_char.to_a. في حال إعطاء كتلة، والتي هي الشكل المهمل من هذا التابع، فسيسلك هذا التابع نفس سلوك التابع each_char تمامًا. البنية العامة chars → an_array القيمة المعادة تُعاد مصفوفة من محارف السلسلة النصية. أمثلة مثال على استعمال التابع bytes: "hello world".each_char.to_a  #=> ["h", "e", "l", "l", "o", " ", "w", "o", "r", "l", "d"] انظر أيضًا التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. ...

يعيد التابع first الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. البنية العامة first → obj first(n) → an_array‎ المعاملات n‎ ‎عدد صحيح يمثِّل عدد العناصر الأولى المراد جلبها من المجال المعطى. القيمة المعادة يعاد الكائن الأول في المجال المعطى، أو تعاد مصفوفة مكونة من أول n عنصر. أمثلة مثال على استخدام التابع first‎: (10..20).first #=> 10 (10..20).first(3) #=> [10, 11, 12]‎ انظر أيضا التابع last: يعيد الكائن الأخير في المجال، أو يعيد مصفوفة مكونة ...

يشبه الصنف ENV الجداول Hash كثيرًا ويُستعمل للوصول إلى متغيرات البيئة. توابع الصنف العامة (Public Class Methods) [] يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. [] يضبط هذا المعامل عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسمname إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك. assoc يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. clear يحذف ...

يُقسِّم التابع split السلسلة النصية التي استدعي معها إلى سلاسل نصية فرعية اعتمادًا على فاصل محدَّد ثم يعيد تلك السلاسل الفرعية في مصفوفة. البنية العامة scan(pattern) → array scan(pattern) {|match, ...| block } → str المعاملات pattern إن كان هذا المعامل سلسلة نصية، فستُسعمَل هذه السلسلة على أنَّها الفاصل الذي يفصل أجزاء السلسلة النصية المعطاة عن بعضها بعضًا. أمَّا إن كان هذا المعامل فراغًا واحدًا، فستُقسَّم السلسلة النصية المعطاة عند كل فراغ موجود بين كلماتها؛ وعند وجود أكثر من فراغ واحد، ...

ينتظر التابع waitpid2 خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) تلك العملية. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. البنية العامة waitpid2(pid=-1, flags=0) → [pid, status] المعاملات pid مُعرِّف العملية المراد انتظارها. اطلع على صفحة التابع wait2 لمزيد من التفاصيل حول هذا المعامل. flags اطلع على صفحة التابع wait2 لمزيد من التفاصيل حول هذا المعامل. القيم المعادة تعاد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) العملية ...

يبحث التابع partition عن تطابق نص أو نمط محدد ضمن السلسلة النصية التي استدعي معها. فإذا عثر التابع على تطابق، فإنه يعيد مصفوفة تحوي الجزء الذي يسبقه، والجزء المتطابق، والجزء الذي يليه على التوالي. إذا لم يعثر التابع على تطابق؛، فإنه يعيد مصفوفة من السلسلة النصية المعطاة وسلسلتين فارغتين بعدها على التوالي. البنية العامة partition(sep) → [head, sep, tail] partition(regexp) → [head, match, tail] المعاملات sep السلسلة النصية المُراد البحث عن تطابق لها ضمن السلسلة النصية المُعطاة. regexp التعبير النمطي المراد ...

يقرأ التابع to_a الملف الحالي في المجرى ARGF بشكل كامل ثم يضع محتوياته في مصفوفة. البنية العامة to_a(sep=$/) → array to_a(limit) → array to_a(sep, limit) → array المعاملات sep المحرف المستعمل كفاصل سطري في الملف المراد القراءة منه. القيمة الافتراضية هي: /$. limit عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. القيم المعادة تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى ARGF، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. أمثلة مثال ...

يجلب التابع take_while العناصر الأولى التي تحقق الكتلة المعطاة من الكائن القابل للتعداد الذي استدعي معه. البنية العامة take_while { |obj| block } → array take_while → an_enumerator القيمة المعادة تعاد مصفوفة تحوي العناصر الأولى من الكائن القابل للتعداد المعطى المحققة للكتلة block حتى أول عنصر تعيد الكتلة معه القيمة false أو nil، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع take_while: a = [1, 2, 3, 4, 5, 0] a.take_while { |i| i < 3 ...

يعيد التابع collect مصفوفة جديدة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة collect { |obj| block } → array collect → an_enumerator القيمة المعادة تعاد مصفوفة تحوي نتائج تنفيذ الكتلة المعطاة دفعةً واحدةً مع كل عنصر من عناصر المُعدِّد المعطى، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع collect: (1..4).map { |i| ...

يحول التابع coerce العدد المستدعى معها والعدد العشري المُمرَّر إليها إلى النوع Float ويعيدهما في مصفوفة. البنية العامة coerce(numeric) → array‎ المعاملات numeric‎ العدد الثاني الذي سيحول إلى النوع Float ويعاد في مصفوفة. القيمة المعادة تُعاد مصفوفة تحوي العددين numeric و num بعد تحويل العدد numeric إلى النوع Float. أمثلة مثال على استخدام التابع coerce‎: 1.2.coerce(3) #=> [3.0, 1.2] 2.5.coerce(1.1) #=> [1.1, 2.5] انظر أيضا التابع to_s: يحول العدد العشري ...

يُعيد التابع codepoints نقاط الترميز المقابلة لمحارف السلسلة النصية في مصفوفة. هذا التابع هو اختصار للاستدعاء str.each_codeponit.to_a. في حال إعطاء كتلة، والتي هي الشكل المهمل من هذا التابع، فسيسلك هذا التابع نفس سلوك التابع each_codepoint تمامًا. البنية العامة codepoints → an_array القيمة المعادة تعاد مصفوفة من نقاط الترميز المقابلة لمحارف السلسلة. أمثلة أمثلة على استعمال التابع codepoints: "hello".each_codepoint.to_a   #=> [104, 101, 108, 108, 111] "hello".each_codepoint {|c| print c-100, ' ' }  #=> 4 1 8 8 11 hello انظر أيضًا التابع ...

يعيد التابع flat_map مصفوفة جديدة تحوي النتائج المجمَّعة الناتجة عن تنفيذ الكتلة المعطاة مع كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة flat_map { |obj| block } → array flat_map → an_enumerator القيمة المعادة تعاد مصفوفة جديدة تحوي النتائج المجمَّعة الناتجة عن تنفيذ الكتلة block مع كل عنصر من عناصر الكائن القابل للتعداد المعطى. أمثلة مثال على استعمال التابع flat_map: [1, 2, 3, 4].flat_map { |e| [e, -e] ...

يعيد التابع peek_values مصفوفة تحوي القيمة التالية في المُعدِّد الذي استدعي معه بشكل مشابه للتابع next_values ولكن لا يحرِّك موضع المؤشر الداخلي للأمام. إن كان المؤشر موجود مسبقًا في النهاية، فسيُطلَق الاستثناء StopIteration.  البنية العامة peek_values → array القيمة المعادة تعاد مصفوفة تحوي القيمة التالية في المُعدِّد المعطى. أمثلة مثال على استعمال التابع peek_values: o = Object.new def o.each yield yield 1 yield 1, 2 end e = o.to_enum p e.peek_values #=> [] e.next p e.peek_values #=> [1] p ...

يبحث التابع max عن قيمة أكبر عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه ثم يعيده. إن أعطيت كتلة، فسيعيد التابع أكبر عنصر يحقق شرطًا معيَّنًا؛ أي تُجرَى عملية الموازنة عبر المعامل <=> بحسب العملية التي تنفذها الكتلة على كل عنصر والقيمة المقابلة التي تعيدها. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات n إن أعطي هذا المعامل، فسيُعاد أكبر n عنصر في مصفوفة. تُرتَّب العناصر آنذاك ...

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

يبحث التابع min عن قيمة أصغر عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه ثم يعيده. إن أعطيت كتلة، فسيعيد التابع أصغر عنصر يحقق شرطًا معيَّنًا؛ أي تُجرَى عملية الموازنة عبر المعامل <=> بحسب العملية التي تنفذها الكتلة على كل عنصر والقيمة المقابلة التي تعيدها. البنية العامة min → obj min { |a, b| block } → obj min(n) → array min(n) { |a, b| block } → array المعاملات n إن أعطي هذا المعامل، فسيُعاد أصغر n عنصر في مصفوفة. ترتَّب العناصر آنذاك ...

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

يعيد التابع fetch_values مصفوفة تحتوي على القيم المقترنة بالمفاتيح المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح. البنية العامة fetch_values(key, ...) → array fetch_values(key, ...) { |key| block } → array المعاملات key المفتاح الذي يراد جلب القيمة المقترنة به. ... المفاتيح الأخرى المراد جلب القيم المقترنة بها. القيمة المعادة تعاد مصفوفة تحتوي على القيم المقترنة بالمفاتيح key و ... المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح. أمثلة مثال على استعمال التابع fetch_values: h = { "cat" ...

يبحث التابع rpartition عن تطابق نص أو نمط محدد بدءًا من نهاية السلسلة النصية ثم يعيد، إذا عثر التابع على تطابق، مصفوفةً من الجزء الذي يسبقه، والجزء المطابق، والجزء الذي يليه على التوالي. إذا لم يعثر التابع على تطابق، فإنَّه يعيد مصفوفة من سلسلتين فارغتين والسلسلة النصية المعطاة بعدهما على التوالي. البنية العامة rpartition(sep) → [head, sep, tail] rpartition(regexp) → [head, match, tail] المعاملات sep السلسلة النصية المُراد البحث عن تطابق لها ضمن السلسلة النصية المُعطاة. regexp التعبير النمطي المراد البحث ...

يعيد التابع select مصفوفة تحتوي على جميع عناصر الكائن القابل للتعداد الذي استدعي معه باستثناء تلك التي تحقق الكتلة المعطاة (أي التي تعيد معها قيمة صحيحة عند تمريرها إليها). إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة select { |obj| block } → array select → an_enumerator القيمة المعادة تعاد مصفوفة تحتوي على جميع عناصر الكائن القابل للتعداد المعطى باستثناء تلك التي تحقق الكتلة block (أي التي تعيد معها قيمة صحيحة عند تمريرها إليها)، أو يعاد كائن ...

يُعيد التابع singleton_methods مصفوفةً تحوي أسماء توابع الكائن المنفردة (singleton methods). إذا مُرِّرت القيمة true إلى التابع، فستتضمَّن القائمة توابع الوحدات المُضمَّنة في الكائن المعطى أيضًا. تُعاد فقط التوابع المنفردة العامَّة والمحميَّة. البنية العامة singleton_methods(all=true) → array المعاملات all معامل اختياري يأخذ إمَّا القيمة true (افتراضيًا)، أو القيمة false. القيم المعادة تُعاد مصفوفةٌ تحوي أسماء التوابع المنفردة للكائن المعطى إذا لم يعطَ المعامل all أو كانت قيمته true. إذا كانت قيمة المعامل all هي false، فستتضمَّن تلك المصفوفة المعادة التوابع ...

يعيد التابع to_a مصفوفة المطابقات. البنية العامة to_a→ anArray‎ القيمة المعادة يعيد التابع to_a مصفوفة المطابقات. أمثلة مثال على استخدام التابع to_a‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.to_a #=> ["HX1138", "H", "X", "113", "8"]‎ لأنّ التابع to_a يُستدعى عند توسيع المتغير ‎*، هناك شكل مختصر ومفيد لعملية الإسناد (assignment) لأجل استخلاص الحقول المُطابقة. هذا الاختصار أبطأ قليلًا من الوصول المباشر إلى الحقول (بسبب إنشاء مصفوفة انتقالية). يشرح المثال التالي ذلك: all,f1,f2,f3 = * /(.)(.)(\d+)(\d)/.match("THX1138.") all #=> "HX1138" f1 #=> "H" f2 ...

ينتظر التابع waitall جميع العمليات الأبناء للعملية الحالية ثم يعيد مصفوفة تحوي الأزواج مُعرِّف_العملية/الحالة (pid/status). البنية العامة waitall → [ [pid1,status1], ...] القيم المعادة تعاد مصفوفة تحوي الأزواج مُعرِّف_العملية/الحالة (pid/status) لجميع العمليات الأبناء بعد انتظار خروجها. أمثلة مثال على استعمال التابع waitall: fork { sleep 0.2; exit 2 } #=> 27432 fork { sleep 0.1; exit 1 } #=> 27433 fork { exit 0 } #=> ...

يعيد التابع min_by العنصر الذي تعيد الكتلة المعطاة أًصغر قيمة مقابلة له بعد تمرير عناصر الكائن القابل للتعداد إليها كلٌّ على حدة. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة min_by {|obj| block } → obj min_by → an_enumerator min_by(n) {|obj| block } → array min_by(n) → an_enumerator المعاملات n إن أعطي هذا المعامل، فسيُعاد أصغر n عنصر في مصفوفة. ترتَّب العناصر آنذاك في المصفوفة بشكل تنازلي بناءً على القيمة المقابلة التي تعيدها الكتلة. القيمة المعادة يعاد العنصر الذي تعيد ...

ينشئ التابع reverse_each مصفوفة مؤقتة تحوي عناصر الكائن القابل للتعداد ثم يمر عليها (يستعملها) بترتيب معاكس. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة reverse_each(*args) { |item| block } → enum reverse_each(*args) → an_enumerator المعاملات args الوسائط المراد استعمالها في العملية. القيمة المعادة يعاد ناتج تنفيذ الكتلة block على عناصر الكائن القابل للتعداد بترتيب معاكس بعد وضعها في مصفوفة مؤقتة، أو يعاد كائن جديد من النوع Enumerator. أمثلة مثال على استعمال التابع reverse_each: (1..3).reverse_each { |v| p ...

يعيد التابع last العنصر الأخير في المجال، أو مصفوفة مؤلفة من آخر n عنصر من عناصر المجال. لاحظ أنه في حال عدم تمرير أية معاملات إلى التابع، فسيعيد الكائن الذي يحدد نهاية المجال، حتى لو كانت قيمة exclude_end?‎ تساوي true. البنية العامة last → obj last(n) → an_array‎ المعاملات n‎ عدد صحيح. يمثِّل عدد العناصر الأخيرة المراد جلبها من المجال. القيمة المعادة يعاد العنصر الأخير في المجال المعطى، أو مصفوفة مؤلفة من آخر n عنصر من المجال. أمثلة مثال على استخدام التابع ...

يعيد التابع list مصفوفة تحوي جميع الكائنات Thread الموجودة والتابعة لمجموعة الخيوط التي استدعيت معه. البنية العامة list → array القيمة المعادة تعاد مصفوفة تحوي جميع الكائنات Thread الموجودة والتابعة لمجموعة الخيوط المعطاة. أمثلة مثال على استعمال التابع list: ThreadGroup::Default.list #=> [#<Thread:0x401bdf4c run>] انظر أيضًا التابع add: يضيف الخيط المُمرَّر إليه إلى مجموعة الخيوط التي استدعي معها. التابع enclose: يمنع إضافة أو إزالة أي خيط من مجموعة الخيوط التي استدعيت معه. التابع ?enclosed: يتحقق إذا كانت مجموعة الخيوط ...

يُعيد التابع backtrace_locations مكدس التنفيذ (execution stack) الخاص بالمهمة الفرعية على شكل مصفوفة تحتوي على كائنات التعقب (backtrace location objects). يتصرف هذا التابع بطريقة مشابهة للتابع Kernel.caller_locations، إلا أنه يُطبق على مهمة فرعية محددة. انظر صفحة Thread::Backtrace::Location لمزيد من المعلومات. البنية العامة backtrace_locations(*args)→ array or nil‎ المعاملات args القيمة المعادة يعاد مكدس التنفيذ (execution stack) الخاص بالمهمة الفرعية المعطاة على شكل مصفوفة تحتوي على كائنات التعقب. انظر أيضًا التابع backtrace: يُعيد التِعقب (backtrace) الحالي للمهمة فرعية. مصادر قسم التابع backtrace_locations‎ في الصنف ...

يقرأ التابع readlines الملف الحالي في المجرى ARGF بشكل كامل. البنية العامة readlines(sep=$/) → array readlines(limit) → array readlines(sep, limit) → array الوسائط sep المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$. limit عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. القيم المعادة تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى ARGF، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. أمثلة مثال لاستخدام التابع readlines: lines = ARGF.readlines lines[0] ...

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

يعيد التابع parameters معلومات عن معاملات التابع الحر الذي استُدعي معه على شكل مصفوفة. البنية العامة parameters → array‎ القيمة المعادة تعاد مصفوفة تحوي معلومات عن معاملات التابع الحر الذي استُدعي معه على شكل مصفوفة. أمثلة مثال على استخدام التابع parameters‎: def foo(bar); end method(:foo).parameters #=> [[:req, :bar]] def foo(bar, baz, bat, &blk); end method(:foo).parameters #=> [[:req, :bar], [:req, :baz], [:req, :bat], [:block, :blk]] def foo(bar, *args); end method(:foo).parameters #=> [[:req, :bar], [:rest, :args]] def foo(bar, baz, *args, &blk); end method(:foo).parameters #=> [[:req, :bar], [:req, :baz], [:rest, ...