نتائج البحث

يتحقق التابع integer?‎ إن كان العدد الذي استُدعي معه من النوع Integer. البنية العامة integer? → true or false‎ القيمة المعادة تعاد القيمة true إن كان العدد الذي استُدعي معه من النوع Integer. أمثلة مثال على استخدام التابع integer?‎: 1.0.integer? #=> false 1.integer? #=> true‎ انظر أيضا التابع eql?‎: يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع ومتساويين.  التابع infinite?‎: يتحقق إذا ما إن كان العدد الذي استدعي معه منتهيًا ...

يتحقق التابع eof إن وصل المجرى الذي استدعي معه إلى نهاية الملف؛ مما يعني أنَّه لا توجد بيانات أخرى للقراءة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة وإلا سيُطلَق الاستثناء IOError. إن كان المجرى أنبوبًا (pipe) أو مقبسًا (socket)، فسيُحجَز التابع eof?‎ إلى أن يرسل الطرف الآخر بعض البيانات أو يغلقه. لاحظ أن التابع eof?‎ يقرأ البيانات من مخزن الإدخال المؤقت (input byte buffer). قد لا يتصرف التابع sysread كما كنت تنوي مع eof?‎ إلا إذا استدعيت rewind أولًا (لكن ...

يتحقق التابع negative?‎ إن كان العدد العشري الذي استُدعي معه عددًا سالبًا. البنية العامة negative? → true or false‎ القيمة المعادة تعاد القيمة true إن كان العدد العشري الذي استُدعي معه عددًا سالبًا. خلا ذلك، تعاد القيمة false. انظر أيضا التابع ?finite: يتحقق إذا كان العدد العشري الذي استدعي معه عددًا عشريًّا صالحًا وفقًا لمعيار IEEE؛ أي أنه ليس عددٌ لا نهائي ويعيد التابع ‎nan?‎ القيمة false معه. التابع eql?‎: يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع ...

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

يعيد التابع phase القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو يعيد القيمة pi خلاف ذلك. البنية العامة phase → 0 or float‎ القيمة المعادة تعاد القيمة 0 إن كان العدد المعطى موجبًا، أو تعاد القيمة pi خلاف ذلك. انظر أيضا التابع angle: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. التابع polar: يعيد المصفوفة [num.abs، num.arg]. مصادر قسم التابع phase‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

تُولّد الكائنات Continuation بواسطة التابع Kernel.callcc بعد استيراد continuation عبر require. تحمل هذه الكائنات عنوان العودة (return address) وسياق التنفيذ (execution context)، مما يتيح العودة إلى نهاية الكتلة callcc من أي مكان في البرنامج. كائنات الصنف Continuation مشابهة لحد ما البنية setjmp/longjmp في لغة C (على الرغم من أنَّها تحتوي على حالات أكثر، لذلك يمكن اعتبارها أقرب إلى المهام الفرعية [threads]). على سبيل المثال: require "continuation" arr = [ "Freddie", "Herbie", "Ron", "Max", "Ringo" ] callcc{|cc| $cc = cc} puts(message = arr.shift) $cc.call unless message ...

يُعيد التابع arity عدد الوسائط الإلزاميَّة في الكائن proc الذي استدعي معه. إذا عُرِّفت الكتلة (block) من دون وسائط، فسيُعيد التابع القيمة 0. إذا عُرِّفت الكتلة مع عدد محدَّد n من الوسائط، فسيُعيد التابع ذلك العدد n. إذا كان للكتلة وسائط اختيارية، فسيُعيد التابع 1-n-، إذ يمثِّل n عدد الوسائط الإلزامية، باستثناء الكتل التي ليست من النوع lambda والتي تمتلك عددًا محدودًا من الوسائط الاختيارية؛ في هذه الحالة الأخيرة، يُعيد التابع العدد n. تُعتبر وسائط الكلمة المفتاحية (keyword argument) وسيطًا ...

يعيد التابع ceil‎ أصغر عدد من الأعداد الأكبر من أو تساوي قيمة العدد الذي استُدعي معه وبدقة (precision) تساوي العدد الممرر إليه (القيمة الابتدائية هي 0) . البنية العامة ceil([ndigits]) → integer or float‎ المعاملات ndigits‎ عدد يحدد دقة المنازل العشرية. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل. القيمة المعادة يعاد أصغر عدد، بحيث يكون أكبر من أو يساوي قيمة العدد الذي استُدعي معه، مع دقة (precision) تساوي ndigits رقم ...

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

يحوّل التابع inspect المجال الذي استُدعي معه إلى شكل قابل للطباعة. البنية العامة inspect → string‎ ‎القيمة المعادة يعاد المجال المعطى على شكل سلسلة نصية قابلة للطباعة. انظر أيضا التابع last: يعيد العنصر الأخير في المجال، أو مصفوفة مؤلفة من آخر n عنصر. مصادر قسم التابع inspect‎ في الصنف Range‎ في توثيق روبي الرسمي.

يعيد التابع to_r العدد الجذري الذي استدعي معه نفسه. البنية العامة to_r → self‎ القيمة المعادة يعاد العدد الجذري المعطى نفسه. أمثلة مثال على استخدام التابع to_r‎: Rational(2).to_r #=> (2/1) Rational(-8, 6).to_r #=> (-4/3)‎ انظر أيضًا التابع to_i: يُعيد القيمة مُقتطعة على هيئة عدد صحيح. التابع to_f: يحول العدد الجذري الذي استدعي معه إلى عدد عشري. التابع to_s: يحول العدد الجذري الذي استدعي معه إلى سلسلة نصية. مصادر قسم التابع to_r‎ في الصنف Rational‎ في توثيق روبي ...

يضيف التابع concat كائنات محدَّدة إلى السلسلة النصية التي استدعيت معه. في حال كان الكائن عددًا صحيحًا، فسيعد نقطة ترميز (codepoint) ويُحول إلى المحرف المقابل له قبل أن يضاف إلى السلسلة النصية. يمكن إضافة عدد لانهائي من الكائنات، ليتم إلحاقها بالسلسلة النصية حسب ترتيبها عند تمريرها إلى التابع. البنية العامة concat(obj1, obj2,...) → str المعاملات obj1 يمثل الكائن الأول المُراد إلحاقه بالسلسلة النصية المعطاة. obj2 يمثل الكائن الثاني المُراد إلحاقه بالسلسلة النصية المعطاة. ... يمثل الكائنات الأخرى المُراد إلحاقها بالسلسلة ...

يُعيد التابع inspect نسخة قابلة للطباعة من السلسلة النصية محاطةً بعلامات تنصيص، مع تهريب الحروف الخاصة. البنية العامة inspect → string القيمة المعادة تُعاد نسخة قابلة للطباعة من السلسلة النصية المعطاة محاطةً بعلامات تنصيص، مع تهريب الحروف الخاصة. أمثلة مثال على استعمال التابع inspect: str = "hello" str[3] = "\b" str.inspect #=> "\"hel\\bo\"" انظر أيضًا التابع dump: يُعيد نسخة عن السلسلة النصية مع استبدال المحارف الغير مطبوعة بالرمز nnn\ وتهريب المحارف الخاصة. مصادر قسم التابع inspect‎ ...

يوقظ التابع wakeup مهمة فرعية ويجعلها متاحة للجدولة، ولكن قد تظل معطلة في مجرى الإدخال/الإخراج (I/O). ملحوظة: هذا التابع لا يستدعي المُجدوِل (scheduler)؛ راجع صفحة التابع run لمزيد من المعلومات. البنية العامة wakeup→ thr‎ القيمة المعادة تعاد المهمة الفرعية بعد إيقاظها. أمثلة مثال على استخدام التابع wakeup‎: c = Thread.new { Thread.stop; puts "hey!" } sleep 0.1 while c.status!='sleep' c.wakeup c.join #=> "hey!"‎ انظر أيضًا التابع run: يوقظ المهمة الفرعية، ويجعلها متاحة للجدولة. مصادر قسم التابع Threadwakeup‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يتحقق التابع setgid?‎ إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. البنية العامة setgid?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. خلا ذلك، تعاد القيمة false. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع owned?‎: يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز كتلي (block device). خلا ذلك، تعاد القيمةfalse. انظر أيضًا مصادر قسم التابع blockdev?‎ في الصنف FileTest في توثيق روبي الرسمي.

يتحقق التابع enabled?‎ من الوضع الحالي للتعقب. البنية العامة enabled? → true or false‎ القيمة المعادة تعاد القيمة true إن كان التعقب مفعَّلًا أو تعاد القيمة false إذا كان معطَّلًا. انظر أيضًا التابع enable: يفعِّل التعقب. التابع disable: يعطل التعقب. مصادر قسم التابع enabled?‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

يوضح الجدول التالي أولوية العمليات في روبي من الأعلى إلى الأدنى. تُنفَّذ العمليات ذات الأولوية العليا قبل العمليات ذات الأولوية الأقل منها عند وجودها في نفس التعبير أو السطر البرمجي في الشيفرة. ترتيب أولوية العمليات !، ~، + unary ** - unary *، /، % +، - >>، << & |، ^ <، =<، >، => <=>، ==، ===، =!، ~=، ~! && || ..، ... ?، : modifier-rescue =، =+، =-، ...إلخ. ?defined not and ،or modifier-until ،modifier-while ،modifier-unless ...

يعيد التابع class_variables مصفوفة مكونة من أسماء متغيرات الصنف في الوحدة التي استُدعي معها. يشمل ذلك أسماء متغيرات الصنف في كل الوحدات المُضمّنة ما لم تمرَّر القيمة false إلى التابع. البنية العامة class_variables(inherit=true) → array‎ المعاملات inherit‎ قيمة منطقية تحدِّد ما إذا كانت أسماء متغيرات الصنف في كل الوحدات المُضمّنة ستُشمل أم لا. القيمة المعادة تعاد مصفوفة مكونة من أسماء متغيرات الصنف في الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع class_variables‎: class One @@var1 = 1 end class Two < ...

يجلب التابع gets السطر التالي من الملف الحالي في المجرى ARGF. البنية العامة gets(sep=$/ [, getline_args]) → string or nil gets(limit [, getline_args]) → string or nil gets(sep, limit [, getline_args]) → string or nil يُفتَرض أنَّ الفاصل المستعمل لفصل الأسطر عن بعضها هو المحرف ‎$/‎. يمكن تغيير هذا الفاصل إلى محرف آخر عبر تمريره كسلسلة نصية إلى الوسيط sep. وظيفة الوسيط limit الاختياري هي تحديد عدد المحارف المراد جلبها من كل سطر. تعاد افتراضيًّا كل المحارف الموجودة في السطر. للمزيد من التفاصيل ...

يدمج التابع merge كائنين من النوع Hash مع بعضهما بعضًا في كائن جديد من النوع Hash ثم يعيده. إذا لم تُحدد أية كتلة، فستكون قيمة الأزواج ذات المفاتيح المُكررة هي نفسها وتؤخذ من الكائن المُمرَّر إلى التابع. أما إن أعطيت، فستُحدَد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته من الكائن المعطى وقيمته من الكائن المُمرَّر. البنية العامة merge(other_hash) → new_hash merge(other_hash){|key, oldval, newval| block} → new_hash المعاملات other_hash كائن جديد من النوع Hash يراد دمج محتوياته مع الكائن ...

يعيد التابع realpath اسم المسار الحقيقي (المطلق) لمسارٍ ما في نظام الملفات الفعلي. لا يحوي اسم المسار الحقيقي وصلات رمزية أو نُقَط عديمة الفائدة. جميع مكونات المسار يجب أن تكون موجودةً عند استدعاء هذا التابع. البنية العامة realpath(pathname [, dir_string]) → real_pathname المعاملات pathname اسم المسار المراد معرفة المسار الحقيقي (المطلق) له. جميع مكونات المسار يجب أن تكون موجودةً. dir_string إن أعطي هذا المعامل الاختيار، فيُستعمَل على أنَّه المجلد الأساسي في تفسير المسارات النسبية بدلًا من المجلد الحالي. القيمة المعادة يعاد ...

يقفل التابع flock الملف الذي استدعي معه أو يلغي القفل الذي طُبِّق عليه لحماية الملف أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. هذا التابع غير متاح على جميع المنصات. البنية العامة flock(locking_constant) → 0 or false المعاملات locking_constant قيمة هذا المعامل هي أحد العمليات التالية: العمليَّة الوصف LOCK_SH طلب الحصول على قفل مشاركة (shared lock، عند القراءة). تستطيع أكثر من عملية تطبيق هذا القفل على الملف المعطى في الوقت نفسه. LOCK_EX ...

يحسب التابع asinh معكوس الجيب القطعي (inverse hyperbolic sine) للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة asinh(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة معكوس الجيب القطعي للعدد x المعطى. أمثلة مثال على استخدام التابع asinh‎: Math.asinh(1) #=> 0.881373587019543‎ انظر أيضا التابع asin: يحسب معكوس الجيب للعدد المعطى. التابع atan: يحسب معكوس الظل (arc tangent) للعدد المعطى. مصادر قسم التابع asinh‎ في الصنف Math‎ في توثيق روبي الرسمي.

يتحقق التابع include?‎ إذا كانت السلسلة النصية التي استدعيت معها تحتوي على السلسلة النصية أو المحرف المُمرَّر إليها. البنية العامة include? other_str → true or false المعاملات other_str السلسلة أو المحرف المُراد التحقق من وجوده في السلسلة النصية المُعطاة. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية المُعطاة تحتوي على قيمة المعامل other_str المُمرِّر، أو تُعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال التابع include?‎: "hello".include? "lo" #=> true "hello".include? "ol" #=> false "hello".include? ?h ...

ينشئ التابع new تعبيرًا نمطيًّا جديدًا من النمط المُمرَّر إليه، والذي يمكن أن يكون إما سلسلة نصية أو كائنًا من النوع Regexp (وفي هذه الحالة يتم نشر خيارات التعبير النمطي)؛ وقد لا يتم تحديد الخيارات الجديدة (منذ روبي 1.8). البنية العامة new(string, [options]) → regexp new(regexp)→ regexp compile(string, [options])→ regexp compile(regexp) → regexp‎ المعاملات string‎ سلسلة نصية. options‎ الخيارات التي تتحكم بالتعبير النمطي. إن كان المعامل options عددًا صحيحًا، فيجب أن يساوي واحدًا أو أكثر من الثوابت التالية: Regexp::EXTENDED أو Regexp::IGNORECASE أو Regexp::MULTILINE، ...

يُطلق الاستثناء ZeroDivisionErro عند محاولة تقسيم عدد على 0. 42 / 0 #=> ZeroDivisionError: divided by 0 لاحظ أنه لن يُطلق هذا الاستثناء إلا عند محاولة القسمة على العدد صفر بالضبط (أي القيمة 0 وليس 0.0 مثلًا). اطلع على المثال التالي الذي يشرح ذلك: 42 / 0.0 #=> Float::INFINITY 42 / -0.0 #=> -Float::INFINITY 0 / 0.0 #=> NaN مصادر صفحة الصنف ZeroDivisionErro في توثيق روبي الرسمي.

يعيد التابع internal_encoding الترميز الخاص بالسلسلة النصية الداخلية في حال تحديد التحويل. البنية العامة internal_encoding→ encoding‎ القيمة المعادة يعاد الترميز الخاص بالسلسلة النصية الداخلية في حال تحديد التحويل، أو تعاد القيمة nil خلاف ذلك. انظر أيضًا التابع external_encoding: يُعيد كائن الترميز الذي يمثل ترميز الملف للمجرى الذي استدعي معه. التابع set_encoding: يضبط الترميز الداخلي والخارجي في المجرى الذي استدعي معه. مصادر قسم التابع internal_encoding‎ في الصنف IO‎ في توثيق روبي الرسمي.

يستبدل التابع swapcase!‎ الحروف الأبجدية الكبيرة في السلسلة النصية التي استدعيت معها بنظيراتها الصغيرة، والحروف الصغيرة بنظيراتها الكبيرة. البنية العامة swapcase! → str or nil swapcase!([options]) → str or nil المعاملات options الخيارات التي تتحكم في الترميز وعملية التحويل. انتقل إلى صفحة التابع downcase للاطلاع على شرح الخيارات الأربعة - ascii:، و turkic:، و lithuanian:، و fold: - التي يمكن استعمالها مع هذا المعامل. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد استبدال الحروف الكبيرة فيها بنظيراتها الصغيرة، والحروف الصغيرة بنظيراتها الكبيرة. أمثلة أمثلة على استعمال التابع !swapcase: a=“Hello” a.swapcase ...

يُعدُّ التابع enq اسمًا بديلًا للتابع push . البنية العامة enq(p1) المعاملات p1 الكائن المراد إضافته إلى الطابور المعطى. انظر أيضًا التابع push : يضيف الكائن المُمرَّر إليه إلى الطابور المعطى. التابع num_waiting : يعيد عدد الخيوط (threads) المنتظرة في الطابور الذي استُدعي معه. التابع pop : يجلب بياناتٍ من الطابور الذي استُدعي معه. مصادر صفحة التابع enq في الصنف queue في توثيق روبي الرسمي.

يعيد التابع ‎imag الجزء التخيلي للعدد العقدي الذي استدعي معه. البنية العامة imag → real imaginary → real القيمة المعادة يعاد عددٌ حقيقيٌ يمثِّل الجزء التخيلي للعدد العقدي المعطى. أمثلة أمثلة عن استخدام التابع ‎imag: Complex(7).imaginary #=> 0 Complex(9, -4).imaginary #=> -4 انظر أيضًا التابع ‎real: يعيد الجزء الحقيقي للعدد العقدي.  التابع angle: يعيد الجزء الزاوي (الزاوية θ) للشكل القطبي من العدد العقدي الذي استدعي معه. مصادر قسم التابع imag‎ في الصنف Complex في توثيق روبي الرسمي.

يجلب التابع byteslice محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. ترميز السلسلة النصية المُعادة يكون من نفس ترميز السلاسل الأصلية. البنية العامة byteslice(integer) → new_str or nil byteslice(integer, integer) → new_str or nil byteslice(range) → new_str or nil المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه من السلسلة المعطاة. ...

يُطلق الاستثناء SecurityError عند محاولة تنفيذ عملية قد تكون غير آمنة؛ عادةً، يطلق عندما يُرفع مستوى ‎$SAFE  فوق 0: foo = "bar" proc = Proc.new do $SAFE = 3 foo.untaint end proc.call سيطلق الاستثناء SecurityError بالشكل التالي عند تنفيذ هذه الشيفرة: SecurityError: Insecure: Insecure operation `untaint' at level 3 مصادر صفحة الصنف SecurityError في توثيق روبي الرسمي.

يعيد التابع nonzero?‎ العدد الذي استُدعي معه إن كان غير صفري، أو يعيد القيمة nil خلاف ذلك. هذا السلوك مفيد في المقارنات المتسلسلة (انظر المثال في قسم الأمثلة). البنية العامة nonzero? → self or nil‎ القيمة المعادة يعاد العدد المعطى نفسه إن كان غير صفري، أو تعاد القيمة nil خلاف ذلك. أمثلة مثال على استخدام التابع nonzero?‎: a = %w( z Bb bB bb BB a aA Aa AA A ) b = a.sort {|a,b| (a.downcase <=> b.downcase).nonzero? || ...

يمرِّر التابع find كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه إلى الكتلة المعطاة ثم يعيد أول عنصر محقق لها (لا تعيد معه القيمة false). إن لم يُعثَر على أي عنصر متطابق، فسيستدعي التابع find التابع المُمرَّر إليه ويعيد القيمة التي يعيدها، أو تعاد القيمة nil إن يُعطَ ذلك التابع. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة find(ifnone = nil) { |obj| block } → obj or nil find(ifnone = nil) → an_enumerator المعاملات ifnone ...

يقتطع التابع !slice محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة. عند تمرير تعبير نمطي (Regexp) إلى التابع slice، يعيد التابع الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط ...

يستبدل التابع squeeze!‎ المحارف المكررة على التوالي فى السلسلة النصية بمحرف واحد لكل منها. يمكن تحديد المحارف المراد إزالة تكرارها دون غيرها عبر تمريرها إلى التابع. البنية العامة squeeze!([other_str]*) → str or nil المعاملات other_str تحدِّد السلسلة other_str مجموعة المحارف المُراد إزالة تكرارها من نسخة السلسلة النصية المُعطاة. عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يشمل جميع المحارف عدا محارف تلك السلسلة. الصيغة c1-c2 تعني جميع المحارف الواقعة في المجال بين c1 و c2. يُستعمل الخط المائل ...

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

يعيد التابع lineno رقم السطر الحالي في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة. يشير رقم السطر الحالي الذي يعيده التابع lineno إلى عدد المرات التي استدعي فيها التابع gets. ستختلف القيمتان إن استُدعي gets مع فاصل آخر غير فاصل السطر الجديد (الفاصل /$). التوابع التي تستخدم ‎$/‎ مثل each و lines و readline ستزيد أيضًامن القيمة التي يعيدها التابع lineno. انظر أيضا صفحة المتغير ‎$.‎‎. البنية العامة lineno → integer‎ القيمة المعادة يعاد عدد صحيح ...

يرمى الاستثناء ZeroDivisionError عند محاولة تقسيم عدد صحيح على الصفر. 42 / 0 #=> ZeroDivisionError: divided by 0 لاحظ أنَّ القسمة على القيمة 0 بالضبط (وليس القيمة 0.0 أو 0.0- مثلًا) سيؤدي إلى رمي الاستثناء ZeroDivisionError فقط. إليك المثال التالي: 42 / 0.0 #=> Float::INFINITY 42 / -0.0 #=> -Float::INFINITY 0 / 0.0 #=> NaN مصادر صفحة الصنف ZeroDivisionError في توثيق روبي الرسمي.

يعيد التابع div‎ ناتج عملية قسمة العدد الذي استدعي معه على العدد الذي مُرِّر إليه. البنية العامة div(numeric) → integer المعاملات numeric عدد صحيح يمثل الطرف الثاني للعملية. القيمة المعادة يعاد عدد صحيح يمثل ناتج عملية قسمة العدد int المعطى على العدد numeric. أمثلة مثال على استخدام المعامل div‎: 25.div(4) #=> 6 20.div(7) #=> 2 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: يعيد ناتج عملية الجمع بين عددين. ...

يتحقق التابع infinite?‎ إذا ما إن كان العدد الذي استدعي معه منتهيًا (finite) أو غير منتهي من الطرف السالب (‎-Infinity) أو غير منتهي من الطرف الموجب (‎+Infinity). البنية العامة infinite? → -1, 1, or nil‎ القيمة المعادة تعاد القيمة nil أو ‎-1 أو 1 إذا كان العدد المعطى منتهيًا أو غير منتهي من الطرف السالب (‎-Infinity) أو غير منتهي من الطرف الموجب (‎+Infinity) على التوالي. انظر أيضا التابع ?finite: يتحقق إذا كان العدد العشري الذي استدعي معه عددًا ...

يعيد التابع size حجم الملف الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف المعطى. أمثلة مثال على استعمال التابع size: File.new("testfile").size #=> 66 انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

ينشئ التابع ‎new نسخة جديدة من الصنف ConditionVariable. البنية العامة new() القيمة المعادة تُعاد نسخةٌ جديدةٌ من الصنف ConditionVarialbe. أمثلة مثالٌ عن استخدام التابع ‎new: mutex = Mutex.new # => ConditionVarialbe سيعيد كائنا من الصنف انظر أيضًا التابع broadcast: يوقظ جميع المهام الفرعية (threads) التي تنتظر القفل (lock) المعيّن.  التابع signal: يوقظ أول مهمة فرعية من بين المهام الفرعية (threads) التي تنتظر القفل (lock) المعيّن. التابع wait: يحرِّر القفل المطبَّق (held) على الكائن mutex وينتظر، ثمَّ يستعيد القفل عند الإستيقاظ. ...

يقرأ التابع pread من المجرى الذي استدعي معه عددًا محدَّدًا من البايتات باستخدام استدعاء النظام pread، ثم يُعيدها كسلسلة نصية من غير تعديل إزاحة (offset) الواصف الأساسي. هذا التابع مفيد مقارنة بالجمع بين التابعين seek و read معًا في كونه ذريًا (atomic)، مما يسمح لعدة مهام فرعية/عمليات بتشارك نفس المجرى لقراءة الملف من مواضع مختلفة. هذا سيتجاوز أي مساحة تخزين مؤقت للمستخدمين في المجرى. سيُطلق الاستثناء SystemCallError عند حصول خطأ، أو الاستثناء EOFError عند الوصول إلى نهاية الملف، أو الاستثناء NotImplementedError ...

يأخذ التابع disassemble المعامل body، والذي سيكون إما كائنًا من النوع Method، أو من النوع Proc، ثم يُعيد سلسلة نصية تحوي هذا المعامل على هيئة تعليمات قابلة للقراءة. البنية العامة disasm(body) → str disassemble(body) → str‎ المعاملات body‎ كائن من النوع Method أو من النوع Proc. القيمة المعادة تعاد سلسلة نصية تحوي محتوى المعامل body على هيئة تعليمات قابلة للقراءة. أمثلة مثال على استخدام التابع disassemble‎ مع كائن من النوع Method: # /tmp/method.rb def hello puts "hello, world" end puts RubyVM::InstructionSequence.disasm(method(:hello))‎ الناتج سيكون: == disasm: ...

يتحقق التابع utc?‎ إن كان التوقيت الذي استُدعي معه يمثل توقيتًا في النطاق العالمي الموحد UTC‏ (GMT). البنية العامة utc? → true or false‎ القيمة المعادة تعاد القيمة true إن كان التوقيت المعطى يمثل توقيتًا في النطاق العالمي الموحد UTC‏ (GMT)، أو ستعاد القيمة false. أمثلة مثال على استخدام التابع utc?‎: t = Time.now #=> 2007-11-19 08:15:23 -0600 t.utc? ...

يعيد التابع casefold?‎ قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). البنية العامة casefold?→ true or false‎ القيمة المعادة تعاد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). أمثلة مثال على استخدام التابع casefold?‎: /a/.casefold? #=> false /a/i.casefold? #=> true /(?i:a)/.casefold? #=> false‎ انظر أيضًا التابع encoding: يُعيد كائنًا من النوع Encoding، والذي يمثل ترميز الكائن. مصادر قسم التابع casefold?‎ في الصنف ...

الصنف ScriptError هو الصنف الأب (superclass) لأصناف الأخطاء التي تُطلق عندما لا يمكن تنفيذ الشيفرة بسبب إحدى الأخطاء التالية: LoadError أو NotImplementedError أو SyntaxError. لاحظ أنَّ النوع ScriptError من أخطاء ليست قياسية (أي ليست من الأخطاء StandardError)، ولن تتم معالجتها ما لم يتم تحديدها بشكل صريح (أو تحديد صنفها الأب Exception). مصادر صفحة الصنف ScriptError في توثيق روبي الرسمي.

يعيد التابع capitalize نسخة عن السلسلة النصية المعطاة مع تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة. البنية العامة capitalize → new_str capitalize([options]) → new_str المعاملات options الخيارات التي تتحكم في الترميز وعملية التحويل. انتقل إلى صفحة التابع downcase للاطلاع على شرح الخيارات الأربعة - ascii:، و turkic:، و lithuanian:، و fold: - التي يمكن استعمالها مع هذا المعامل. القيمة المعادة تعاد نسخة عن السلسلة النصية المعطاة بعد تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف ...

يعيد التابع each_byte قيمة قابلة للعد (enumerator) تتكرر (iterates) على كل قيمة من النوع Byte في الملفات الموجودة في ARGV. يسمح لك هذا التابع بمعالجة الملفات المُمرَّرة من سطر الأوامر كما لو كانت ملفًا واحدًا مكونًا من سلسلة من هذه الملفات المسماة. بعد إعادة البتة (byte) الأخيرة من الملف الأول، ستُعاد البتة الأولى من الملف الثاني. يمكن استخدام التابع ARGF.filename لمعرفة اسم الملف للبتة الحالية. في حال عدم تمرير كتلة برمجية، فسيُعاد كائن من النوع enumerator. البنية العامة each_byte {|byte| block } → ARGF each_byte → ...

يعيد التابع maxgroups العدد الأقصى لمُعرِّفات المجموعات المسموح بها في قائمة وصول المجموعات الإضافية (supplemental group access list). البنية العامة maxgroups → integer القيم المعادة يعاد عدد صحيح يمثِّل أقصى عدد لمُعرِّفات المجموعات المسموح بها في قائمة وصول المجموعات الإضافية. أمثلة مثال على استعمال التابع maxgroups: Process.maxgroups #=> 32 انظر أيضًا التابع groups: يجلب مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. التابع initgroups: يهيِّئ قائمة وصول المجموعات الإضافية (supplemental group access list) ...

يحول التابع to_f قيمة التوقيت المعطى إلى عدد عشري يمثل عدد الثواني التي مرَّت منذ توقيت يونكس. لاحظ أنه تختلف الأرقام الدنيا المعادة من التابع to_f والتابع subsec لأن الأعداد العشرية المضاعفة ذات المعيار IEEE 754 ليست دقيقة بما يكفي لتمثيل عدد النانوثواني التي مرت منذ حقبة يونيكس. البنية العامة to_f → float‎ القيمة المعادة يعاد عدد عشري يمثِّل قيمة التوقيت المعطى كعدد الثواني التي مرت منذ حقبة يونيكس. أمثلة مثال على استخدام التابع to_f‎: t = Time.now "%10.5f" % t.to_f ...

يحسِّن (refine) التابع refine الوحدة المستقبلة (receiver) ثم يعيد الوحدة التي عُرِّفت فيها التوابع المحسَّنة. البنية العامة refine(mod) { block }→ module‎ المعاملات mod‎ وحدة. القيمة المعادة تعاد الوحدة التي عُرِّفت فيها التوابع المحسَّنة. انظر أيضا التابع remove_class_variable: يزيل تعريف المعامل المعطى. مصادر قسم التابع refine‎ في الصنف Module‎ في توثيق روبي الرسمي.

يُعيد التابع list مصفوفة تضم المهام الفرعية العاملة أو المتوقفة. البنية العامة list→ array‎ القيمة المعادة تعاد مصفوفة تضم المهام الفرعية المشتغلة أو المتوقفة. أمثلة مثال على استخدام التابع list‎: Thread.new { sleep(200) } Thread.new { 1000000.times {|i| i*i } } Thread.new { Thread.stop } Thread.list.each {|t| p t}‎ الناتج: #<Thread:0x401b3e84 sleep> #<Thread:0x401b3f38 run> #<Thread:0x401b3fb0 sleep> #<Thread:0x401bdf4c run> انظر أيضًا التابع main: يُعيد المهمة الفرعية الرئيسية. مصادر قسم التابع list‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يُطلق الاستثناء UncaughtThrowError عندما يتم استدعاء throw مع وسم (tag) لا يحتوي على الكتلة catch المقابلة. throw "foo", "bar"‎ عند تنفيذ هذا السطر من الشيفرة، يطلق استثناء بالشكل: UncaughtThrowError: uncaught throw "foo"‎ توابع الصنف العامة new ينشئ كائنًا جديدًا من النوع UncaughtThrowError. توابع النسخة العامة tag يعيد كائن الوسم (tag object) الذي استُدعي معه. to_s يعيد رسالة منسقة تحتوي الوسم (tag). value يعيد القيمة المعادة من الوسم الذي استدعي معه. مصادر صفحة الصنف UncaughtThrowError في توثيق روبي الرسمي.

يعيد التابع ceil أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استُدعي معه وفق دقة محدَّدة للمنازل العشرية بعد الفاصلة. البنية العامة ceil([ndigits]) → integer or rational‎ المعاملات ndigits‎ يحدد دقة عدد المنازل العشرية بعد الفاصلة. القيمة الافتراضية هي: 0. عندما تكون الدقة موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع ndigits.abs صفرًا زائدًا على الأقل. القيمة المعادة يعاد أصغر عدد من الأعداد الأكبر ...

يعيد التابع chomp نسخة عن السلسلة النصية مع حذف الفاصل السطري المُحدد من نهايتها (إن كان موجودًا). البنية العامة chomp(separator=$/) → new_str المعاملات separator الفاصل الذي سيُحذف من نهاية السلسلة النصية الجديدة. القيمة الافتراضية هي: /$. إن لم يغيَّر الفاصل /$ من سجل الفاصل الافتراضي لروبي، فسيحذف التابع chomp محارف العودة إلى بداية السطر أيضًا (أي سيحذف المحارف n\، و r\، و r\n\). أمَّا إن كان هذا المعامل سلسلة نصية فارغة، فسيحذف التابع جميع محارف الأسطر الجديدة الزائدة من السلسلة ...

يُنشئ التابع now توقيتًا جديدًا من الوقت الحالي. هذا التابع يشبه استدعاء التابع new دون تمرير أية قيمة إليه. البنية العامة now → time‎ القيمة المعادة يعاد توقيتٌ جديدٌ من الوقت الحالي. أمثلة مثال على استخدام التابع now‎: Time.now #=> 2009-06-24 12:39:54 +0900‎ انظر أيضًا التابع new: يعيد توقيتًا جديدًا. التابع utc: ينشئ توقيتًا جديدًا استنادًا إلى القيم المعطاة. مصادر قسم التابع now‎ في الصنف Time‎ في توثيق روبي الرسمي.

يضبط التابع abort_on_exception عند استدعائه بالشكل abort_on_exception= boolean حالة الشرط العام "المقاطعة عند حدوث استثناء؟" (abort on exception) إلى القيمة المنطقية boolean. عندما تكون القيمة المنطقية هي true، إذا تم إيقاف هذه المهمة الفرعية بواسطة استثناء، فسيطلق ذلك الاستثناء مجددًا في المهمة الفرعية الرئيسية. وستعاد الحالة الجديدة. يوجد أيضًا تابع نسخة (instance method) لتعيين هذا الخيار لمهمة فرعية معينة، راجع الصفحة abort_on_exception=‎. البنية العامة abort_on_exception= boolean→ true or false‎ القيمة المعادة تعاد القيمة المنطقية boolean بعد ضبطها للشرط العام "المقاطعة ...

يعيد التابع clone نسخة من هذا التابع. البنية العامة clone → new_method‎ القيمة المعادة تعاد نسخة من التابع المعطى. أمثلة مثال على استخدام التابع clone‎: class A def foo return "bar" end end m = A.new.method(:foo) m.call # => "bar" n = m.clone.call # => "bar"‎ انظر أيضًا التابع bind: يربط التابع الحر الذي استدعي معه بالكائن المعطى. مصادر قسم التابع clone‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

يستخدم التابع div المعامل / لإجراء عملية القسمة على العددين المعطيين، ثم يحوّل النتيجة إلى عدد صحيح. لا يعرفّ الصنف Numeric المعامل /؛ هذا يُترَك للأصناف الفرعية (subclasses). يكافي هذا التابع التعبير num.divmod(numeric)[0]‎. البنية العامة div(numeric) → integer‎ المعاملات numeric‎ عدد يمثِّل المقسوم عليه. القيمة المعادة يعيد التابع div العملية / ناتج إجراء عملية القسمة الصحيحة. انظر أيضا التابع denominator: يعيد المقام (denominator) للعدد الكسري الذي استدعي معه، ويكون دائمًا موجبًا. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد ...

يعيد التابع size عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع size: h = { "d" => 100, "a" => 200, "v" => 300, "e" => 400 } h.length #=> 4 h.delete("a") #=> 200 h.length #=> 3 انظر أيضا التابع length: يعيد ...

يتحقَّق التابع ?value إن كان هناك متغير له قيمة محدَّدة. البنية العامة value?(value) → true or false المعاملات value قيمة متغير البيئة المراد التحقق من وجودها. القيمة المعادة تُعاد القيمة true إن كان هناك متغير بيئة له القيمة value. انظر أيضًا التابع has_key?‎ : يتحقَّق إن كان هناك متغير بيئة باسم محدَّد. التابع has_value?‎ :يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة. التابع key : يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. مصادر قسم التابع value?‎ في الصنف ENV في توثيق روبي الرسمي. ...

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

يعيد التابع size حجم الملف المحدَّد. البنية العامة size(file_name) → integer المعاملات file_name اسم الملف المراد معرفة حجمه. القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف file_name. انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

يُعيد التابع 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: يُعيد المُعرِّف ...

يعيد التابع gsub نسخة من السلسلة النصية التي استدعيت معه مع تبديل قيمة (أو قيم) محدَّدة مكان جميع الأنماط المتطابقة فيها. البنية العامة gsub(pattern, replacement) → new_str gsub(pattern, hash) → new_str gsub(pattern) {|match| block } → new_str gsub(pattern) → enumerator إن أعطيت كتلة block إلى التابع، فستُمرَّر السلسلة الحالية المتطابقة إليها وستعيَّن قيم متغيرات مثل ‎$1، و ‎$2، و ‎$`‎، و ‎$&‎، و ‎$'‎ بشكل مناسب. ستحل القيم التي تعيدها الكتلة مكان القيمة المتطابقة في كل استدعاء. المعاملات pattern يكون عادةً تعبيرًا نمطيًّا. إن ...

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز محرفي. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف File في توثيق روبي الرسمي.

يعيد التابع file الملف الحالي على شكل كائن من النوع IO أو File. البنية العامة file → IO or File object القيم المعادة يعاد كائن من النوع IO أو File يمثل الملف الحالي، أو القيمة ‎$stdin إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثال على استخدام التابع file: $ echo "foo" > foo $ echo "bar" > bar $ ruby argf.rb foo bar ARGF.file #=> #<File:foo> ARGF.read(5) #=> "foo\nb" ARGF.file ...

يعين التابع close_on_exec عند استدعائه بالشكل close_on_exec = bool قيمة الراية close-on-exec إلى القيمة bool المنطقية. تعيّن روبي الرايات close-on-exec لكل واصفات الملفات (file descriptors) افتراضيًا منذ الإصدار 2.0.0. لذلك، لا تحتاج إلى تعيينها بنفسك. أضف إلى ذلك أنَّه قد يؤدي عدم ضبط الراية close-on-exec إلى حدوث تسرب لواصف الملف إن استخدمت مهمة فرعية أخرى التابعين ‎fork()‎ و exec()‎ (عبر التابع system()‎ على سبيل المثال). إن كنت بحاجة إلى توريث واصف الملفات في عملية فرعية (child process)، فاستخدم وسيط التابع spawn()‎ ...

يتحقق التابع gmt?‎ إن كان التوقيت الذي استدعي معه ممثلًا بالتوقيت العالمي الموحد (UTC). البنية العامة gmt? → true or false‎ القيمة المعادة تعاد القيمة true إن كان التوقيت المعطى يمثل وقتًا وفق التوقيت العالمي الموحد (UTC)؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع gmt?‎: t = Time.now #=> 2007-11-19 08:15:23 -0600 t.utc? ...

يعيد التابع urandom سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة. يفترض بالقيمة المعادة أن تكون عددًا محميًّا مشفرًا شبه عشوائي بالصيغة الثنائية. يرمي هذا التابع الاستثناء RuntimeError إذا فشلت الميزة المزودة من المنصة في تحضير النتيجة. في عام 2017، كتب في صفحة الدليل man للدالة (random(7 في لينكس: "لا يوجد تشفيرٌ أساسيٌ موجودٌ اليوم يمكن يعدنا بأكثر من 256 بت من الحماية". لذلك  تمرير قيمة ذات حجم أكبر من 32 إلى هذا التابع قد يكون أمرًا مريبًا. البنية العامة urandom(size) ...

توفر الوحدة GC واجهةً لتحديد ومسح آلية جمع البيانات المهملة (garbage collection) في روبي. تتوفر أيضًا بعض التوابع الأساسية من خلال الوحدة ObjectSpace. يمكن الحصول على المزيد من المعلومات حول تشغيل الوحدة GC من خلال الوحدة GC::Profiler. الثوابت INTERNAL_CONSTANTS OPTS توابع الصنف العامة add_stress_to_class count يعدُّ عدد مرات حدوث الوحدة GC. disable يعطِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. enable يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. latest_gc_info يعيد معلومات حول أحدث ...

يعيد التابع magnitude القيمة المطلقة للعدد العشري الذي استُدعي معه. البنية العامة magnitude → float القيمة المعادة تعاد القيمة المطلقة للعدد العشري الذي استُدعي معه. أمثلة مثال على استخدام التابع magnitude‎: (-34.56).abs #=> 34.56 -34.56.abs #=> 34.56 34.56.abs #=> 34.56 انظر أيضا التابع abs: يعيد القيمة المطلقة للعدد الذي استُدعي معه. مصادر قسم التابع magnitude‎ في الصنف Float في توثيق روبي الرسمي.

يقتطع التابع truncate العدد الجذري الذي استُدعي معه نحو الصفر بدقة محدَّدة للمنازل العشرية. البنية العامة truncate([ndigits]) → integer or rational‎ المعاملات ndigits‎ يحدد دقة عدد المنازل العشرية بعد الفاصلة. القيمة الافتراضية هي: 0. عندما تكون الدقة موجبة، يعاد عدد جذري وإلا يعاد عدد صحيح. أي عندما تكون الدقة سالبة، ستكون القيمة التي تُعاد عددًا صحيحًا مع ndigits.abs صفرًا زائدًا على الأقل. القيمة المعادة يعاد العدد الجذري المعطى مُقتطعًا بدقة ndigits منزلًا عشريًا. عندما تكون الدقة ndigits موجبة، يعاد عدد ...

تُستخدَم الكائنات السليلة من الصنف Exception للتواصل بين التّابع Kernel.raise وتصريحات rescue في الكتل (blocks) من الشكل begin...end. تَحمل كائنات الصنف Exception معلوماتٍ عن الاستثناء المَرمي مثل نوعه (اسم صنف الاستثناء)، وسلسلةً نصيّةً وصفيّةً اختياريّة، ومعلوماتِ تتبّعٍ اختيارية. قد تضيف الأصناف الفرعية من الصنف Exception معلوماتٍ إضافيّةٍ مثل NameError.name. قد تُنشِئ البرامج أصنافًا فرعيّةً (subclasses) من الصنف Exception، تكون عادةً StandardError أو RuntimeError، لتوفير أصنافٍ مخصصّةٍ وإضافة معلوماتٍ إضافية. ألقِ نظرةً على قائمة الأصناف الفرعية في الأسفل من أجل قيم ...

يٌبقِي التابع keep_if على جميع عناصر المصفوفة التي تحقق شرطًا معينًا ويحذف العناصر الأخرى المتبقية. إن لم تمرَّر كتلة برمجية، فسيعيد التابع keep_if كائنًا من النوع Enumerator. البنية العامة keep_if { |item| block } → ary keep_if → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة جميع العناصر الغير محققة للشرط الذي تحدده الكتلة block، أو يعاد كائن من النوع إن Enumerator إن لم تعطَ الكتلة block. أمثلة مثالٌ على استخدام التابع keep_if: a = %w{ a b c d ...

يعدُّ التابع exists?‎ مهملًا. لا تستخدمه رجاءً. البنية العامة exists?(file_name) → true or false انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع exist?‎: ...

يؤسس التابع setsid العملية الحالية على أنَّها جلسة جديدة وقائدة جديدة للمجموعة المالكة للعملية دون التحكم بالطرفية tty. هذا التابع غير متاح على جميع المنصات. البنية العامة setsid → integer القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف الجلسة الحالية. أمثلة مثال على استعمال التابع setsid: Process.setsid #=> 27422 انظر أيضًا التابع getsid: يعيد مُعرِّف الجلسة (session ID) للعملية الحالية أو عملية محدَّدة. التابع setrlimit: يضبط قيد المورد (resource limit) للعملية.  مصادر قسم التابع setsid في الصنف Process في توثيق روبي ...

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

يعيد التابع ppid معرِّف العملية الأب للعملية الحالية. هذا التابع غير متوافر على جميع المنصات. البنية العامة ppid → integer القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف العملية الأب للعملية الحالية. ملاحظة: القيمة المعادة على أنظمة Win32/64 غير جديرة بالثقة. أمثلة مثال على استعمال التابع ppid: puts "I am #{Process.pid}" Process.fork { puts "Dad is #{Process.ppid}" } ناتج تنفيذ هذا المثال هو: I am 27417 Dad is 27417 انظر أيضًا التابع getsid: يعيد مُعرِّف الجلسة (session ID) للعملية الحالية أو عملية محدَّدة. التابع pid: ...

يعيد التابع each قيمة كل عضو من أعضاء البنية بالترتيب. وفي حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each {|obj| block } → struct each → enumerator‎ القيمة المعادة تعاد قيمة كل عضو من أعضاء البنية بالترتيب. وفي حال لم تُعطَ أي كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. أمثلة مثال على استخدام التابع each‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.each {|x| puts(x) ...

يحول التابع expand_path مسار ملفٍ ما إلى مسار مطلق مع توسيع الرمز ~ إن وجد في المسار المعطى. ستستعمل المسارات النسبية مرجعًا إلى مجلد العمل الحالي للعملية إلا إذا أعطي اسم مجلد أو مسار ليُستعمَل نقطةً للإنطلاق وتحديد المسار المطلق. البنية العامة expand_path(file_name [, dir_string] ) → abs_file_name المعاملات file_name اسم المسار المراد تحويله إلى مسار مطلق. يمكن لهذا المسار أن يبدأ بالرمز ~ والذي يوسَّع إلى مجلد المنزل للمستخدم المالك للعملية (يجب أن يكون متغير البيئة HOME مضبوطًا بشكل صحيح). ...

يعين التابع priority عند استدعائه بالشكل priority= integer أولوية المهمة الفرعية التي استدعيت معه إلى القيمة integer. سيتم تشغيل المهام الفرعية ذات الأولوية العالية بشكل أكثر تكرارًا من مثيلاتها ذات الأولوية المنخفضة (ولكنها ستشُغّل على أي حال). هذا مجرد تلميح يستعمله مُجدوِل المهام الفرعية (thread scheduler) في روبي. قد يتم تجاهله على بعض الأنظمة التشغيل. البنية العامة priority= integer→ thr‎ أمثلة مثال على استخدام التابع priority=‎: count1 = count2 = 0 a = Thread.new do loop ...

يحول التابع zip الوسائط الممرَّرة إليه إلى مصفوفات ثم يدمج عناصر المصفوفة التي استُدعيت معه مع العناصر المقابلة في الوسائط (المصفوفات) المُمرَّرة. يولد هذا التابع عددًا من المصفوفات تحوي كلًّا منها n عنصر، إذ n هو عدد الوسائط الممررة مضافًا إليها 1. إن كان حجم أحد الوسائط أصغر من حجم المصفوفة الأصلية، فسيعوض التابع القيمة nil مكان القيم الناقصة. في حال تمرير كتلة برمجية كوسيط، ستُستدعى تلك الكتلة مع كل مصفوفة من المصفوفات الناتجة عن عملية الدمج، وإلا فستعاد تلك ...

تسمح العديد من أنظمة التشغيل بإرسال إشارات إلى العمليات (processes) قيد التشغيل للتحكم بها. بعض الإشارات لها تأثير محدد على العملية، بينما تكون أخرى مرتبطة بالشيفرة البرمجية، وتتصرف بناء عليها. على سبيل المثال، قد تقوم العملية بإمساك (trap) الإشارة USR1 واستخدامها في عملية التنقيح (debugging)، أو قد تُستخدَم الإشارة TERM لبدء إيقاف تشغيل العملية بشكل مُراقَب. pid = fork do Signal.trap("USR1") do $debug = !$debug puts "Debug now: #$debug" end Signal.trap("TERM") ...

يتحقق التابع const_get من وجود ثابت باسم محدد في الوحدة التي استُدعي معها. في حال تعيين المعامل inherit، فسيشمل البحث الأسلاف أيضًا (وكذلك Object إن كانت الوحدة من النوع Module). تُعاد قيمة الثابت إذا عُثر على تعريف له؛ خلا ذلك، سيُطلق الخطأ NameError. Math.const_get(:PI) #=> 3.14159265358979 سيبحث التابع const_get بشكل تكراري (recursively) عن أسماء الثوابت إذا تم توفير اسم صنف من مجال أسماء (namespaced class name). اطلع مثلًا على المثال التالي: module Foo; class Bar; end end Object.const_get 'Foo::Bar' تؤخذ الراية inherit بالحسبان ...

يمثل هذا الصنف طوابيرًا (queues) ذات أحجام سعة محددة. قد تُعطّل العملية push إن كانت السعة لطابور ما ممتلئة. راجع صفحة Queue للحصول على أمثلة حول كيفية عمل الصنف SizedQueue. توابع الصنف العامة new ينشئ طابورًا ذا طول ثابت. توابع النسخة العامة ‎<<‎ يضيف كائنات إلى الطابور المعطى.  clear يزيل كل الكائنات من الطابور. close يغلق الطابور الذي استدعي معه. deq هو اسم بديل للتابع pop. empty?‎ يتحقق إن كان الطابور فارغًا. enq هو اسم بديل للتابع push. length يعيد حجم الطابور ...

يكافئ التابع extended التابع included إلا أنه يُستخدم مع الوحدات الموسعة (extended modules). البنية العامة extended(othermod)‎ المعاملات othermod‎ وحدة من النوع Module. أمثلة مثال على استخدام التابع extended‎: module A def self.extended(mod) puts "#{self} extended in #{mod}" end end module Enumerable extend A end # => prints "A extended in Enumerable"‎ انظر أيضا التابع included: يمثِّل رد نداء يُستدعَى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع extend_object: يوسع الكائن المعطى بإضافة ثوابت ...

يعيد التابع ‎inspect العدد العقدي على شكل سلسلة نصية لأجل فحصها (inspection). البنية العامة inspect → string القيمة المعادة تعاد سلسلة نصية تمثِّل العدد العقدي المعطى. أمثلة أمثلة عن استخدام معامل التابع ‎inspect: Complex(2).inspect #=> "(2+0i)" Complex('-8/6').inspect #=> "((-4/3)+0i)" Complex('1/2i').inspect ...

يحذف التابع chop!‎ المحرف الأخير من السلسلة النصية المعطاة. إذا انتهت السلسلة بالمحرفين r\n\ على الترتيب، فسيحذف التابع كلاهما. يعيد التابع القيمة nil عند استعماله مع سلسلة نصية فارغة. البنية العامة chop! → str or nil القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها بعد حذف المحرف الأخير منها، أو تُعاد القيمة nil إذا كانت السلسلة النصية فارغة. انظر أيضًا التابع chop: يعيد نسخةً عن السلسلة النصية مع حذف المحرف الأخير منها. التابع chomp!‎: يحذف الفاصل السطري المُحدد من نهاية السلسلة ...

يعيد التابع malloc_allocations عدد عمليات الحجز التي أجريت باستعمال malloc()‎. ويتوفر هذا التابع فقط إذا بُنيت روبي مع CALC_EXACT_MALLOC_SIZE. البنية العامة malloc_allocations → Integer القيمة المعادة يعاد عدد صحيح يمثِّل عمليات الحجز التي أجريت باستعمال malloc()‎. انظر أيضا التابع malloc_allocated_size: يعيد حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. مصادر قسم التابع malloc_allocations‎ في الصنف GC في توثيق روبي الرسمي.

التابع inspect هو اسم بديل للتابع to_s. انظر أيضا التابع to_s: يعيد سلسلة نصية تمثل الوحدة أو الصنف المعطى. مصادر قسم التابع inspect‎ في الصنف Module‎ في توثيق روبي الرسمي.

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

تحتفظ بعض أنظمة التشغيل بحالة العمليات الفرعية التي أُنهيَت حتى تجمع العملية الأب تلك الحالة (باستعمال أنواع مختلفة من wait()‎). إن لم تجمع العملية الأب هذه الحالة على الإطلاق، تبقى العملية الابن متراكمة ضمن العمليات الميتة (zombie process). يمنع التابع Process::detach هذا السلوك عبر ضبط خيط منفصل من روبي وظيفته الوحيدة هي جمع الحالة لمعرف العملية (pid) عندما تُنهَى. استعمل التابع detach فقط عندما لا تنوي انتظار العملية الابن لكي تُنهَى بشكل صريح. يعيد الخيط المُنتَظِر (waiting thread) حالة الخروج ...

التابع ()each هو اسم بديل مهمل (deprecated) للتابع each_line. انظر أيضًا التابع each_line: يعيد معرفًا ثابتًا (enumerator) يتكرر (iterates) عبر كل سطر (الذي يفصل بالفاصلة الممرَّرة) من كل ملف من الملفات الموجودة في ARGV. مصادر قسم التابع each في الصنف ARGF في توثيق روبي الرسمي.

يحول التابع ‎to_f العدد العقدي الذي استدعي معه إلى عدد عشري إن كان ذلك ممكنًا (ينبغي أن يساوي الجزء التخيلي القيمة 0 تمامًا، وإلا فسيُطلَق الخطأ RangeError). البنية العامة to_f → float القيمة المعادة يعاد عدد عشري يمثِّل ناتج تحويل العدد العقدي المعطى إن كان ذلك ممكنًا، أو سيُرمَى الخطأ RangeError إن لم يكن ذلك ممكنًا. أمثلة أمثلة عن استخدام التابع ‎to_f: Complex(1, 0).to_f #=> 1.0 Complex(1, 0.0).to_f # RangeError Complex(1, 2).to_f # RangeError انظر ...

الصنف Enumerator هو صنفٌ يسمح بتنفيذ عملية التكرار الداخلي والخارجي على الكائنات. يمكن إنشاء كائنات من هذا الصنف باستعمال إحدى التوابع التالية: Kernel.to_enum، أو Kernel.enum_for، أو new. أغلب التوابع في هذا الصنف تملك شكلين هما: الشكل الكتلي (block form) الذي تقيَّم فيه المحتويات لكل عنصر في المجموعة التعدادية، والشكل الغير كتلي (non-block form) الذي يعيد كائنًا جديدًا من النوع Enumerator يغلِّف التكرار. enumerator = %w(one two three).each puts enumerator.class # => Enumerator enumerator.each_with_object("foo") do |item, obj| puts "#{obj}: #{item}" end # foo: one # ...

ينشئ التابع new استثناءً من النوع NoMethodError للتابع ذي الاسم المعطى مع الوسائط المُمرَّرة. يمكن الدخول إلى الاسم باستخدام التابع ‎#name مع الكائن الناتج، ويمكن الوصول إلى الوسائط باستخدام التابع ‎#args. البنية العامة new([msg, *, name [, args]]) → no_method_error‎ المعاملات msg‎ رسالة الاستثناء. name‎ اسم التابع. args‎ وسائط التابع. القيمة المعادة يعاد استثناءٌ من النوع NoMethodError للتابع ذي الاسم name المعطى مع الوسائط args‎ والرسالة msg‎ المُمرَّرة. انظر أيضا التابع args: يعيد الوسائط التي تم تمريرها كمعامل ثالث إلى الباني. ...