نتائج البحث

الصنف Numeric هو الصنف الذي يجب أن ترثه كل الأصناف العددية عالية المستوى. يسمح الصنف Numeric بتمثيل (instantiation) الكائنات المحجوزة في الكومة (heap-allocated objects). تُنفَّذ الأصناف العددية الأساسية الأخرى، مثل Integer، كأصناف آنيَّة، أي أنّ كل عدد صحيح هو كائن غير قابل للتغيير (immutable)، والذي يُمرَّر دائمًا بقيمته. اطلع على المثال التالي: a = 1 1.object_id == a.object_id #=> true لا يمكن أن يكون هناك إلا نسخة (instance) واحدة فقط من العدد الصحيح 1. تضمن روبي بهذا منع إنشاء نسخ ...

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

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

يُعيد التابع named_captures جدول Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي الذي استُدعي معه. مفاتيح (keys) الجدول Hash هي أسماء الالتقاطات المعينة. أما قيم الجدول Hash فهي مصفوفات تضم فهارس الالتقاطات المسماة المقابلة. إذا لم يكن هناك أي التقاطات مسماة، فسيعاد جدول Hash فارغ. البنية العامة named_captures → hash‎ القيمة المعادة يعاد كائن من النوع Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي المعطى. أمثلة مثال على استخدام التابع named_captures‎: /(?<foo>.)(?<bar>.)/.named_captures #=> {"foo"=>[1], "bar"=>[2]} /(?<foo>.)(?<foo>.)/.named_captures #=> {"foo"=>[1, 2]}‎ /(.)(.)/.named_captures #=> ...

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

يقرأ التابع read ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج. البنية العامة read(name, [length [, offset]] [, opt] )→ string‎ المعاملات name‎ اسم الملف المراد القراءة منه. إن كان name يبدأ بمحرف الأنبوب ("|")، فستُنشَأ عملية فرعية (subprocess) بطريقة مشابهة للتابع Kernel.open، ثم ستعاد مُخرجاتها. length‎ عدد صحيح يمثل عدد البايتات المراد قراءتها من الملف. القيمة الافتراضية لهذا المعامل هي القراءة حتى نهاية الملف. offset‎ عدد صحيح يمثل إزاحة موضع المؤشر في الملف إلى المكان الذي يراد بدء القراءة ...

يحذف التابع shift متغير بيئة (اسم المتغير وقيمته) من البيئة ENV ثمَّ يعيده في مصفوفة. في حال كانت البيئة فارغة، فسيعيد التابع القيمة nil. البنية العامة shift → Array or nil القيمة المعادة تُعاد قيمة متغير البيئة المحذوف. أو تعاد القيمة nil في حال كانت البيئة فارغة. انظر أيضًا التابع clear: يحذف جميع متغيرات البيئة. التابع delete: يحذف متغير بيئة ذي اسم محدَّد، ثم يعيد قيمته. التابع delete_if: يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا. مصادر قسم التابع shift في الصنف ENV في ...

يستدعي التابع cycle الكتلة المعطاة مع كل عنصر من عناصر المُعدِّد الذي استدعي معه عددًا محدَّدًا من المرات أو إلى ما لانهاية إن مُرِّرت القيمة nil إليه أو لم يمُرَّر أي شيء. إن مُرِّر إلى التابع عدد غير موجب أو كانت المجموعة (المُعدِّد) المعطاة فارغةً، فلن يفعل التابع أي شيء. يحتفظ التابع cycle بالعناصر في مصفوفة داخلية، لذا لن يكون لتغيير المُعدِّد بعد تمرير أول عنصر منه أي تأثير. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة ...

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

يعيد التابع instance_methods مصفوفةً تحتوي على أسماء توابع النسخ (instance methods) العامة والمحمية (protected) في المستقبِل. بالنسبة للوحدات، ستكون التوابع هي العامة والمحمية. أما بالنسبة للأصناف، فستكون تلك التوابع هي توابع النسخ (وليس التوابع المفردة [singleton methods]). إذا كان أعطي المعامل الاختيار وكانت قيمته false، فلن يتم تضمين توابع الأسلاف (ancestors). البنية العامة instance_methods(include_super=true)→ array‎ المعاملات include_super‎ قيمة منطقية إن أعطيت وكانت false، فلن يتم تضمين توابع الأسلاف (ancestors). القيمة المعادة تعاد مصفوفة تحتوي على أسماء توابع النسخ العامة والمحمية (protected) ...

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

ينفذ التابع popen الأمر المعطى كعملية فرعية (subprocess) مع توصيل المجرَيَين القياسيين للدخل والخرج للعملية الفرعية مع المجرى IO المُعاد. يمكن الحصول على على معرف العملية (PID) عبر التابع pid. في حال إعطاء كتلة، فستُنفذ روبي التعليمة كعملية فرعية مرتبطة بروبي عبر أنبوب (pipe). سيُمرّر الطرف المقابل لروبي كوسيط إلى الكتلة. في نهاية الكتلة، ستغلق روبي الأنبوب وتعيّن قيمة ‎$?‎‎. في هذه الحالة، سيعيد التابع popen قيمة الكتلة. البنية العامة popen([env,] cmd, mode="r" [, opt])→ io popen([env,] cmd, mode="r" [, opt]) {|io| ...

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

ينتظر التابع waitpid خروج العملية الابن ثم يعيد مُعرِّفها ويضبط ?$ إلى قيمة الكائن Process::Status الذي يحوي معلومات حول تلك العملية. العملية التي ينتظرها التابع wait يعتمد على مُعرِّف العملية pid المُمرَّر إليه. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. هذا التابع غير متاح على جميع المنصات. البنية العامة waitpid(pid=-1, flags=0) → integer المعاملات pid مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية: أكبر من الصفر: ينتظر التابع العملية الابن التي مُعرَّفها ...

يجلب التابع instance_variables جميع أسماء متغيرات النسخة (instance variable) للمستقبل (receiver) المعطى. لاحظ أنَّ مجرَّد تعريف واصلٍ (accessor) لا يُنشئ متغيِّر النسخة الموافق له. البنية العامة instance_variables → array القيم المعادة تُعاد مصفوفةٌ تحتوي أسماء متغيرات النسخة للكائن المعطى. أمثلة مثالٌ عن استخدام التابع instance_variables: class Fred attr_accessor :a1 def initialize @iv = 3 end end Fred.new.instance_variables #=> [:@iv] انظر أيضًا التابع instance_variable_get: يجلب قيمة مُتغيِّر النسخة المُمرَّر إليه من الكائن المعطى. التابع instance_variable_set: ...

ينفذ التابع foreach الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى. إن كان آخر معامل مُمرَّر إلى التابع هو جدول Hash، فسيتم فتح الوسيط المسمى (keyword argument). في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة foreach(name, sep=$/ [, getline_args, open_args]) {|line| block } → nil foreach(name, limit [, getline_args, open_args]) {|line| block }→ nil foreach(name, sep, limit [, getline_args, open_args]) {|line| block } → nil foreach(...) → an_enumerator‎ المعاملات name‎ اسم الملف ...

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

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

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

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

يكتب التابع puts الكائن أو الكائنات المُمرَّرة إليه على المجرى ios (اختصارًا للعبارة Input Output Stream) ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن مرِّرت مصفوفةٌ إلى التابع puts كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع to_s تلقائيًّا. عند استدعاء التابع puts دون تمرير وسائط، سيطبع سطرًا جديدًا ...

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

يعيد التابع divmod مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. البنية العامة divmod(numeric) → array‎ إن كان لدينا العددين q و r = x.divmod(y)‎، فيكون: q = floor(x/y) x = q*y + r يتم تقريب حاصل القسمة نحو اللانهاية السالبة، كما هو موضح في الجدول التالي: a | b | a.divmod(b) | a/b | a.modulo(b) | a.remainder(b) ------+-----+---------------+---------+-------------+--------------- 13 | ...

يعيد التابع minmax_by العنصرين الذيَن تعيد الكتلة المعطاة أًصغر وأكبر قيمة مقابلة لهما على التوالي بعد تمرير عناصر الكائن القابل للتعداد إليها كلٌّ على حدة. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة minmax_by { |obj| block } → [min, max] minmax_by → an_enumerator القيمة المعادة تعاد مصفوفة تحوي العنصرين الذين تعيد الكتلة المعطاة أصغر وأكبر قيمة مقابلة لهما على التوالي بعد تمرير عناصر الكائن القابل للتعداد إليها كلٌّ على حدة، أو يعاد كائن من النوع Enumerator إن ...

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

تنشئ التعابير البرمجية في لغة روبي كائنات يمكنك استخدامها في برنامجك؛ هذه التعابير تتضمّن: القيم المنطقيّة و القيمة nil الأعداد السلاسل النصية الرموز المصفوفات جداول Hash المجالات التعابير النظامية بنى Proc القيم المنطقيّة و القيمة nil إنّ كلًا من nil و false تعبّران عن القيمة المنطقيّة الخطأ (false value). تُستخدم nil أحيانًا لتعبّر عن عدم وجود أيّة قيمة أو قيمة مجهولة، لكنّها تساوي false في العبارات الشرطيّة. أمّا true فهي القيمة المنطقيّة الصحيحة (true value)، وكلّ الكائنات عدا nil و ...

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

الصنف Module هو مجموعة من التوابع والثوابت. التوابع الموجودة في الوحدات Module قد تكون إما توابع نسخة (instance methods)، أو توابع وحدة (module methods). توابع النسخة تظهر كتوابع في صنفٍ عند تضمين الوحدة، وذلك على خلاف توابع الوحدة. وعلى النقيض، يمكن استدعاء توابع الوحدة دون إنشاء كائن يُغلفها، بينما قد لا يمكن فعل ذلك مع توابع النسخة. انظر صفحة module_function. في الأمثلة الموجودة في صفحات التوابع، يشير المعامل sym إلى رمز، والذي قد يكون إما سلسلة نصية، أو كائنًا من النوع ...

يحول التابع to_c الصفر إلى عدد عقدي. البنية العامة to_c → (0+0i)‎ القيمة المعادة يعاد الصفر كعدد عقدي. انظر أيضا التابع to_a: يعيد دائمًا مصفوفة فارغة. التابع to_f: يعيد الصفر دائمًا. مصادر قسم التابع to_c‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

يعيد التابع size عدد متغيرات البيئة. البنية العامة size القيمة المعادة يُعاد عدد متغيرات البيئة. انظر أيضًا التابع length: يعيد عدد متغيرات البيئة. التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. مصادر قسم التابع size في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع length عدد متغيرات البيئة الموجودة. البنية العامة length القيمة المعادة يُعاد عدد متغيرات البيئة. انظر أيضًا التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. التابع size: يعيد عدد متغيرات البيئة. مصادر قسم التابع length في الصنف ENV في توثيق روبي الرسمي.

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

يعيد التابع rationalize الصفر كعدد جذري (rational). يتم تجاهل المعامل الاختياري إن مُرِّر دائمًا. البنية العامة rationalize([eps]) → (0/1)‎ القيمة المعادة يعاد الصفر كعدد جذري (rational). انظر أيضا التابع to_a: يعيد دائمًا مصفوفة فارغة. مصادر قسم التابع rationalize‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

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

يفك التابع unpack ترميز السلسلة النصية التي استدعي معها (والتي قد تحوي بيانات ثنائية) وفقًا إلى سلسلة التنسيق المعطاة، ويعيد مصفوفة من كل قيمة مستخرجة. البنية العامة unpack(format) → anArray المعاملات format سلسلة نصية تمثِّل سلسلة التنسيق. تتكون سلسلة التنسيق من سلسلة من الموجهات ذات المحارف الفردية (اطلع على الجدول الآتي). يمكن أن يعقب كل موجِّه عددٌ يشير إلى عدد مرات تكرار هذا الموجه. سيستعمل الرمز * كل العناصر المتبقية. يمكن أن يلي كل موجه من الموجهات sSiIlL شرطة سفلية ...

يُعيد التابع backtrace التعقب (backtrace) الحالي للمهمة فرعية التي استدعي معها. البنية العامة backtrace → array‎ القيمة المعادة تعاد مصفوفة تمثل التعقب (backtrace) الحالي للمهمة فرعية المعطاة. انظر أيضًا التابع backtrace_locations: يُعيد مكدس التنفيذ (execution stack) الخاص بالمهمة الفرعية التي استدعي معها. مصادر قسم التابع backtrace‎ في الصنف Thread‎ في توثيق روبي الرسمي.

كائنات الصنف Dir هي مجاري مجلدات (directory streams) تمثِّل الجلدات في نظام الملفات الأساسي لنظام التشغيل. فهي توفر طرائق متعددة لعرض المجلدات ومحتوياتها. انظر أيضًا صفحة الصنف File لمزيد من المعلومات. يحوي المجلد المستخدم في الأمثلة الموجودة في صفحات التوابع ملفين عاديين هما: config.h و main.rb، بالإضافة إلى المجلد الأب (..) ، والمجلد نفسه (.). توابع الصنف العامة (Public Class Methods) المعامل [] يكافئ استدعاء Dir.glob([string,...], 0)‎.  chdir‎ يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. children ...

يفتح التابع write ملفًا محدَّدًا ويكتب فيه السلسلة النصية المُمرَّرة إليه ثم يغلقه ويعيد عدد البايتات التي كتبها. يضمن التابع write أن يُغلق الملف قبل إعادة أية قيمة. إن كان المعامل الأخير عبارة عن جدول Hash، فسيحدد الخيارات الداخلية للتابع open()‎. البنية العامة write(name, string [, offset]) → integer write(name, string [, offset] [, opt])→ integer‎ المعاملات name‎ اسم الملف المراد كتابة السلسلة النصية string فيه. string‎ سلسلة نصية يراد كتابتها ضمن الملف. offset‎ عدد صحيح يمثل إزاحة موضع المؤشر في ...

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

يعيد التابع to_s سلسلة نصية تحوي وصفًا لهذه البنية. يملك التابع to_s اسمًا بديلًا هو inspect. البنية العامة to_s() القيمة المعادة تعاد سلسلة نصية تحوي وصفًا لهذه البنية. انظر أيضًا التابع to_h: يُعيد جدول Hash يحوي أسماء وقيم أعضاء البنية. التابع to_a: يعيد قيم هذه البنية على هيئة مصفوفة. مصادر قسم التابع to_s‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يمثل الصنف Integer الأعداد الصحيحة. لا يمكن إضافة تابع أحادي (singleton method) إلى كائن من الصنف Integer، وأي محاولة لفعل ذلك ستؤدي إلى إطلاق الخطأ TypeError. الثوابت (Constants) GMP_VERSION يمثِّل النسخة GMP المُحمّلة. توابع الصنف العامة (Public Class Methods) sqrt يعيد التابع sqrt‎ الجذر التربيعي الصحيح للعدد الصحيح الموجب المُمرر إليه. توابع الكائن العامة (Public Instance Methods) % يعيد المعامل %‎ باقي عملية القسمة الصحيحة بين عددين. & ينفذ المعامل & العملية AND بين بتات العددين المعطيين. * يعيد المعامل *‎ ناتج عملية الضرب بين عددين. ** يعيد المعامل **‎ ناتج ...

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

يعيد التابع local_variables قائمة بأسماء المتغيرات المحلية المُعرّفة حيث أُطلِق الاستثناء NameError. هذا التابع مخصص للإستخدام الداخلي فقط. البنية العامة local_variables → array‎ القيمة المعادة تعاد مصفوفة تحوي أسماء المتغيرات المحلية المُعرّفة حيث أُطلٍق الاستثناء NameError. انظر أيضا التابع new: ينشئ استثناءً جديدًا من النوع NameError. التابع name: يعيد الاسم المقترن بالاستثناء NameError الحالي. مصادر قسم التابع local_variables‎ في الصنف NameError‎ في توثيق روبي الرسمي.

يعيد التابع b نسخة من السلسلة النصية التي استدعيت معه مرمزة بالترميز ASCII-8BIT. البنية العامة b → str القيمة المعادة تعاد نسخة من السلسلة النصية المعطاة مرمزة بالترميز ASCII-8BIT. انظر أيضًا التابع new: ينشئ سلسلةً نصيةً جديدةً تحوي البيانات المُمرَّرة إليه. التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. مصادر قسم التابع ‎b في الصنف String في توثيق روبي الرسمي.

يعيد التابع to_s كامل السلسلة النصية المُطابقة. البنية العامة to_s→ str‎ القيمة المعادة تعاد كامل السلسلة النصية المُطابقة. أمثلة مثال على استخدام التابع to_s‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.to_s #=> "HX1138"‎ انظر أيضا التابع string: يعيد نسخةً مُجمدةً من السلسلة النصية التي تم تمريرها إلى التابع match لمطابقتها مع تعبير نمطي. التابع to_a: يعيد مصفوفة المطابقات. مصادر قسم التابع to_s‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يهيِّئ التابع initgroups قائمة وصول المجموعات الإضافية (supplemental group access list) عبر قراءة قاعدة بيانات مجموعة النظام (system group database) واستعمال جميع المجموعات التي يكون المستخدم المعطى عضوًا فيها. يمكن إضافة مجموعة ذات مُعرِّف محدَّد إلى القائمة أيضًا. هذا التابع غير متاح على جميع المنصات. البنية العامة initgroups(username, gid) → array المعاملات username المستخدم المراد إضافة المجموعات التي يكون عضوًا فيها إلى قائمة وصول المجموعات الإضافية. gid عدد صحيح يشير إلى مُعرِّف المجموعة المراد إضافتها إلى قائمة وصول المجموعات الإضافية. القيم ...

يُنشئ التابع new كائنًا جديدًا من النوع Exception، ويمرِّر رسالة اختياريًّا إليه. البنية العامة new(msg = nil) → exception المعاملات msg الرّسالة المراد تمريرها. القيم المعادة يُعاد كائنٌ جديدٌ من النوع Exception. انظر أيضا التابع exception: يُعيد المُستقبل (receiver). التابع backtrace: يُعيد أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء. التابع set_backtrace: يضبط معلومات المصفوفة backtrace الخاصة بكائن الاستثناء. مصادر صفحة التابع new في الصنف Exception في توثيق روبي الرسمي.

يستورد التابع using الأصناف المحسَّنة (class refinements) من الوحدة المٌمررة إليه إلى التعريف الحالي للصنف أو الوحدة. البنية العامة using(module) → self‎ المعاملات module‎ الوحدة التي سيُستورد منها الأصناف المحسَّنة. القيمة المعادة يعاد الكائن المعطى نفسه. انظر أيضا التابع refine: يحسِّن الوحدة المستقبلة (receiver) ثم يعيد الوحدة التي عُرِّفت فيها التوابع المحسَّنة. التابع used_modules: يعيد مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. مصادر قسم التابع using‎ في الصنف Module‎ في توثيق روبي الرسمي.

يُعيد التابع size عدد أعضاء البنية التي استُدعي معها. البنية العامة size→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل عدد أعضاء البنية المعطاة. أمثلة مثال على استخدام التابع size‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.length #=> 3‎ انظر أيضًا التابع to_a: يعيد قيم هذه البنية على هيئة مصفوفة. مصادر قسم التابع size‎ في الصنف Struct‎ في توثيق روبي الرسمي.

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

يُبدِّل التابع replace‎ محتويات الجدول hash المعطى مكان محتويات متغيرات البيئة الحالية. البنية العامة replace(hash) → env المعاملات hash كائنٌ من النوع Hash يراد أن تُستبدَل متغيرات البيئة الحالية به. القيم المعادة يُعاد كائن من الصنف ENV يمثِّل البيئة الجديدة التي حلت مكان البيئة القديمة. انظر أيضًا التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. التابع fetch‎: يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ. مصادر قسم التابع replace في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع chr المحرف الأول من السلسلة النصية المُعطاة. البنية العامة chr → string القيمة المعادة تُعاد سلسلة جديدة مؤلفة من المحرف الأول للسلسلة النصية المُعطاة. أمثلة مثال على استخدام التابع chr: a = "abcde" a.chr #=> "a" انظر أيضًا التابع capitalize: يعيد نسخة عن السلسلة النصية المعطاة مع تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة. التابع chars: يُعيد محارف السلسلة النصية على شكل مصفوفة. مصادر قسم التابع ‎chr في الصنف String في ...

يُعيد التابع length عدد أعضاء البنية. البنية العامة length → integer‎ القيمة المعادة يعاد عدد أعضاء البنية. أمثلة مثال على استخدام التابع length‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.length #=> 3‎ انظر أيضًا التابع inspect: يعيد سلسلة نصية تحتوي وصفًا لهذه البنية. التابع members: يُعيد أعضاء البنية على هيئة مصفوفة من الرموز. مصادر قسم التابع length‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يحول التابع to_h الكائن القابل للتعداد المعطى إلى كائن من النوع Hash. البنية العامة to_h(*args) → hash المعاملات args الوسائط المراد استعمالها في عملية التحويل. القيمة المعادة يعاد كائن جديد من النوع Hash يحوي قائمة من الأزواج مفتاح/قيمة الناتجة عن تحويل الكائن القابل للتعداد المعطى. أمثلة مثال على استعمال التابع to_h: %i[hello world].each_with_index.to_h # => {:hello => 0, :world => 1} انظر أيضًا التابع to_a: يحول الكائن القابل للتعداد إلى مصفوفة. مصادر قسم التابع to_h في الصنف Enumerable في توثيق روبي ...

يحسب التابع hash الشيفرة hash للمجال الذي استدعي معه. يكون لمجالين عنصرا بدايتهما ونهايتهما متساويان (وفق المعامل eql?‎)، وقيمة exclude_end?‎ الخاصة بهما متساوية أيضًا نفس رمز التكويد. البنية العامة hash → integer‎ ‎القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash للمجال المعطى. انظر أيضا التابع Object.hash: يحسب الشيفرة hash للكائن الذي استدعي معه. التابع first: يعيد الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. مصادر قسم التابع hash‎ في الصنف Range‎ في توثيق روبي الرسمي.

يتحقق التابع ?enclosed إذا كانت مجموعة الخيوط التي استدعيت معه مغلقةً أم لا. البنية العامة enclosed? → true or false القيمة المعادة تعاد القيمة true إذا كانت مجموعة الخيوط المعطاة مغلقةً. خلا ذلك، تعاد القمية false. انظر أيضًا التابع add: يضيف الخيط المُمرَّر إليه إلى مجموعة الخيوط التي استدعي معها. التابع enclose: يمنع إضافة أو إزالة أي خيط من مجموعة الخيوط التي استدعيت معه. التابع list: يعيد مصفوفة تحوي جميع الكائنات Thread الموجودة والتابعة لمجموعة الخيوط التي استدعيت معه. مصادر ...

يعيد التابع modulo‎ باقي عملية قسمة العدد العشري الذي استُدعي معه على العدد المُعطى. البنية العامة modulo(other) → float المعاملات other عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد عشري يمثِّل باقي عملية قسمة العدد العشري الذي استُدعي معه على العدد المُعطى. انظر أيضا المعامل %: يعيد باقي عملية القسمة الصحيحة. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي (modulus) عملية تقسيم العدد الذي استٌدعي التابع معه على العدد المُمرَّر إليه. مصادر قسم التابع modulo‎ في الصنف Float في ...

يعيد التابع modulo‎ باقي عملية قسمة العدد العشري الذي استُدعي معه على العدد المُعطى. البنية العامة modulo(other) → float المعاملات other عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد عشري يمثِّل باقي عملية قسمة العدد العشري الذي استُدعي معه على العدد المُعطى. انظر أيضا المعامل %: يعيد باقي عملية القسمة الصحيحة. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي (modulus) عملية تقسيم العدد الذي استٌدعي التابع معه على العدد المُمرَّر إليه. مصادر قسم التابع modulo‎ في الصنف Float في ...

يُعيد التابع length طول محارف السلسلة النصية التي استدعي معها. البنية العامة length → integer القيمة المعادة يُعاد عدد صحيح يُمثل طول محارف السلسلة النصية المعطاة. أمثلة مثال على استعمال التابع length: "hello".length #=> 5 انظر أيضًا التابع bytesize: يعيد طول السلسلة النصية التي استدعيت معه بالبايت. التابع chars: يُعيد محارف السلسلة النصية على شكل مصفوفة. التابع each_char: يُمرر كل محرف من محارف السلسلة النصية التي استدعي معها إلى الكتلة المُعطاة. مصادر قسم التابع length‎ في الصنف String في توثيق ...

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

يستدعي التابع call العملية continuation. يستمر البرنامج من نهاية كتلة callcc. إذا لم تعطَ أي وسائط إلى التابع، فستعيد الكتلة callcc الأصلية القيمة nil. إما إذا أُعطي وسيطٌ واحدٌ، فستعيد callcc ذلك الوسيط. خلا ذلك، ستُعاد مصفوفة تحتوي على الوسائط الممرّرة. البنية العامة call[args, ...] أمثلة أمثلة عن استخدام معامل التابع ‎call: callcc {|cont| cont.call } #=> nil callcc {|cont| cont.call 1 } ...

يجري التابع fdiv عملية القسمة بين العدد الذي استدعي معه والعدد الذي مُرِّر إليه ثم يعيد الناتج في عدد عشري. البنية العامة fdiv(numeric) → float‎ المعاملات numeric‎ العدد الذي يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد عشري يمثِّل ناتج القسمة بين العدد المعطى والعدد numeric‎. انظر أيضا التابع div: يستخدم المعامل / لإجراء عملية القسمة على العددين المعطيين، ثم يحوّل النتيجة إلى عدد صحيح. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر ...

يستدعي التابع cont العملية continuation. يستمر البرنامج من نهاية كتلة callcc. إذا لم تعطَ أي وسيط إلى التابع، فستعيد الكتلة callcc الأصلية القيمة nil. أمَّا إذا أُعطي وسيطٌ واحدٌ، فستعيد callcc ذلك الوسيط. خلا ذلك، ستُعاد مصفوفة تحتوي على الوسائط الممرّرة. البنية العامة cont[args, ...] أمثلة أمثلة عن استخدام معامل التابع ‎cont: callcc {|cont| cont.call } #=> nil callcc {|cont| cont.call 1 } ...

يعيد التابع clone الكائن الذي استُدعي معه. لا يمكن أن تكون قيمة المعامل freeze المُمرَّر إليه false. البنية العامة clone(freeze: true) → num‎ freeze قيمة منطقية تكون true دومًا ولا يمكن أن تكون false. القيمة المعادة يعاد الكائن المعطى نفسه بعد إنشاء نسخة منه. انظر أيضا التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة. التابع coerce: إن كان العدد المُمرَّر إليه من نفس نوع العدد المستدعى معه، فستُعاد مصفوفة تحوي هذين ...

يجري التابع fdiv عملية القسمة بين العدد الذي استدعي معه والعدد الذي مُرِّر إليه ثم يعيد الناتج في عدد عشري. البنية العامة fdiv(numeric) → float‎ المعاملات numeric‎ العدد الذي يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد عشري يمثِّل ناتج القسمة بين العدد العشري المعطى والعدد numeric‎. انظر أيضا المعامل /: يعيد ناتج عملية القسمة بين عدد عشري وعدد آخر. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. مصادر قسم التابع ...

يُستدعَى التابع method_added في كل مرة يُضاف تابع نسخة (instance method) إلى المُستقبِل (receiver). البنية العامة method_added(method_name)‎ المعاملات method_name‎ اسم تابع النسخة. أمثلة مثال على استخدام التابع method_added‎: module Chatty def self.method_added(method_name) puts "Adding #{method_name.inspect}" end def self.some_class_method() end def some_instance_method() end end‎ ناتج تنفيذ هذا المثال هو: Adding :some_instance_method انظر أيضا التابع instance_methods: يعيد مصفوفة تحتوي على أسماء توابع النسخ (instance methods) العامة والمحمية (protected) في المستقبِل (receiver). التابع method_defined?‎: يتحقق إن كان التابع المعطى مُعرّفًا في ...

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

يعيد المعامل modulo‎ باقي عملية قسمة العدد الذي استُدعي معه على العدد المُعطى. البنية العامة modulo(other) → real‎ المعاملات other عدد صحيح. القيمة المعادة يعاد باقي عملية قسمة العدد الذي استُدعي معه على العدد المُعطى. انظر أيضا المعامل %: يعيد باقي عملية القسمة الصحيحة. التابع div: يعيد ناتج عملية قسمة العدد الذي استدعي معه على العدد الذي مُرِّر إليه. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي (modulus) عملية تقسيم العدد الذي استٌدعي التابع معه على العدد المُمرَّر إليه. مصادر ...

يعيد التابع bytesize طول السلسلة النصية التي استدعيت معه بالبايت. البنية العامة bytesize → integer القيمة المعادة يعاد عدد صحيح يمثل طول السلسلة النصية المُستدعاة بالبايت. أمثلة مثال على استخدام التابع bytesize: "\x80\u3042".bytesize #=> 4 "hello".bytesize #=> 5 انظر أيضًا التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. التابع byteslice: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. التابع ...

يعيد التابع quo ناتج قسم العدد العشري المستدعى معه على العدد العشري المُمرَّر إليه. هذا التابع يشبه تمامًا المعامل /. البنية العامة quo(numeric) → float المعاملات numeric عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد ناتج قسمة العدد العشري المعطى على العدد numeric. انظر أيضا المعامل /: يعيد ناتج عملية القسمة بين عدد عشري وعدد آخر. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. التابع modulo: يعيد باقي عملية القسمة بين عدد عشري ...

يعيد التابع included_modules قائمة بالوحدات المضمنة في الوحدة التي استُدعي معها. البنية العامة included_modules → array‎ القيمة المعادة تعاد مصفوفة تحوي الوحدات المضمنة في الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع included_modules‎: module Mixin end module Outer include Mixin end Mixin.included_modules #=> [] Outer.included_modules #=> [Mixin]‎ انظر أيضا التابع include: يستدعي التابع Module.append_features على كل المعاملات الممررة بترتيب عكسي. التابع included: يُستدعى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع include?‎: يتحقق إن كانت الوحدة المعطاة مُضمّنةً ...

يعيد التابع remainder باقي قسم عدد على آخر. أي عندما يُستدعَى التابع بالشكل x.remainder(y)‎، فإنه يماثل الاستدعاء x-y*(x/y).truncate. البنية العامة remainder(numeric) → real‎ المعاملات numeric‎ عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد حقيقي يمثِّل باقي قسمة العدد المعطى على العدد numeric‎ بشكل يماثل استدعاء x-y*(x/y).truncate. انظر أيضا التابع modulo: يعيد باقي قسم عدد على آخر. التابع d‎ivmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. مصادر قسم التابع remainder‎ في الصنف Numeric‎ في توثيق روبي الرسمي. ...

يعيد التابع modulo باقي قسم عدد على آخر. أي عندما يُستدعَى التابع بالشكل x.modulo(y)‎، فإنه يماثل الاستدعاء x-y*(x/y).floor. يكافي هذا التابع التعبير num.divmod(numeric)[1]‎. البنية العامة modulo(numeric) → real‎ المعاملات numeric‎ عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد حقيقي يمثِّل باقي قسمة العدد المعطى على العدد numeric‎. انظر أيضا التابع d‎ivmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. التابع magnitude: يعيد القيمة المطلقة للعدد الذي استدعي معه. مصادر قسم التابع modulo‎ في الصنف Numeric‎ في توثيق روبي ...

يعين التابع thread_variable_set قيمة متغير محلي ذي اسم محدَّد في المهمة الفرعية (thread local) إلى قيمة معيَّنة. لاحظ أنَّ هذه المتغيرات محلية في المهمة الفرعية، وليس في الألياف. يرجى الاطلاع على صفحة التابع thread_variable_get والمعامل [] لمزيد من المعلومات. البنية العامة thread_variable_set(key, value)‎ المعاملات key‎ اسم المتغير. value‎ قيمة المتغير. انظر أيضًا التابع thread_variable_get: يُعيد قيمة المتغير المحلي في المهمة الفرعية (thread local variable) الذي تم تعيينه. التابع thread_variables: يُعيد مصفوفة من أسماء المتغيرات المحلية في المهمة الفرعية (thread-local) على شكل رموز. مصادر ...

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

عندما تستدعي تابعًا، فإنّك تمرّر رسالة لكائن معيّن لأجل تنفيذ مهمّة معيّنة، ويتمّ ذلك في لغة روبي كالتّالي: my_method() لاحظ أنّ استخدام الأقواس المنحنية هنا اختياريّ: my_method المعتمد في هذا التّوثيق أن تُستخدّم الأقواس عند وجود المعامِلات لإزالة الالتباس، إلا في حالة وجود فرق بين وجود الأقواس وحذفها. هذا القسم يغطّي فقط كيفيّة استدعاء التوابع، وستُشرَح كيفيّة تعريف التّوابع في قسم آخر. المستقبِل المستقبِل (Receiver) الافتراضي في لغة روبي هو self وهو الذي يُستخدَم في حال عدم تحديد أيّ مستقبل آخر. ولأجل ...

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

ينتظر التابع wait خروج العملية الابن ثم يعيد مُعرِّفها ويضبط ?$ إلى قيمة الكائن Process::Status الذي يحوي معلومات حول تلك العملية. العملية التي ينتظرها التابع wait يعتمد على مُعرِّف العملية pid المُمرَّر إليه. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. هذا التابع غير متاح على جميع المنصات. البنية العامة wait() → integer click to toggle source wait(pid=-1, flags=0) → integer waitpid(pid=-1, flags=0) → integer المعاملات pid مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية: ...

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

يعيد التابع quo ناتج القسمة الأكثر دقة (قيمة جذرية للأعداد الصحيحة، وقيمة عشرية للأعداد العشرية). البنية العامة quo(int_or_rat)→ rat quo(flo) → flo‎ المعاملات int_or_rat‎ عدد صحيح أو جذري. flo‎ عدد عشري. القيمة المعادة يعاد ناتج القسمة الأكثر دقة (قيمة جذرية للأعداد الصحيحة، وقيمة عشرية للأعداد العشرية). انظر أيضا التابع div: يستخدم المعامل / لإجراء عملية القسمة على العددين المعطيين، ثم يحوّل النتيجة إلى عدد صحيح. التابع divmod: يعيد مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر ...

يفعِّل التابع binmode الوضع الثنائي (binary mode) للمجرى ARGF؛ وبمجرد أن يصبح المجرى في الوضع الثنائي، لا يمكن إعادته إلى الوضع غير الثنائي. هذا الخيار له التأثيرات التالية: تصبح عملية تحويل السطر الجديد غير ممكنة. تصبح عملية تحويل الترميز غير ممكنة أيضًا. يُعامل المحتوى وكأنه كُتِب باستعمال الترميز ASCII-8BIT. البنية العامة binmode → ARGF انظر أيضًا التابع binmode?‎: يتحقق‎ إذا تمت قراءة المجرى ARGF في الوضع الثنائي (binary mode). التابع argv: يعيد المصفوفة ARGV التي تحوي الوسائط المُمرّّرة إلى ...

يتحقق التابع key?‎ إن كانت السلسلة النصية أو الرمز المعطى موجود على هيئة متغير محلي الليف (fiber-local variable). البنية العامة key?(sym)→ true or false‎ المعاملات sym‎ سلسلة نصية أو رمز يراد التحقق منه. القيمة المعادة تعاد القيمة true إن كانت السلسلة النصية أو الرمز المعطى موجود على هيئة متغير محلي الليف (fiber-local variable)، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع key?‎: me = Thread.current me[:oliver] = "a" me.key?(:oliver) #=> true me.key?(:stanley) #=> false‎ انظر أيضا ...

يُعيد التّابع convpath مسار التّحويلِ الخاصَّ بالكائن من الصنف Encoding::Converter. البنية العامة convpath → ary القيم المعادة تُعاد مصفوفة تحوي ترميزات مسار التحويل. يكون كل عنصر في هذه المصفوفة إما زوجًا من الترميزات أو سلسلةً نصيّةً. يمثّل هذا الزّوج عملية التحويل التي حصلت. بينما تمثل السلسلة النصية المُزخرف (decorator) المُستعمَل. أمثلة مثالٌ عن استخدام التابع convpath: ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP", crlf_newline: true) p ec.convpath #=> [[#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>], # [#<Encoding:UTF-8>, #<Encoding:EUC-JP>], # "crlf_newline"] في المثال أعلاه، يمثل الزوج [#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>] ...

يقتطع التابع truncate الملف الذي استدعي معه إلى حجمٍ محدَّدٍ. يجب أن يكون هذا الملف مفتوحًا في وضع الكتابة. هذا التابع غير متوافر على جميع المنصات. البنية العامة truncate(integer) → 0 المعاملات integer عدد صحيح يمثِّل حجم الملف المراد اقتطاعه إليه. القيمة المعادة تعاد القيمة 0 عند اكتمال العملية. أمثلة مثال على استعمال التابع truncate: f = File.new("out", "w") f.syswrite("1234567890") #=> 10 f.truncate(5) #=> 0 f.close() ...

يستخدم التابع values_at الفهارس المُمرَّرة إليه للوصول إلى قيم العناصر المُتطابقة ثم يعيدها. البنية العامة values_at([index]*)→ array‎ المعاملات index‎ يمثل فهرس العنصر المتطابق في مصفوفة المطابقات. القيمة المعادة تعاد قيمة العناصر المتطابقة المحددة بالفهارس index‎ المعطاة. أمثلة مثال على استخدام التابع values_at‎: m = /(.)(.)(\d+)(\d)/.match("THX1138: The Movie") m.to_a #=> ["HX1138", "H", "X", "113", "8"] m.values_at(0, 2, -2) #=> ["HX1138", "X", "113"] m = /(?<a>\d+) *(?<op>[+\-*\/]) *(?<b>\d+)/.match("1 + 2") m.to_a ...

يقتطع التابع truncate ملفًا ما إلى حجمٍ محدَّدٍ. هذا التابع غير متوافر على جميع المنصات. البنية العامة truncate(file_name, integer) → 0 المعاملات file_name اسم الملف المراد اقتطاعه. integer عدد صحيح يمثِّل حجم الملف المراد اقتطاعه إليه. القيمة المعادة تعاد القيمة 0 عند اكتمال العملية. أمثلة مثال على استعمال التابع truncate: f = File.new("out", "w") f.write("1234567890") #=> 10 f.close #=> nil File.truncate("out", 5) ...

يحول التابع to_i قيمة التوقيت المعطى إلى عدد صحيح يمثل الثواني التي مرت منذ توقيت يونكس. البنية العامة to_i→ int‎ القيمة المعادة تعاد قيمة التوقيت كعدد صحيح يمثل عدد الثواني التي مرت منذ توقيت يونيكس. أمثلة مثال على استخدام التابع to_i‎: t = Time.now "%10.5f" % t.to_f #=> "1270968656.89607" t.to_i #=> 1270968656‎ انظر أيضًا التابع to_a: يحول التوقيت الذي استدعي معه إلى مصفوفة.. التابع to_f: يحول قيمة التوقيت المعطى إلى ...

يمنع التابع enclose إضافة أو إزالة أي خيط من مجموعة الخيوط التي استدعيت معه. لا يزال بإمكان الخيوط الجديدة أن تُبدَأ في مجموعة خيوط مغلقة. البنية العامة enclose → thgrp القيمة المعادة تعاد مجموعة الخيوط المعطاة بعد إغلاقها. أمثلة مثال على استعمال التابع enclose: ThreadGroup::Default.enclose #=> #<ThreadGroup:0x4029d914> thr = Thread.new { Thread.stop } #=> #<Thread:0x402a7210 sleep> tg = ThreadGroup.new ...

يُعيد التابع singleton_class صنف الكائن المُنفرد (singleton class) للكائن الذي استدعي معه. يُنشئ هذا التابع صنفًا منفردًا جديدًا إذا كان هذا الكائن لا يملك واحدًا. البنية العامة singleton_class → class القيم المعادة إذا كان الكائن المعطى هو nil، أو true، أو false، فسيُعاد الصنف NilClass، أو TrueClass، أو FalseClass على التوالي. إذا كان الكائن عددًا صحيحًا (integer)، أو عشريًا (Float)، أو رمزًا (Symbol)، فسيُرمَى الاستثناء TypeError. أمثلة مثالٌ عن استخدام التابع singleton_class: Object.new.singleton_class #=> #<Class:#<Object:0xb7ce1e24>> String.singleton_class ...

يُعيد التّابع exception المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلا ذلك، يُنشئ كائن استثناءٍ جديد (exception object)من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى string.to_str. البنية العامة exception(string) → an_exception or exc المعاملات string سلسلةٌ نصيةٌ تمثل الرسالة. القيم المعادة يُعاد المستقبل إن لم يمرر أي وسيط أو كان الوسيط المعطى نفسه المستقبل، أو يعاد كائن استثناء جديد يُمثِّل المستقبل. انظر أيضا التابع new: يُنشئ كائنًا ...

يعيد التابع key المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي استدعي معه. البنية العامة key(value) → key المعاملات value القيمة المراد جلب المفتاح المرتبط لها. القيمة المعادة تعاد المفتاح المقابل للقيمة value في الكائن Hash المعطى، أو تعاد القيمة nil إذا كانت تلك القيمة غير موجودة. أمثلة مثال على استعمال التابع key: h = { "a" => 100, "b" => 200, "c" => 300, "d" => 300 } h.key(200) #=> "b" h.key(300) #=> "c" h.key(999) #=> nil ...

يعيد التابع ldexp ناتج التعبير fraction * (2 ** exponent)‎. البنية العامة ldexp(fraction, exponent) → float‎ المعاملات fraction‎ عدد يمثل الجزء العشري من التعبير الأسّي. exponent‎ عدد يمثل الأس. القيمة المعادة يعاد عدد عشري يمثِّل ناتج التعبير fraction * (2 ** exponent)‎. أمثلة مثال على استخدام التابع ldexp‎: fraction, exponent = Math.frexp(1234) Math.ldexp(fraction, exponent) #=> 1234.0‎ انظر أيضا التابع hypot: يحسب القيمة sqrt (x ** 2 + y ** 2)‎، التي تمثل قيمة وتر المثلث قائم الزاوية (hypotenuse of a right-angled triangle) ...

يعيد التابع protected_instance_methods قائمة بتوابع النسخة (instance methods) المحمية المعرفة في الوحدة. إذا مُرِّرت قيمة إلى التابع وكانت false، فلن تُتضمّن توابع الأسلاف (ancestors). البنية العامة protected_instance_methods(include_super=true)→ array‎ المعاملات include_super‎ إذا كان هذا الوسيط يساوي false، فلن تُتضمّن توابع الأسلاف (ancestors). القيمة الافتراضية هي: true. القيمة المعادة تعاد مصفوفة تمثِّل قائمة بتوابع النسخة (instance methods) المحمية المعرفة في الوحدة. انظر أيضا التابع protected: يعين المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى المرئية protected المحمية. التابع protected_method_defined?‎: يتحقق إن كان التابع المحمي (protected) المعطى ...

يعيد التابع private_instance_methods قائمة بتوابع النسخة الخاصة (private instance methods) المعرفة في الوحدة. إن مُرِّر إلى التابع القيمة false، فلن تُضمّن توابع الأسلاف (ancestors). البنية العامة private_instance_methods(include_super=true) → array‎ المعاملات include_super‎ قيمة منطقية إن كانت false، فلن تُضمّن توابع الأسلاف (ancestors). القيمة المعادة تعاد مصفوفة تحوي توابع النسخة الخاصة (private instance methods) المعرفة في الوحدة. أمثلة مثال على استخدام التابع private_instance_methods‎: module Mod def method1() end private :method1 def method2() end end Mod.instance_methods ...

يعيد التابع slice كائنًا من النوع Hash يحتوي فقط على مفاتيح محدَّدة وقيمها. البنية العامة slice(*keys) → a_hash المعاملات Keys المفاتيح التي يراد اقتطاعها من الكائن Hash المعطى ووضعها هي وقيمها في كائن منفصل. القيمة المعادة يعاد كائن من النوع Hash يحوي المفاتيح keys وقيمها الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع slice: h = { a: 100, b: 200, c: 300 } h.slice(:a) #=> {:a=>100} h.slice(:b, :c, :d) ...

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

يعيد التابع exp قيمة التعبير e ** x (أي القيمة ex) إذ x هو المعامل الممرَّر إلى الدالة، و e هو ثابت أولر (يدعى أيضًا الثابت النيبيري). مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎0 ، INFINITY]. البنية العامة exp(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة التعبير e ** x (أي القيمة ex) إذ x هو المعامل المعطى، و e هو ثابت أولر (يدعى أيضًا الثابت النيبيري). أمثلة مثال على استخدام التابع exp‎: Math.exp(0) #=> 1.0 Math.exp(1) ...

يُعيد التابع path مسار سلسلة التعليمات التي استُدعي معها، أو يعيد <compiled> إذا تم تقييم سلسلة التعليمات انطلاقًا من سلسلة نصية. البنية العامة path() القيمة المعادة يعاد مسار سلسلة التعليمات المعطاة، أو يعاد <compiled> إذا تم تقييم سلسلة التعليمات انطلاقًا من سلسلة نصية. أمثلة مثال على استخدام التابع path‎ مع irb: iseq = RubyVM::InstructionSequence.compile('num = 1 + 2') #=> <RubyVM::InstructionSequence:<compiled>@<compiled>> iseq.path #=> "<compiled>"‎ مثال آخر على استخدام التابع path‎ مع compile_file: # /tmp/method.rb def hello puts "hello, world" end # in irb > iseq = RubyVM::InstructionSequence.compile_file('/tmp/method.rb') > iseq.path ...

يوفر الصنف ThreadGroup وسيلة لتتبع عددٍ من الخيوط (threads) باستمرار وكأنهم مجموعة واحدة. يمكن أن يكون الخيط Thread في مجموعة خيوط ThreadGroup واحدة على الأكثر فقط. وإضافة هذا الخيوط إلى مجموعة جديدة يؤدي إلى إزالته من أية مجموعة أضيف إليها سابقًا. الخيوط المنشأة حديثًا تنتمي إلى المجموعة نفسها التي أُنشِئَت هذه الخيوط منها. الثوابت Default المجموعة ThreadGroup الافتراضية التي تُنشَأ عند بدء روبي. تنتمي جميع الخيوط لهذه المجموعة بشكل افتراضي. توابع النسخة العامة add يضيف الخيط المُمرَّر إليه إلى مجموعة ...

يعيد التابع rstrip نسخة عن السلسلة النصية التي استدعي معها مع حذف المسافات البيضاء من نهايتها. البنية العامة rstrip → new_str القيمة المعادة تُعاد نسخة عن السلسلة النصية المعطاة مع حذف المسافات البيضاء من نهايتها. أمثلة مثال على استعمال التابع rstrip: " hello ".rstrip #=> " hello" "hello".rstrip #=> "hello" انظر أيضًا التابع rstrip!‎: يحذف المسافة البيضاء من نهاية السلسلة النصية التي استدعي معها. التابع rjust: يعيد سلسلة جديدة بطول ...