نتائج البحث

الصنف Enumerator::Lazy هو صنف يسمح بعملية التكرار - مثل الصنف Enumerator - ولكن بالنمط الكسول (lazy fashion). توابع الصنف العامة new ينشئ كائن تعداد جديد من النوع Enumerator::Lazy. توابع النسخة العامة chunk chunk_while collect collect_concat يعيد كائن تعداد جديد من النوع Lazy مع النتائج المتسلسلة الناتجة عن تنفيذ الكتلة المعطاة مرةً واحدةً لكل عنصر من عناصر الكائن Lazy الذي استدعي معه. drop drop_while enum_for يشبه التابع Kernel.to_enum باستثناء أنه يعيد مُعدِّدًا كسولًا (كائن من النوع Enumerator::Lazy). find_all flat_map يعيد كائن ...

يتحقَّق المعامل == من تساوي كائنين مع بعضهما بعضًا. استُبدِل هذا المعامل في الأصناف السليلة (descendants) لتوفير دلالاتٍ خاصّةٍ بالصنف. البنية العامة obj == other → true or false المعاملات obj الكائن المراد التحقق من تساويه مع الكائن other. other الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن obj. القيم المعادة تُعاد القيمة true إذا كان obj وother هما نفس الكائن، خلاف ذلك تُعاد القيمة false. أمثلة مثالٌ عن استخدام المعامل ==: obj = "a" other = obj.dup obj == other ...

يستدعي المعامل === الكتلة (block) بتمرير الكائن الواقع على يمينه كمعاملٍ للنسخة proc بشكلٍ مشابهٍ للتابع Proc.call. يسمح هذا للكائن proc أن يكون هدفًا للبنود (when clause) في عبارات case. البنية العامة proc === obj → result_of_proc القيم المعادة تُعاد نتيجة تنفيذ الكتلة. انظر أيضًا التابع hash: يحسب قيمة التجزئة الموافقة لجسم الكتلة proc التي استدعيت معه ثمَّ يعيدها. التابع ?lambda: يتحقَّق إذا كانت معالجة الوسائط صارمةً في الكائن Proc. التابع to_proc: يُعدُّ جزءًا من البروتوكول المستخدم في تحويل الكائنات ...

يتحقق المعامل ‎!=‎ من عدم تساوي كائنين. البنية العامة obj != other → true or false القيم المعادة تعاد القيمة true إن لم يكن الكائن obj مساويًا للكائن other، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ‎!=‎: puts 14 != 16 # => true puts 14 != 14 # => false انظر أيضًا المعامل ==: يتحقق‎ من تساوي كائنين. المعامل !‎: يعكس القيمة المنطقية التي تستعمل معه. مصادر قسم ...

يُرمى الاستثناء ConverterNotFoundError من قبل توابع تبديل التّرميز (transcoding) عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ (converter) محدَّد. انظر أيضًا الاستثناء CompatibilityError: يُرمى عندما لا يتوافق التّرميز المصدر مع التّرميز الهدف. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::ConverterNotFoundError في توثيق روبي الرسمي.

يتحقق المعامل !~ من عدم تساوي كائنين (باستخدام التابع =~). البنية العامة obj !~ other → true or false المعاملات obj الكائن المراد التحقق من عدم تساويه مع الكائن other. other الكائن الآخر الذي سيُتحقَق من عدم تساويه مع الكائن obj. القيم المعادة تُعاد القيمة true إذا لم يتساوى الكائنين obj و other، أو تعاد القيمة false خلاف ذلك. انظر أيضًا المعامل <=>: يتحقق من تساوي كائنين بين بعضهما بعضًا. المعامل ===: يتحقق من تساوي كائنين بشكل صارم. المعامل ~=: ...

توابع النسخة العامة write مصادر صفحة الصنف Warning::buffer في توثيق روبي الرسمي.

يُطلَق الخطأ DomainError عند محاولة تقييم دالة رياضية خارج مجال تعريفها. على سبيل المثال، بما أنَّ القيم التي تعيدها الدالة cos تكون في المجال ‏‎-1...1، فإنّ دالتها العكسية acos مُعرفة على ذلك المجال: Math.acos(42) سيعطي عند تنفيذه الناتج التالي: Math::DomainError: Numerical argument is out of domain - "acos" انظر أيضا الصنف Math. مصادر قسم الصنف DomainError في الصنف Math‎ في توثيق روبي الرسمي.

يجري المعامل ^ العملية XOR المنطقية بين القيمة false وقيمة الكائن المعطى. البنية العامة false ^ obj → true or false nil ^ obj → true or false المعاملات obj الكائن الذي ستطبق عليه العملية XOR مع القيمة false. القيم المعادة تُعاد القيمة false عندما تساوي قيمة الكائن obj القيمة nil أو false فقط، أو تعاد القيمة true خلاف ذلك. انظر أيضا المعامل &: يجري العملية AND المنطقية بين القيمة false والكائن المعطى ثم يُعيد القيمة false. المعامل ===: يتحقق من ...

يتحقق المعامل === من تساوي كائنين بشكل صارم. يشبه هذا المعامل فعليًا الاستدعاء ‎#==‎ الخاص بالصنف Object، ولكنه استُبدِل في الأصناف السليلة (descendants) -من ذلك الصنف- لتوفير دلالة واضحة وذات معنى خصوصًا في العبارات case. البنية العامة obj === other → true or false المعاملات obj الكائن المراد التحقق من تساويه مع الكائن other. other الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن obj. القيم المعادة تُعاد القيمة true إذا كان الكائنان متساويين بشكل صارم (أي في القيمة والنوع). خلاف ...

يستدعي المعامل [] الكتلة المرتبطة بالمتغير الذي استعمل معه مُعيِّنًا معاملات الكتلة إلى القيم المعطاة ضمنه باستخدام شيءٍ مشابهٍ لدلالات استدعاء التابع. يُعيد المعامل قيمة آخر تعبيرٍ قُيِّم في الكتلة. a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } } a_proc.call(9, 1, 2, 3) #=> [9, 18, 27] a_proc[9, 1, 2, 3] #=> [9, 18, 27] a_proc.(9, 1, 2, 3) #=> [9, 18, 27] a_proc.yield(9, 1, ...

توابع النسخة العامة pid مصادر صفحة الصنف Process::Waiter في توثيق روبي الرسمي.

يُرمَى الاستنثناء InvalidByteSequenceError من قبل توابع الصّنفين String و Encoding عندما تحوي السّلسلة النّصية التي يجري تحويل ترميزها بايتًا غير صالح إما للتّرميز المصدر أو التّرميز الهدف المراد التحويل إليه. توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد التّرميز الهدف. destination_encoding_name يُعيد اسم الترميز الهدف. error_bytes يعيد البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. ?incomplete_input يتحقّق فيما إذا كان خطأ تسلسل البايت (byte sequence error) الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. readagain_bytes يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع ...

يتحقق المعامل <=> من تساوي كائنين بين بعضهما بعضًا (يشبه المعامل ==). يُستخدَم من قبل عدّة توابعٍ لموازنة كائناتٍ مثل Enumerable.sort، و Enumerable.max، ...الخ. يجب أن يعيد تنفيذ المعامل <=> إحدى القيم التالية: -1، أو 0، أو 1، أو nil. القيمة -1 تعني أنَّ القيمة الأولى الواقعة على يسار المعامل أصغر من القيمة الأخرىالواقعه على يمينه. والقيمة 0 تشير إلى أنَّ القيمتين متساويتان، والقيمة 1 تشير إلى أنَّ القيمة الواقعه على يساره أكبر من القيمة الواقعة على يمينه. أخيرًا، تعني ...

يجري المعامل & العملية AND المنطقية بين القيمة false والكائن المعطى ثم يُعيد القيمة false. يُقيَّم الكائن obj دائمًا كوسيطٍ مُرِّر إلى تابع عند استدعائه. ليس هنالك اختبارٌ لوجود «دارة قصيرة» (short-circuit) في هذه الحالة. البنية العامة false & obj → false nil & obj → false المعاملات obj الكائن الذي سيُجمع منطقيًّا مع false أو nil. القيم المعادة تعاد القيمة false. انظر أيضا المعامل ===: يتحقق من تساوي كائنين بشكل صارم. المعامل ^: يجري العملية XOR المنطقية بين القيمة false ...

يتحقّق المعامل ~= من تطابق نمطي كائنين (Pattern Match). استُبدِل في الأصناف السليلة (descendants، خاصةً الصنفين Regexp و String) لتوفير دلالاتِ مطابقةِ نمطٍ واضحةٍ وذات معنى. البنية العامة obj =~ other → nil المعاملات obj الكائن المراد التحقق من تطابق نمطه مع الكائن other. other الكائن الآخر الذي سيُتحقَق من تطابق نمطه مع الكائن obj. القيم المعادة تُعاد القيمة العدمية nil إذا كان لكل كائن من الكائنين obj و ohter نمطًا مختلفًا. انظر أيضًا المعامل ~!: يتحقق من عدم تساوي ...

يُرمَى الاستثناء UndefinedConversionError من قبل توابع الصّنفين String و Encoding عندما تفشل عملية تبديل التّرميز (transcoding). توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد الترميز الهدف على شكل كائن. destination_encoding_name يُعيد اسم التّرميز الهدف. error_char يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. source_encoding يعيد الترميز المصدر على شكل كائن. لاحظ أنَّ التّرميز المصدري النّاتج قد لا يكون مطابقًا لترميز محوّل الترميز المصدري إذا تمّت عملية التّحويل على عدّة مراحل. source_encoding_name يُعيد اسم الترميز المصدر. مصادر صفحة ...

تتضمن كائنات الصنف File::Stat معلومات حول حالة الكائنات File. تُسجَل هذه المعلومات في الوقت الذي يُنشَأ فيه الكائن File::Stat؛ لذا، لن يُحدَّث هذا الكائن بالحالة الجديدة إن أجري أي تعديل على الملف بعد هذه النقطة من الزمن. تعاد الكائنات File::Stat باستدعاء IO.stat، و File.stat، و File.lstat، و File::stat، و File::lstat. تعيد أغلب هذه التوابع قيمًا تتعلق بالمنصة المستعملة، وليست جميع القيم ذات معنًى في كل أنظمة التشغيل. اطلع على التابع Kernel.test. توابع الصنف العامة new ينشئ كائنًا جديدًا من النوع ...

يُرمى الاستثناء CompatibilityError من قبل توابع الصّنفين String و Encoding عندما لا يتوافق ترميز المصدر مع ترميز الهدف. انظر أيضًا الاستثناء ConverterNotFoundError: يُرمى عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ محدَّد. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::CompatibilityError في توثيق روبي الرسمي.

يُستعمَل الصنف Encoding::Converter في عمليات تحويل الترميز في السلاسل النصية. الثوابت AFTER_OUTPUT يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. CRLF_NEWLINE_DECORATOR يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF. CR_NEWLINE_DECORATOR يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR. INVALID_MASK يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). INVALID_REPLACE يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة. ...

يُرمى الاستثناء CompatibilityError من قبل توابع الصّنفين String و Encoding عندما لا يتوافق ترميز المصدر مع ترميز الهدف. انظر أيضًا الاستثناء ConverterNotFoundError: يُرمى عندما لا يتوافق ترميزٌ باسمٍ معيّنٍ مع محوّلٍ محدَّد. الاستثناء InvalidByteSequenceError: يُرمى عندما تحوي السّلسلة النّصية التي بُدِّل ترميزها على بايت غير صالح إما للتّرميز المصدر أو التّرميز الهدف. الاستثناء UndefinedConversionError: يُرمى عندما تفشل عملية تبديل التّرميز. مصادر صفحة الصنف Encoding::CompatibilityError في توثيق روبي الرسمي.

يُرمَى الاستثناء UndefinedConversionError من قبل توابع الصّنفين String و Encoding عندما تفشل عملية تبديل التّرميز (transcoding). توابع الكائن العامة (Public Instance Methods) destination_encoding يُعيد الترميز الهدف على شكل كائن. destination_encoding_name يُعيد اسم التّرميز الهدف. error_char يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. source_encoding يعيد الترميز المصدر على شكل كائن. لاحظ أنَّ التّرميز المصدري النّاتج قد لا يكون مطابقًا لترميز محوّل الترميز المصدري إذا تمّت عملية التّحويل على عدّة مراحل. source_encoding_name يُعيد اسم الترميز المصدر. مصادر صفحة ...

يتحقق المعامل == من تساوي كائني استثناء مع بعضهما بعضًا. البنية العامة exc == obj → true or false المعاملات exc كائن من النوع Exception يراد التحقق من تساويه مع الكائن obj. obj الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن exc. القيم المعادة تُعاد القيمة false إذا كان الكائن obj ليس كائنًا من النوع Exception. عدا ذلك، تُعاد القيمة true إذا كان الكائنين exc و obj يتشاركان نفس الصّنف، والرسائل، والتَتبُّع العكسي (backtrace). انظر أيضًا التابع new: يُنشئ كائنًا ...

يُستعمَل الصنف Encoding::Converter في عمليات تحويل الترميز في السلاسل النصية. الثوابت AFTER_OUTPUT يوقف الثّابت AFTER_OUTPUT عمليّة التحويل بعد اكتمال جزءٍ من الخَرج (output) ولكن قبل استهلاكِ كلّ المدخلات (input). انتقل إلى صفحة التابع primitive_convert للاطلاع على مثال. CRLF_NEWLINE_DECORATOR يمثّل الثابت CRLF_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CRLF. CR_NEWLINE_DECORATOR يمثّل الثابت CR_NEWLINE_DECORATOR مُزخرِف (decorator) يُحوِّل من LF إلى CR. INVALID_MASK يمثِّل الثابت INVALID_MASK قناعًا (mask) لسلاسل البايت غير الصالحة (invalid byte sequences). INVALID_REPLACE يستبدل الثّابت INVALID_REPLACE سلاسل البايت غير الصالحة. ...

يُطلَق الخطأ DomainError عند محاولة تقييم دالة رياضية خارج مجال تعريفها. على سبيل المثال، بما أنَّ القيم التي تعيدها الدالة cos تكون في المجال ‏‎-1...1، فإنّ دالتها العكسية acos مُعرفة على ذلك المجال: Math.acos(42) سيعطي عند تنفيذه الناتج التالي: Math::DomainError: Numerical argument is out of domain - "acos" انظر أيضا الصنف Math. مصادر قسم الصنف DomainError في الصنف Math‎ في توثيق روبي الرسمي.

المشكلة وجود صنفٍ (class) لا يقوم بأيّ مهمّة فعليّة ولا يُخطَّط لإضافة مهامٍ إليه لاحقًا. الحل نقل كافّة الميّزات (features) من هذا الصنف إلى صنفٍ آخر. مثال قبل إعادة التصميم يحتوي الصنف Person على حقلٍ واحدٍ باسم name وتابعٍٍ للحصول على رقم الهاتف getTelephoneNumber ولاشيء آخر، أمّا الصنف TelephoneNumber فهو يحتوي على حقلين باسم officeAreaCode و officeNumber بالإضافة إلى التابع السابق getTelephoneNumber، كما هو موضَّحٌ في مخطط الأصناف الآتي: الصنف Person يحتوي على حقلٍ واحدٍ باسم name وتابعٍٍ للحصول على ...

المشكلة وجود صنفٍ (class) واحدٍ يقوم بمهامٍ عديدةٍ يمكن توزيعها على صنفين. الحل إنشاء صنفٍ جديدٍ ونقل بعض الحقول (fields) والتوابع (methods) إليه، والتي تتعلَّق بالمهام الوظيفيّة (functionality) لهذا الصنف الجديد. مثال قبل إعادة التصميم يحتوي الصنف Person على عددٍ من الحقول كاسم الشخص (name) ورمز منطقة المكتب (officeAreaCode) ورقمه (officeNumber)، وتابعًا للحصول على هذا الرقم باسم getTelephoneNumber، كما في مخطط الأصناف الآتي: الصنف Person يحتوي على عددٍ من الحقول كاسم الشخص (name) ورمز منطقة المكتب (officeAreaCode) ورقمه (officeNumber)، وتابعًا ...

يُستدعى التابع method_missing من قِبل روبي عندما تُرسَل رسالةٌ إلى كائن لا يستطيع التعامل معها. بشكل افتراضي، يُطلق المفسِّر (interpreter) خطأً عندما يُستدعى هذا التابع. على أي حال، يمكن إعادة تعريف (override) هذا التابع للحصول على سلوك أكثر ديناميكية. إذا تقرر أنه لا يجب التعامل مع تابع معيّن، فيجب حينئذٍ استدعاء super حتى يتسنَّى للأصناف الأجداد (ancestors) الوصول إلى التابع المنشود. البنية العامة method_missing(symbol [, *args] ) → result المعاملات symbol رمزٌ للتابع المُستدعى. args الوسائط التي ستُمرَّر إلى التابع ...

يعدُّ المعامل [] مرجعًا للخاصيات (Attribute Reference)، إذ يُعيد قيمة متغير محلي الليف fiber) local variable، أو الليف الأصلي للمهمة الفرعية الحالية إن لم يكن المتغير موجودًا داخل ليف) باستخدام إما رمز أو سلسلة نصية. إن لم يكن المتغير المعطى (انظر فقرة البنية العامة) موجودًا، فستعاد nil. [ Thread.new { Thread.current["name"] = "A" }, Thread.new { Thread.current[:name] = "B" }, Thread.new { Thread.current["name"] = "C" } ].each do |th| th.join puts "#{th.inspect}: #{th[:name]}" end‎ هذا سوف ينتج: ...

ينفِّذ التابع instance_exec الكتلة البرمجية المُمرَّرة ضمن سياق الكائن المستقبل (obj). لتعيين السياق، يُضبَط المتغير self إلى obj أثناء تنفيذ الشيفرة، مما يعطي الشيفرة إمكانية الوصول لمتغيرات النسخة obj. البنية العامة instance_exec(arg...) {|var...| block } → obj المعاملات arg الوسائط المراد تمريرها كمعاملات إلى الكتلة block. القيم المعادة يعاد كائن يحوي ناتج تنفيذ الكتلة البرمجية block. أمثلة مثال على استخدام التابع instance_exec: class KlassWithSecret def initialize @secret = 99 end end k = KlassWithSecret.new k.instance_exec(5) {|x| @secret+x } #=> ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. نوع الكائن الناتج يتعلق بنوع الطرف الثاني للعملية.  البنية العامة int - numeric → numeric_result‎ المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين int و numeric. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  أمثلة مثال على استخدام المعامل -‎: 20 - 3 #=> 17 6 - 0.4 ...

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

يجري المعامل ‎* عملية الضرب على الأعداد العقدية. البنية العامة cmp * numeric → complex المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية الضرب. numeric عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية الضرب. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن عملية الضرب بين العدد العقدي cmp والعدد numeric. أمثلة أمثلة عن استخدام المعامل *: Complex(2, 3) * Complex(2, 3) #=> (-5+12i) Complex(900) * Complex(1) #=> (900+0i) Complex(-2, 9) * ...

يُستدعى التابع singleton_method_undefined كرد نداءٍ (callback) في كل مرة يكون فيها تابع منفرد (singleton method) غير مُعرَّف (undefined) في المُستقبِل (receiver). البنية العامة singleton_method_undefined(symbol) أمثلة مثال على استخدام التابع singleton_method_undefined: module Chatty def Chatty.singleton_method_undefined(id) puts "Undefining #{id.id2name}" end def Chatty.one() end class << self undef_method(:one) end end يظهر هذا المثال عند تنفيذه المخرجات التالية: Undefining one انظر أيضًا التابع singleton_method_added: يُستَدعى هذا التابع كرد نداءٍ (callback) في كلِّ مرة يُضاف فيها تابع منفرد (singleton method) ...

يتحقق المعامل == من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى. إذا لم يكن الكائن من نوع سلسلة نصية، فيمكن استعمال الدالة to_s لتحويله إلى سلسلة نصية إذا أمكن ذلك. البنية العامة str == obj → true or false المعاملات str سلسلة نصية تمثل الطرف الأول من عملية التحقق. obj الكائن المُراد التحقق من مساواته مع السلسلة النصية str. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية str مساويةً للكائن obj ...

يبدِّل المعامل [] عند استدعائه بالشكل ‎[]=‎‎ سلسلةً نصيةً محدَّدةً مكان جزءٍ محدَّد أو كامل محتوى سلسلة نصية أخرى. البنية العامة str[integer] = new_str str[integer, integer] = new_str str[range] = aString str[regexp] = new_str str[regexp, integer] = new_str str[regexp, name] = new_str str[other_str] = new_str يحدَّد الجزء المراد تبديله من السلسلة النصية str بالطريقة نفسها المذكورة في المعامل []. إن كان طول السلسلة النصية المعطاة لا يطابق طول السلسلة النصية (أو الجزء المحدّد) المراد تبديله، فستُعدَّل السلسلة النصية المعطاة تلك وفقًا لذلك. إن كان التعبير النمطي أو ...

يعيد المعامل ~ مكمل العدد الذي استُدعي معه، إذ يقلب قيمة كل بت من بتات العدد. نظريًا، يُعد طول الأعداد الصحيحة لا نهائيًا، لذلك فإنّ النتيجة تُحسب كما لو كان هناك عدد غير محدود من البتات التي قيمتها واحد إلى اليسار. في التمثيل الست عشري (hex representations)، يتم التعبير عن ذلك بوضع نقطتين إلى يسار الرقم. البنية العامة ~int → integer‎ القيمة المعادة يعاد مكمل العدد الذي استُدعي معه، إذ يقلب قيمة كل بت من بتات العدد. أمثلة ...

يعيد المعامل `` مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell). تُستخدَم الصياغة المضمَّنة ‎%x{...}‎‎ هذا المعامل. تُضبَط حالة العملية (process status) إلى القيمة ‎$?‎‎. البنية العامة `cmd` → string‎ المعاملات cmd يمثل التعليمة المراد تنفيذها. القيمة المعادة يعاد مجرى المخرجات القياسي لتنفيذ تعليمة cmd في صدفة فرعية (subshell). أمثلة مثال على استخدام المعامل ``‎: `date` #=> "Wed Apr ...

يعيد المعامل %‎ باقي عملية القسمة الصحيحة بين عددين. البنية العامة int % other → real المعاملات int عدد صحيح يمثل الطرف الأول في عملية القسمة. other عدد صحيح يمثل الطرف الثاني في عملية القسمة. القيمة المعادة يعاد باقي عملية القسمة الصحيحة للعدد int على other. أمثلة مثال على استخدام المعامل %‎: 20 % 3 #=> 2 6 % 3 #=> 0 انظر أيضا المعامل *: يعيد ناتج ...

يوازن المعامل < بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj > other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة ‎1‎ (أي كان الكائن obj أكبر من الكائن other)، وإلا فستُعَاد القيمة false. أمثلة أمثلة عن استخدام المعامل <: "a" > "f" ; # false "a" > "A" ; # true 3 > 5 ; # false انظر أيضًا المعامل >: يوازن ...

يمثِّل المعامل - الأحادي إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. البنية العامة -num → numeric‎ القيمة المعادة يعاد العدد المعطى بعد ضربه بإشارة الناقص (أي عكس إشارة)؛ فيعاد عدد سالب إن كان العدد المعطى موجبًا والعكس صحيح. انظر أيضا المعامل +: يمثِّل إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. المعامل <=>: يوازن بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. مصادر قسم المعامل -‎ في الصنف ...

يعيد المعامل *‎ ناتج عملية ضرب عدد عشري بعدد آخر. البنية العامة float * other → float  المعاملات float عدد عشري يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية الضرب بين العددين float و other. أمثلة مثال على استخدام المعامل *‎: 20.0 * 3 #=> 60.0 6.0 * 3.4 #=> 20.4 انظر أيضا التابع modulo: يعيد ...

يعيد المعامل /‎ ناتج عملية القسمة بين عددين. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  البنية العامة int / numeric → numeric_result‎ المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. numeric  عدد يمثل الطرف الثاني للعملية. القيمة المُعادة يُعاد ناتج عملية القسمة بين العددين int و numeric. صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية.  أمثلة مثال على استخدام المعامل /‎: 20 / 3 #=> 6 20 / 3.0 ...

يضبط المعامل [] عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسم name إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك. البنية العامة ENV[name] = value يجب أن يكون المعامل name سلسلة نصية. المعاملات name سلسلة نصية تمثِّل اسم متغير البيئة المراد ضبط قيمته. انظر أيضًا التابع []‎: يعيد قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.  التابع store: يضبط قيمة متغير بيئة ذي ...

ينسخ المعامل * سلسلة نصية عددًا محدَّدًا من المرات ثم يضعها في سلسلة نصية جديدة. البنية العامة str * integer → new_str المعاملات str السلسلة النصية المضروبة بالعدد integer لنسخها n مرة. integer عدد صحيح موجب يمثِّل عدد المرات التي يراد فيها نسخ السلسلة النصية str. القيمة المعادة تعاد سلسلة نصية جديدة مؤلفة من integer نسخة من السلسلة النصية str المعطاة. أمثلة مثال على استخدام المعامل *: "Ho! " * 3 #=> "Ho! Ho! Ho! " "Ho! " * ...

يجري المعامل | العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. يعيد القيمة false إن كانت قيمة هذا الكائن هي nil أو false، وإلا فسيعيد القيمة true. البنية العامة false | obj→true or false nil| obj→true or false‎ القيمة المعادة يعيد القيمة false إن كانت قيمة الكائن obj تساوي nil أو false؛ خلا ذلك، تعاد القيمة true. انظر أيضا المعامل &: يجري العملية AND المنطقية على الكائن المعطى والقيمة nil أو false. المعامل ^: يجري العملية XOR المنطقية على الكائن المعطى ...

يزيح المعامل << العدد الصحيح المعطى إلى اليمين بقدار محدَّد من المنازل، أو إلى اليسار إن كانت قيمة مقدار الإزاحة سالبةً. البنية العامة int >> count → integer القيمة المعادة تعاد قيمة العدد int بعد إزاحتها إلى اليمين بمقدار count موضع، أو إلى اليسار إن كان count سالبًا. أمثلة مثال على استخدام المعامل <<: 20 >> 3 #=> 2 20 >> 2 #=> 5 20 >> -2 #=> 80 انظر أيضا المعامل >>: يزيح ...

يعيد المعامل => القيمة true إن كانت قيمة العدد العشري الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه. البنية العامة float <= real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة float أصغر من أو تساوي قيمة real. ملاحظة: نتيجة NaN <= NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل =>: 20.3 <= 3 #=> false 20.30 <= 30 ...

يجمع المعامل + مصفوفتين معًا في مصفوفة واحدة جديدة. البنية العامة ary + other_ary → new_ary القيم المعادة تعاد مصفوفة جديدة تضم المصفوفة ary والمصفوفة other_ary معًا. أمثلة مثالٌ عن استخدام المعامل +: [ 1, 2, 3 ] + [ 4, 5 ] #=> [ 1, 2, 3, 4, 5 ] a = [ "a", "b", "c" ] c = a + [ "d", "e", "f" ] c ...

يوازن المعامل <=> بين توقيتين. البنية العامة time <=> other_time → -1, 0, +1 or nil‎ القيمة المعادة تعاد إحدى القيم ‎-1 أو 0 أو ‎+1 حسب ما إذا كان التوقيت time أصفر من أو يساوي أو أكبر من التوقيت other_time. تعاد القيمة nil إن لم بالإمكان الموازنة بين القيمتين. أمثلة مثال على استخدام المعامل <=>‎: t = Time.now #=> 2007-11-19 08:12:12 -0600 t2 = t + 2592000 #=> 2007-12-19 08:12:12 -0600 t <=> ...

يعيد معامل الموازنة <=> عددً‎ا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كان العدد الواقع على يساره أصغر من أو يساوي أو أكبر من العدد الآخر الواقع على يمينه على التوالي. هذا المعامل هو أساس عمليات الموازنة في الصنف Comparable. إذا كانت القيمتان غير قابلتين للمقارنة، فستُعاد القيمة nil. البنية العامة int <=> numeric → -1, 0, +1, or nil  القيمة المعادة يعاد العدد الصحيح ‎-1 أو 0 أو ‎+1 إذا كان العدد int أصغر من أو يساوي أو أكبر ...

يعد المعامل === معامل تساوي الحالة (Case Equality)، إذ يتحقق من تطابق تعبير نمطي مع سلسلة نصية. ويُستخدم أيضًا في العبارات case. وضع تعبير نمطي حرفي (regular expression literal) عقِب المعامل === يسمح لك بمقارنته مع سلسلة نصية. البنية العامة rxp === str→ true or false‎ القيمة المعادة تعاد القيمة true إن تطابق التعبير النمطي rxp مع السلسلة النصية أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ===‎: a = "HELLO" case a when /\A[a-z]*\z/; print "Lower case\n" when /\A[A-Z]*\z/; ...

يتحقق المعامل == من تساوي عدد جذري مع عدد آخر. البنية العامة rat == object → true or false‎ القيمة المعادة تعاد القيمة true إن كان rat يساوي object عدديًا، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام التابع ==‎: Rational(2, 3) == Rational(2, 3) #=> true Rational(5) == 5 #=> true Rational(0) == 0.0 ...

يوازن المعامل ‎‎‎<=‎ بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver). البنية العامة obj <= other → true or false القيمة المعادة تُعاد القيمة true إن أعاد المعامل <=> القيمة ‎-1‎ أو 0 (أي كان obj أًصغر من أو يساوي الكائن other)، وإلا فسيعيد false. أمثلة أمثلة عن استخدام المعامل =>: "a" <= "a" ; #=> true "a" <= "A" ; #=> false 3 <= 5 ; #=> true انظر أيضًا المعامل ...

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

يتحقق المعامل ‎== من تساوي عددين عقديين. البنية العامة cmp == object → true or false المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية المقارنة. object عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية المقارنة. القيمة المعادة تُعاد القيمة true  إن كان cmp يساوي object عدديًّا، أو تعاد القيمة false خلاف ذلك. أمثلة أمثلة عن استخدام المعامل ==: Complex(2, 3) == Complex(2, 3) #=> true Complex(5) == 5 ...

إن استُعمِل المعامل - بالشكل ‎-Float، فسيعيد القيمة المعاكسة للعدد Float العشري (أي القيمة السالبة إن كان Float موجبًا أو العكس بالعكس). البنية العامة -float → float المعاملات float عدد عشري يراد عكس إشارته. القيمة المعادة يعاد العدد العشري المعاكس للعدد float (أي قيمة موجبة إن كان float سالبًا والعكس صحيح). أمثلة مثال على استخدام المعامل -‎: -(21.0 + 4) #=> -25.0 -(-6.0) #=> 6.0 انظر أيضا ...

يمثِّل المعامل + الأحادي إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. البنية العامة +num → num‎ القيمة المعادة يعاد العدد الذي استُدعي معه. انظر أيضا المعامل -: يمثِّل إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. المعامل <=>: يوازن بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. مصادر قسم المعامل +‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يستدعي التابع __send__ (يدعى أيضًا send) التابع الممرَّر إليه مع تمرير وسائط محددة إليه. يُستعمَل الاسم __send__ الخاص بهذا التابع إذا تعارض الاسم send مع اسم تابع موجود مسبقًا في obj. البنية العامة send(symbol [, args...]) → obj __send__(symbol [, args...]) → obj send(string [, args...]) → obj __send__(string [, args...]) → obj المعاملات symbol اسم التابع المُعرَّف المراد استدعاؤه. ...args الوسائط المراد تمريرها إلى التابع المحدد في المعامل symbol. string سلسلة نصية تمثل اسم التابع المراد استدعاؤه. عندما يُعرّف التابع بواسطة سلسلة ...

يجري المعامل & العملية And المنطقية على الكائن المعطى والقيمة nil أو false. يعيد المعامل القيمة false دائمًا. يُقيَّم هذا الكائن obj المعطى باعتباره دومًا معاملًا يُمرَّر إلى تابع عند استدعائه. ليس هنالك اختبارٌ لوجود «دارة قصيرة» (short-circuit) في هذه الحالة. البنية العامة false & obj→ false nil & obj → false‎ القيمة المعادة تعاد القيمة false دومًا مهما كانت قيمة الكائن obj. انظر أيضا المعاملor: يجري العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. المعامل ^: يجري العملية ...

يعيد المعامل ‎<=‎ القيمة true إن كانت الوحدة Module التي تقع على يساره صنفًا فرعيًّا من الوحدة التي تقع على يمينه أو كانت الوحدتان متساويتين تمامًا، أو يعيد القيمة nil إذا لم تكن بينهما أية علاقة (فكر في هذه العلاقة من منظور تعريف الأصناف: "الصنف A < الصنفB" يستلزم "A < B"). البنية العامة mod <= other→ true, false, or nil‎ القيمة المعادة تعاد القيمة true إن كان mod صنفًا فرعيًا من other أو كان يساويه، أو تعاد القيمة nil ...

يعيد المعامل < القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من قيمة العدد الآخر الواقع على يمينه. البنية العامة float > real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة float أكبر من قيمة real، وإلا فستعاد false. ملاحظة: نتيجة NaN > NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل <: 30.0 > 3 #=> true 20.0 > 30 ...

يوازن المعامل <=> بين عددين ثمَّ يعيد القيمة 0 إن كان هذان العددان متساويين، وإلا فسيُعيد القيمة nil. البنية العامة number <=> other → 0 or nil‎ القيمة المعادة تعاد القيمة 0 إن كان number يساوي other، وإلا فستُعاد القيمة nil. انظر أيضا المعامل +: يمثِّل إشارة الزائد التي تسبق العدد لتشير إلى أنه عدد موجب. المعامل -: يمثِّل إشارة الناقص التي تسبق العدد لتشير إلى أنه عدد سالب. التابع eql?‎: يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه ...

يعيد التابع ‎__id__‎‎ (يدعى أيضًا object_id) مُعرِّفا عدديًا للكائن الذي استُدعي معه. سيُعاد نفس المعرِّف في كل مرة يُستدعى فيها التابع object_id مع الكائن نفسه، ولن يتشارك أي كائنين نشطين نفس المعرِّف. ملاحظة: يعاد استخدام بعض كائنات الأصناف المٌضمّنة (builtin classes) وذلك لتحسين الأداء. هذا هو الحال بالنسبة للقيم المباشرة (immediate values) والسلاسل النصية الحرفية المجمدة (frozen string literals). لا تُمرَّر القيم المباشرة بالمرجع (reference) ولكنَّها تُمرَّر بالقيمة، مثل nil، و true، و false، و Fixnums، و Symbols، و Floats. ...

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

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

يعيد التابع ENV[]‎ قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا. البنية العامة ENV[name] → value المعاملات name اسم متغير البيئة المراد جلب قيمته. القيمة المعادة تُعاد سلسلة نصي تمثِّل قيمة متغير البيئة name، أو تعاد القيمة nil في حال لم يكن المتغير ذو الاسم name موجودًا. انظر أيضًا المعامل []: يضبط عندما يُستعمَل بالشكل ENV[name] = value‎ قيمة متغير البيئة ذي الاسم name إلى القيمة value. التابع store: يضبط قيمة ...

يُلحق المعامل >> الكائن المُعطى بالسلسلة النصية. في حال كان هذا الكائن عددًا صحيحًا، فإنه يُعتبر نقطة ترميز (codepoint) ويُحول إلى المحرف المقابل له قبل أن يضاف إلى السلسلة النصية. البنية العامة str << obj → str str << integer → str القيمة المعادة تعاد السلسلة النصية str مضافًا إليها الكائن obj أو العدد integer الصحيح بعد تحويله إلى المحرف المقابل له. أمثلة مثال على استخدام المعامل >>: a = "hello " a << "world" #=> "hello world" a << 33 ...

يربط المعامل [] عند استدعائه بالشكل hsh[key] = value القيمة value المعطاة بالمفتاح key في الجدول Hash. البنية العامة hsh[key] = value → value المعاملات key المفتاح الذي يراد ربط القيمة value المعطاة به. القيمة المعادة تعاد القيمة value نفسها بعد ربطها بالمفتاح key. أمثلة مثال على استعمال المعامل []: h = { "a" => 100, "b" => 200 } h["a"] = 9 h["c"] = 4 h #=> {"a"=>9, "b"=>200, "c"=>4} h.store("d", 42) #=> 42 h #=> {"a"=>9, "b"=>200, "c"=>4, "d"=>42} انتبه إلى ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. البنية العامة float - other → float المعاملات float عدد صحيح يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين float و other.  أمثلة مثال على استخدام المعامل -‎: 20.0 - 3 #=> 17.0 6.0 - 0.4 #=> 5.6 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: ...

يزيح المعامل >> العدد الصحيح المعطى إلى اليسار بقدار محدَّد من المنازل، أو إلى اليمين إن كانت قيمة مقدار الإزاحة سالبةً. البنية العامة int << count → integer القيمة المعادة تعاد قيمة العدد int بعد إزاحتها إلى اليسار بمقدار count موضع، أو إلى اليمين إن كان count سالبًا. أمثلة مثال على استخدام المعامل >>: 20 << 3 #=> 32 20 << 2 #=> 16 20 << -2 #=> ...

يجري المعامل ^ العملية XOR المنطقية على الكائن المعطى والقيمة nil أو false. إن كانت قيمة هذا الكائن هي nil أو false، فستُعاد القيمة false؛ خلاف ذلك، ستُعاد القيمة true. البنية العامة false ^ obj → true or false nil^ obj → true or false‎ القيمة المعادة إن كانت قيمة الكائن obj تساوي nil أو false، فستُعاد القيمة false؛ خلا ذلك، ستُعاد القيمة true. انظر أيضا المعامل &: يجري العملية AND المنطقية على الكائن المعطى والقيمة nil أو false. المعاملor: يجري العملية ...

يجري المعامل ‎- عملية الطرح بين عددين عقديين. البنية العامة cmp - numeric → complex المعاملات cmp عدد عقدي يمثِّل الطرف الأول في عملية الطرح. numeric عدد عقدي أو غير عقدي يمثِّل الطرف الثاني في عملية الطرح. القيمة المعادة يعاد عددٌ عقديٌ ناتج عن طرح العددين cmp و numeric. أمثلة أمثلة عن استخدام المعامل -: Complex(2, 3) - Complex(2, 3) #=> (0+0i) Complex(900) - Complex(1) #=> (899+0i) Complex(-2, 9) - Complex(-9, 2) ...

يعيد المعامل -‎ ناتج عملية الطرح بين عددين. البنية العامة float - other → float المعاملات float عدد صحيح يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يُعاد ناتج عملية الطرح بين العددين float و other.  أمثلة مثال على استخدام المعامل -‎: 20.0 - 3 #=> 17.0 6.0 - 0.4 #=> 5.6 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: ...

يتحقق المعامل == من تساوي تعبيران نمطيان. تتحقق عملية التساوي من كون نمطاهما (patterns) متطابقين، وكان لهما نفس رمز مجموعة الحروف (character set code)، وكانت لهما نفس القيمة casefold?‎. البنية العامة rxp == other_rxp→ true or false‎ القيمة المعادة تُعاد القيمة true في حال كان التعبيران النمطيان متساويان، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام المعامل ==‎: /abc/ == /abc/x #=> false /abc/ == /abc/i #=> false /abc/ == /abc/u #=> false /abc/u ...

يعيد المعامل **‎ ناتج عملية رفع للعدد int الأساس إلى قوة العدد numeric (الأس). النتيجة يمكن أن تكون من النوع Integer أو Float أو Rational أو Complex. البنية العامة int ** numeric → numeric_result المعاملات int عدد صحيح يمثل الطرف الأول (الأساس) في للعملية. numeric عدد يمثل الطرف الثاني (الأس) للعملية. يمكن أن يكون هذا العدد سالبا أو كسريًا. القيمة المعادة يعاد ناتج عملية رفع المعامل int إلى قوة المعامل numeric. النتيجة يمكن أن تكون من النوع Integer أو Float أو Rational ...

يقدِّر (Evaluates) التابع instance_eval‎ ناتج تنفيذ شيفرة مصدرية للغة روبي معطاة كسلسلة نصية أو ناتج كتلة برمجية (block) مُمرَّرة ضمن سياق كائن مُستقبِل (obj). لتعيين السياق، يُضبَط المتغير self إلى obj أثناء تنفيذ الشيفرة، مما يعطي الشيفرة إمكانية الوصول لمتغيرات النسخة obj والتوابع الخاصة. عندما يُمرَّر إلى التابع instance_eval كتلة برمجية، يُمرَّر obj أيضاً كوسيط وحيد للكتلة. البنية العامة instance_eval(string [, filename [, lineno]] ) → obj instance_eval {|obj| block } → obj عندما يُمرَّر إلى التابع instance_eval سلسلة نصية، يوفر ...

يعيد المعامل **‎ ناتج عملية رفع عدد عشري (الأساس) إلى قوة عدد محدد (الأس). البنية العامة float ** other → float المعاملات float عدد عشري يمثل الطرف الأول (الأساس) في للعملية. other عدد يمثل الطرف الثاني (الأس) للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية رفع المعامل float إلى قوة المعامل other. أمثلة مثال على استخدام التابع **‎: 2.0**3 #=> 8.0 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. التابع modulo: يعيد باقي عملية القسمة بين عدد عشري وعدد آخر. مصادر ...

يتحقق المعامل === من تساوي كائن مع كائن آخر. بالنسبة للصنف Object هذا المعامل مكافئ أساسًا لاستدعاء المعامل ‎==‎، ولكن عادةً ما يعاد تعريفه من قبل الأصناف المنحدرة منه (descendants) لاستخدامه مع العبارات case. البنية العامة obj === other→ true or false‎ القيمة المعادة تعاد القيمة false إن كان obj يساوي الكائن other، أو تعاد القيمة true خلاف ذلك. انظر أيضًا المعامل &: يجري العملية AND المنطقية على القيمة true وقيمة الكائن المعطى، ويُعيد القيمة false إن كان الكائن يساوي nil ...

يتحقق المعامل === إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى (انظر فقرة البنية العامة) متساويين. البنية العامة system_call_error === other → true or false‎ القيمة المعادة تعاد القيمة true إن كان الاستثناء system_call_error كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء other متساويين. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع new: ينشئ الصنف Errno المناسب لرمز خطإٍ نظامي معروف ...

يُعيد المعامل - الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى. البنية العامة time - other_time → float time - numeric → time‎ القيمة المعادة يعاد عدد عشري يمثِّل عدد الثواني الناتجة عن طرح التوقيت time من التوقيت other_time (أي الفرق بينهما)، أو يطرح العدد numeric (بواحدة الثانية) من التوقيت time. أمثلة مثال على استخدام المعامل -‎: t = Time.now #=> 2007-11-19 08:23:10 -0600 t2 = t + 2592000 #=> ...

ينفذ المعامل * عملية الضرب. البنية العامة rat * numeric → numeric‎ ‎القيمة المعادة يعيد ناتج عملية الضرب بين العدد الجذري rat وبين العدد numeric. أمثلة مثال على استخدام التابع *‎: Rational(2, 3) * Rational(2, 3) #=> (4/9) Rational(900) * Rational(1) #=> (900/1) Rational(-2, 9) * Rational(-9, 2) #=> (1/1) Rational(9, 8) * 4 #=> ...

يعيد المعامل =< القيمة true إن كانت قيمة العدد العشري الواقع على يساره أكبر من أو تساوي قيمة العدد الآخر الواقع على يمينه. البنية العامة float >= real → true or false القيمة المعادة يعاد القيمة true إن كانت قيمة float أكبر من أو تساوي قيمة real، وإلا فستعاد القيمة false. ملاحظة: نتيجة NaN >= NaN غير مُعرَّفة، لذا تُعاد قيمة تعتمد على التنفيذ. أمثلة مثال على استخدام المعامل =<: 20.0 >= 3 #=> true 20.0 >= ...

يعيد المعامل - عند استدعائه بالشكل str- نسخةً مطابقةً ومجمدةً للسلسلة النصية str في حال كانت غير مجمدة. أما إذا كانت مجمدة، فسيعيد التابع السلسلة النصية نفسها. البنية العامة -str → str (frozen) القيمة المعادة تُعاد نسخة مطابقة ومجمدة من السلسلة النصية str إن كانت هذه السلسلة غير مجمدة، أو تُعاد السلسلة النصية نفسها إن كانت مجمدة. أمثلة مثال على استعمال المعامل -: n1= “Hello” n1<<”World” #=> “HelloWorld” n2= -n1 n2<<”Guys” #=> FrozenError (can't modify frozen String) انظر أيضًا ...

يتحقق المعامل == من تساوي كائنين من الصنف Encoding::Converter مع بعضهما بعضًا. البنية العامة ec == other → true or false المعاملات ec كائن من الصنف Encoding::Converter يراد التحقق من تساويه مع الكائن الآخر other. other الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن ec. القيم المعادة تُعاد القيمة false إذا كان الكائن other ليس كائنًا من الصنف Encoding::Converter. عدا ذلك، تُعاد القيمة true إذا كان الكائنين ec و other يتشاركان نفس الصّنف. انظر أيضًا التابع new: يُنشئ كائنًا جديدًا ...

يطبِّق المعامل % السلسلة النصية الواقعة على يساره التي تعد سلسلة تنسيق معيارية على الكائن المعطى الواقع على يمينه ثم يعيد الناتج. إن حوت سلسلة التنسيق أكثر من من عنصر نائب، فيجب أنذاك أن يكون الكائن الذي ستطبق عليه مصفوفةً أو كائنًا من النوع Hash يحوي القيم التي ستأخذ مكان العناصر النائبة المقابلة. البنية العامة str % arg → new_str المعاملات str سلسلة التنسيق التي ستُطبَّق على محتوى المعامل arg. لمزيد من التفاصيل حول صياغة سلسلة التنسيق، اطلع على صفحة ...

يتحقق المعامل == من تساوي مجالين مع بعضهما بعضًا. يكون مجالان متساويين إن كان كل منهما من النوع Range وكان لهما نفس عنصري البداية والنهاية (بمقارنتهما بالمعامل ==)، وكان لهما أيضًا نفس الضبط exclude_end?‎. البنية العامة rng == obj → true or false‎ القيمة المعاد تعاد القيمة true إن كان الكائن obj من النوع Range ومساويًا للمجال rng. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع ==‎: (0..2) == (0..2) ...

يتحقق المعامل == من تساوي كائنين من النوع UnboundMethod. يكون كائنان من النوع UnboundMethod متساويين إن كانا مرتبطين بنفس الكائن، وكانا يشيران إلى نفس تعريف التابع، وكان لهما نفس الصنف أو الوحدة المالكة. البنية العامة meth == other_meth → true or false‎ القيمة المعادة تعاد القيمة true إن كان الكائنان meth و other_meth متساويين، أو تعاد القيمة false خلاف ذلك. انظر أيضًا التابع eql?‎: يتحقق من تساوي تابعين غير مربوطين. مصادر قسم المعامل ==‎ في الصنف UnboundMethod‎ في توثيق ...

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

يعيد المعامل => القيمة true إن كانت قيمة العدد الواقع على يساره أصغر من أو تساوي قيمة العدد الواقع على يمينه. البنية العامة int <= real → true or false القيمة المعادة تعاد القيمة true إن كانت قيمة int أصغر من أو تساوي قيمة real. أمثلة مثال على استخدام المعامل =>: 20 <= 3 #=> false 20 <= 30 #=> true 3 <= 3 #=> true انظر أيضا المعامل >>: ...

يضيف المعامل + عددًا من الثواني (ربما يكون عدد كسري) إلى التوقيت المعطى، ثم يُعيد تلك القيمة كتوقيت جديد. البنية العامة time + numeric → time‎ القيمة المعادة يعاد توقيتٌ جديدٌ ناتج عن جمع التوقيت time مع العدد numeric. أمثلة مثال على استخدام التابع +‎: t = Time.now #=> 2007-11-19 08:22:21 -0600 t + (60 * 60 * 24) #=> 2007-11-20 08:22:21 -0600‎ انظر أيضًا المعامل -: يُعيد الفرق بالثانية بين وقتين، ...

يضيف المعامل >> كائنات إلى الطابور المعطى. يعمل هذا المعامل بشكل مشابه للتابع push. البنية العامة <<(*args) المعاملات args الكائنات المراد إضافتها إلى الطابور. انظر أيضا التابع clear: يزيل كل الكائنات من الطابور. التابع push: يضيف عنصرًا إلى الطابور. مصادر قسم المعامل ‎<<‎ في الصنف SizedQueue‎ في توثيق روبي الرسمي.

يستدعي المعامل === كتلة التابع مع تمرير الكائن الواقع على يمينه كوسيط إلى المعامل الواقع على يساره كما هو الحال في Proc.call. هذا يَسمح لكائنٍ من النوع proc أن يكون هدفًا للكتلة when في التعليمة case. البنية العامة proc === obj→ result_of_proc‎ القيمة المعادة تعاد نتيجة الوسيط proc. انظر أيضا التابع ==: يتحقق من تساوي كائنين من النوع Method. مصادر قسم التابع ===‎ في الصنف Method‎ في توثيق روبي الرسمي.

إن استُعمِل المعامل - بالشكل ‎-int‎‎، فسيعيد القيمة المعاكسة للعدد int‎‎ الصحيح الموجب (أي القيمة السالبة إن كان int موجبًا أو العكس). البنية العامة -int → integer‎ المعاملات int عدد صحيح. القيمة المعادة يعاد العدد الصحيح المعاكس للعدد int‎‎ (أي قيمة موجبة إن كان int سالبًا والعكس صحيح). أمثلة مثال على استخدام المعامل -‎: -(21 + 4) #=> -25 -(-6) #=> 6 انظر أيضا المعامل -: يعيد ناتج ...

يضبط المعامل [] عند استدعائه بالشكل struct[member/index] = obj قيمة عضو البنية member المعطى أو العضو الموجود عند الفهرس index إلى القيمة obj. يطلق الاستثناء NameError إن كان member غير موجود، أو الاستثناء IndexError إن كان index خارج النطاق. البنية العامة struct[member] = obj → obj struct[index] = obj → obj‎ المعاملات member اسم العضو المراد تعيين قيمته. index فهرس العضو المراد تعيين قيمته. القيمة المعادة تعاد القيمة obj المُعيّنة. أمثلة مثال على استخدام المعامل ‎[]=‎: Customer = Struct.new(:name, :address, ...

يعيد المعامل + ناتج عملية الجمع بين عددين. البنية العامة float + other → float المعاملات float عدد عشري يمثل الطرف الأول في للعملية. other عدد يمثل الطرف الثاني للعملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية الجمع بين العددين float و other.  أمثلة مثال على استخدام المعامل +‎: 20.0 + 3 #=> 23.0 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. التابع modulo: يعيد باقي عملية القسمة بين عدد عشري ...

يعيد التابع &‎ ناتج عملية AND على بتات (bits) طرفي العملية. البنية العامة int & other_int → integer  المعاملات int عدد صحيح يمثل الطرف الأول في للعملية. other عدد صحيح يمثل الطرف الثاني للعملية. القيمة المُعادة يعيد التابع &‎ ناتج عملية AND على بتات (bits) طرفي العملية other و int. انظر أيضا التابع modulo: يعيد المعامل %‎ باقي عملية القسمة الصحيحة. التابع *: يعيد التابع *‎ ناتج عملية الضرب بين عددين. مصادر قسم التابع &‎ في الصنف Integer في توثيق ...

يعيد المعامل [] ناتج التعبير sym.to_s[]‎. البنية العامة sym[idx]→ char sym[b, n] → string‎ القيمة المعادة يعاد ناتج التعبير sym.to_s[]‎. انظر أيضا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل ‎=~‎: يعيد ناتج التعبير sym.to_s =~ obj. مصادر قسم المعامل []‎ في الصنف Symbol‎ في توثيق روبي الرسمي

ينفذ المعامل | العملية OR بين بتات العددين المعطيين. البنية العامة int | other_int → integer‎ القيمة المعادة يعاد ناتج تنفيذ العملية OR بين بين العدد int الصحيح والعدد other_int الصحيح. أمثلة مثال على استخدام المعامل |: 20 | 3 #=> 23 25 | 2 #=> 27 انظر أيضا المعامل ^: ينفذ العملية XOR بين بتات العددين المعطيين. المعامل &: ينفذ العملية AND بين بتات العددين المعطيين. مصادر قسم المعامل|‎في الصنف Integer‎ ...

يعيد المعامل == القيمة true إن كان العدد الصحيح الواقع على يساره يساوي القيمة الواقعة على يمينه. على خلاف التابع Numeric.eql?‎ الذي يشترط أن يكون القيمة الثانية الواقعة على يمين المعامل من النوع Integer أيضًا. البنية العامة int == other → true or false القيمة المعادة تعاد القيمة true إن كان العدد الصحيح int يساوي القيمة other عدديًا. أمثلة مثال على استخدام المعامل ==: 20 == 20 #=> true 20 == 30 #=> ...