نتائج البحث

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

يجلب التابع lineno رقم السطر الحالي للمجرى ARGF ككُل. يمكن تعيين هذه القيمة يدويًا عبر استدعاء هذا التابع بالشكل lineno = integer. البنية العامة lineno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل رقم السطر الحالي للمجرى ARGF ككل. أمثلة مثالٌ على استخدام التابع lineno: ARGF.lineno #=> 0 ARGF.readline #=> "This is line 1\n" ARGF.lineno #=> 1 انظر أيضًا التابع lineno: يعيِّن عند استدعائه بالشكل lineno = integer رقم السطر الحالي للمجرى ARGF ككُل. التابع file: يعيد ...

يحول التابع to_s‎ العدد الصحيح الذي استدعي معه إلى سلسلة نصية ممثلًا بأساس محدَّد. البنية العامة to_s(base=10) → string‎ المعاملات base‎ عدد صحيح يمثل أساس العدد الصحيح المراد تمثيله به. تترواح هذا المعامل بين 2 و 36. القيمة الافتراضية هي: 10 (التمثيل العشري). القيمة المعادة تعاد سلسلة نصية تحتوي على العدد الصحيح المعطى وفق الأساس base. أمثلة مثال على استخدام التابع to_s‎: 12345.to_s #=> "12345" 12345.to_s(2) #=> "11000000111001" 12345.to_s(8) ...

يعيد التابع seed قيمة البذرة التي استُخدمَت في إنشاء المولِّد. قد يُستعمَل هذا التابع لإنشاء مولِّدٍ آخر بنفس الحالة في وقتٍ لاحق، مسببًا بذلك توليد نفس السلسلة من الأعداد. البنية العامة seed → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل قيمة البذرة التي استخدمت في إنشاء المولِّد. أمثلة مثالٌ عن استخدام التابع seed: prng1 = Random.new(1234) prng1.seed #=> 1234 prng1.rand(100) #=> 47 prng2 = Random.new(prng1.seed) prng2.rand(100) #=> 47 انظر أيضًا التابع new: يُنشئ مولِّد أعدادٍ شبه ...

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

يجلب التابع fetch‎ قيمة متغير بيئة ذي اسمٍ محدَّدٍ؛ في حال لم يكن ذلك الاسم موجودًا ولم يُمرَّر أي شي إلى التابع ولا حتى كتلة برمجية، فسيٌطلق الخطأ KeyError. أمَّا في حال تمرير كتلة، فستُستدعَى مع الاسم الذي لم يُعثَر عليه ويعاد ناتج تنفيذها، أو إذا أعطي الوسيط default، فستعاد قيمته إن لم تٌعطَ أي كتلة في تلك الحالة. البنية العامة fetch(name) → value fetch(name, default) → value fetch(name) { |missing_name| ... } → value المعاملات name اسم متغير البيئة المراد البحث ...

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

يجمِّع التابع group_by عناصر الكائن القابل للتعداد الذي استدعي معه في مجموعات بحسب النتيجة المقابلة لكل عنصر التي تعيدها الكتلة المعطاة بعد تمريره إليها. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة group_by { |obj| block } → a_hash group_by → an_enumerator القيمة المعادة يعاد كائن من النوع Hash تكون قيم المفاتيح فيه هي قيمة العنصر المقابلة التي تعيدها الكتلة block والقيم فيه هي مصفوفات تحوي العناصر المقابلة لكل مفتاح أعادته الكتلة من الكائن القابل للتعداد المعطى. إن ...

يبدأ التابع garbage_collect تجميع البيانات المهملة، ما لم تُعطَّل يدويًا. عُرِّف هذا التابع مع وسائط مسماة قِيَمَها الافتراضية هي true: def GC.start(full_mark: true, immediate_sweep: true); end ملاحظة: تعتمد الوسائط المسماة هذه على التنفيذ والإصدار المستعمل. ولا يُضمن أن تظل متوافقة في المستقبل، ويمكن تجاهلها إذا كان التنفيذ الأساسي لا يدعمها. البنية العامة garbage_collect → nil include GC; garbage_collect → nil garbage_collect(full_mark: true, immediate_sweep: true) → nil المعاملات full_mark استعمل القيمة false مع هذا المعامل لتنفيذ عملية GC ثانوية. القيمة الافتراضية هي: true. immediate_sweep استعمل ...

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