نتائج البحث

يعيد التابع key المفتاح الذي تسبب في رمي الاستثناء KeyError. البنية العامة key → object‎ القيمة المعادة يعاد المفتاح الذي تسبب في رمي الاستثناء KeyError. انظر أيضا التابع receiver: يعيد المستقبل (receiver) المقترن بالاستثناء KeyError. مصادر قسم التابع key‎ في الصنف KeyError‎ في توثيق روبي الرسمي.

يحول التابع match?‎ النمط المُمرَّر إليه إلى تعبير نمطي (إن لم يكن كذلك) ثم يتحقق من مطابقته من السلسلة النصية التي استدعي معها دون تحديث قيمة المتغير ~$ والمتغيرات الأخرى المماثلة. البنية العامة match?(pattern) → true or false match?(pattern, pos) → true or false المعاملات pattern التعبير النمطي المراد مطابقته للسلسلة النصية المعطاة. إن يكن تعبيرًا نمطيًّا، فسيُحوَّل النمط المعطى إلى تعبير نمطي. pos إن أعطي هذا المعامل الاختياري، فسيُحدِّد موضع بدء عملية المطابقة في السلسلة النصية المعطاة. القيمة المعادة تعاد القيمة ...

يضبط التّابع set_backtrace معلومات المصفوفة backtrace الخاصة بكائن الاستثناء. مصفوفة التتبع العكسي (backtrace) يجب أن تتكون من عدة سلاسل نصية أو سلسلة نصية واحدة بالتنسيق الموصوف في التابع backtrace. البنية العامة set_backtrace(backtrace) → array المعاملات backtrace المحتوى الجديد لمصفوفة التتبع العكسي الذي يراد تعيينه. القيم المعادة تُعاد مصفوفة backtrace جديدة بعد ضبط محتواها إلى backtrace. انظر أيضا التابع backtrace: يُعيد أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء. التابع backtrace_locations: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء. مصادر صفحة التابع set_backtrace في ...

ينشئ التابع new الصنف Errno المناسب لرمز خطإٍ نظامي معروف إن كان رقم الخطأ المُمرَّر إليه يطابق رمز هذا خطأ، وإلا فسينشئ كائنًا عامًا من النوع SystemCallError. رقم الخطأ سيكون متاح لاحقًا عبر التابع errno. البنية العامة new(msg, errno) → system_call_error_subclass‎ المعاملات msg‎ رسالة الخطأ. errno‎ رقم الخطأ. القيمة المعادة يعاد كائنٌ جديد من النوع SystemCallError أو صنف متفرع منه. انظر أيضا التابع ===: يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ ...

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

يشبه التابع open التابع new تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن File) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة. البنية العامة open(filename, mode="r" [, opt]) → file open(filename [, mode [, perm]] [, opt]) → file open(filename, mode="r" [, opt]) {|file| block } → obj open(filename [, mode [, perm]] [, opt]) {|file| block } → obj عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. اطلع على صفحة التابع new ...

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

يعيد التابع pred‎ العدد السابق على العدد الذي استُدعي معه. أي يعيد القيمة int-1. البنية العامة pred → integer‎ القيمة المعادة يعاد العدد السابق على العدد الذي استُدعي معه. أمثلة مثال على استخدام التابع pred‎: 1.pred #=> 0 (-1).pred #=> -2 ‎ انظر أيضا التابع next: يعيد العدد الموالي للعدد الذي استُدعي معه. مصادر قسم التابع pred‎ في الصنف Integer‎ في توثيق روبي الرسمي.

يستخلص التابع year من التوقيت الذي استُدعي معه قيمة السنة (بما في ذلك القرن). البنية العامة year → integer‎ القيمة المعادة يعاد عدد صحيح يمثل السنة. أمثلة مثال على استخدام التابع year‎: t = Time.now #=> 2007-11-19 08:27:51 -0600 t.year #=> 2007‎ انظر أيضًا التابع wday: يُعيد عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي استدعي معه. التابع yday: يُعيد عددًا صحيحًا يمثل يومًا من السنة الحالية للتوقيت الذي استدعي معه. التابع sec: يستخلص ...

يُعيد التّابع full_message سلسلةً نصيةً منسّقةً من الاستثناء. تُنسّق السلسلة النصية المعادة بنفس التنسيق التي تستعمله روبي عند طبع الاستثناءات uncaught على مجرى الخطأ القياسي (stderr). البنية العامة full_message(highlight: bool, order: [:top or :bottom]) → string المعاملات highlight قيمة منطقية؛ إن كانت true، فسيُرسل معالج الخطأ الافتراضي رسالةً إلى الطرفية tty. القيمة الافتراضية لهذا المعامل تعتمد على ‎$stderr وعلى القيمة التي يعيدها التابع tty?‎ في وقت الاستدعاء. order يحدد كيفية ترتيب الناتج المعاد ويكون إما top: أو bottom:، وتوضع رسالة ...

يتحقق التابع locked?‎ إن كان هذا القفل مُطبَّق حاليًا من قبل خيط (thread) ما. البنية العامة locked? → true or false‎ القيمة المعادة تعاد القيمة true إن كان هذا القفل مُطبَّق حاليًا من قبل خيط (thread) ما، وإلا فستعاد القيمة false. انظر أيضا التابع lock: يحاول مسك القفل (grab the lock)، وينتظر إذا لم يكن متاحًا. التابع owned?‎: يتحقق إن كان هذا القفل مُطبَّق حاليًا من قبل الخيط (thread) الحالي. مصادر قسم التابع locked?‎ في الصنف Mutex‎ في توثيق روبي الرسمي.

يزيل التابع clear جميع الأزواج قيمة-مفتاح من الكائن Hash الذي استدعي معه. البنية العامة clear → hsh القيمة المعادة يعاد الكائن Hash المعطة نفسه بعد إزالة جميع الأزواج قيمة-مفتاح منه. أمثلة مثال على استعمال التابع clear: h = { "a" => 100, "b" => 200 } #=> {"a"=>100, "b"=>200} h.clear #=> {} انظر أيضا التابع compact!‎: ...

يُحصِي التابع count_objects جميع الكائنات التي من نوعٍ واحد. من المتوقع أن يعمل هذا التابع على C Ruby فقط. البنية العامة count_objects([result_hash]) → hash المعاملات result_hash إذا أُعطي الوسيط الاختياري result_hash، فسيُستبدَل (overwritten) الناتج ويعدَّل قبل إعادته ثمَّ يُعاد. الهدف من استعمال هذا المعامل هو تفادي تأثير الاختبار (probe effect). القيم المعادة تُعاد تجزئةٌ (hash) مثل: { :TOTAL=>10000, :FREE=>3011, :T_OBJECT=>6, :T_CLASS=>404, # ... } تتبع هذه المحتويات طريقة التنفيذ، لذلك قد تتغيَّر في المستقبل. المفاتيح التي تبدأ ...

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

يجلب التابع each_pair‎ الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة. في حال عدم تمرير كتلة برمجية إلى التابع، فسيُعيد كائنًا من النوع Enumerator. البنية العامة each_pair { |name, value| } → Hash each_pair → Enumerator القيمة المعادة يعاد كائن من النوع Hash بعد تمرير الزوج اسم/قيمة لكل متغير من متغيرات البيئة إلى الكتلة المعطاة على حدة، أو يعاد كائن من النوع Enumerator في حال عدم تمرير أي كتلة برمجية. انظر أيضًا التابع each‎: يجلب أسماء ...

تُعرَّف الوحدة UnicodeNormalize هنا حتى لا نضطر للبحث عنها. مصادر صفحة الوحدة UnicodeNormalize في توثيق روبي الرسمي.

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

يعيد التابع external_encoding الترميز الخارجي (external encoding) للملفات المقروءة من ARGF على شكل كائن من النوع Encoding. الترميز الخارجي هو الترميز الذي كُتِب به النص وخُزِّن في الملف. إن وازنَّا هذا التابع مع التابع ARGF.internal_encoding، نجد أنَّ الأخير يعيد الترميز المستخدم لتمثيل هذا النص ضمن روبي. لضبط الترميز الخارجي، استخدم التابع ARGF.set_encoding. البنية العامة external_encoding → encoding القيم المعادة يعاد كائن من النوع Encoding يمثِّل الترميز الخارجي المستعمل في كتابة محتوى الملف المقروء من المجرى ARGF. أمثلة مثال على ...

يحذف التابع uniq!‎ العناصر المتكررة من مصفوفة. إن مرِّرت كتلة برمجية، فستُستخدَم القيمة التي تعيدها هذه الكتلة لكل عنصر في عملية الموازنة. يوازن التابع uniq!‎ القيم باستخدام التابع hash والتابع eql?‎ لأجل تحسين الأداء. كما يقتطع التابع العناصر المتكررة من مصفوفة بالترتيب، إذ يحتفظ بالظهور الأول للقيمة المتكررة ويحذف القيمة الأخرى المتماثلة. البنية العامة uniq! → ary or nil uniq! { |item| ... } → ary or nil القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزالة العناصر المتكررة منها، أو تعاد ...

يحذف التابع shift أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة. إن مرِّر عدد n كوسيط إلى التابع shift، فسيحذف أول n عنصر من المصفوفة ثمَّ يعيدها في مصفوفة جديدة وهذا مشابه تمامًا لاستدعاء التابع slice!‎ بالشكل: array.slice!(0, n)‎. ستحتوي المصفوفة الأصلية حينئذٍ العناصر المتبقية فقط دون العناصر التي أزيحت ووُضعت في المصفوفة الجديدة المُعادة. البنية العامة shift → obj or nil shift(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر ...

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

يتحقق التابع alive?‎ إن كانت المهمة الفرعية التي استُدعي معها قيد التشغيل أو نائمة. البنية العامة alive?→ true or false‎ القيمة المعادة تعاد القيمة true إن كانت المهمة الفرعية المعطاة قيد التشغيل أو نائمة، وإلا فستعاد القيمة false. أمثلة مثال على استخدام التابع alive?‎: thr = Thread.new { } thr.join #=> #<Thread:0x401b3fb0 dead> Thread.current.alive? #=> true thr.alive? ...

يجمع التابع sum عناصر المصفوفة التي استُدعيت معه مع بعضها بعضًا. إن مُرِّرت كتلة برمجية إلى هذا التابع، فستُطبَّق تلك الكتلة على كل عنصر من عناصر المصفوفة ثم ستُجمَع النواتج المعادة لجميع العناصر. في حال كانت المصفوفة فارغة، ستُعاد القيمة المُمرّرة إلى هذا التابع. يمكن استخدام هذا التابع مع المصفوفات التي تحوي قيمًا غير عددية بتحديد قيمة مناسبة للوسيط init. يجدر التنبيه إلى أنّ التابعين join و flatten هما أسرع من التابع sum بالنسبة للمصفوفات التي تضم سلاسل نصية أو ...

يتحقق التابع ?empty فيما إذا كان المجلد المعطى فارغًا. البنية العامة empty?(path_name) → true or false المعاملات string يحتوي عنوان المجلد المراد التحقق منه. القيمة المعادة ستُعاد القيمة true في حال كان المجلد string المعطى فارغًا، وإلا فستعاد القيمة false. انظر أيضًا التابع ?exist: يتحقق فيما إذا كان الملف المعطى مجلدًا موجودًا.  مصادر قسم التابع ?empty في الصنف Dir في توثيق روبي الرسمي.

يعيد التابع length عدد العناصر المتطابقة في مجموعة المُطابقة. البنية العامة length→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل عدد العناصر في مجموعة المُطابقة. أمثلة مثال على استخدام التابع length‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.length #=> 5 m.size #=> 5‎ انظر أيضا التابع inspect: يعيد نسخة قابلة للطباعة من الكائن الذي استدعي معه. مصادر قسم التابع length‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يُرتِّب التابع sort_by!‎ المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة. لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. في حال عدم تمرير كتلة برمجية إلى التابع sort_by!‎، سيعيد كائنًا من النوع Enumerator. البنية العامة sort_by! { |obj| block } → ary sort_by! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها وفقًا للقيمة التي تعيدها ...

يعيد التابع sqrt‎ الجذر التربيعي الصحيح للعدد الصحيح الموجب المُمرر إليه. يكافئ التابع sqrt‎ الاستدعاء Math.sqrt(n).floor باستثناء أنّ نتيجة الاستدعاء الأخير قد تكون مختلفة عن القيمة الصحيحة بسبب محدودية الدقة في العمليات الحسابية التي تُجرى على الأعداد العشرية (floating point arithmetic). Integer.sqrt(10**46) #=> 100000000000000000000000 Math.sqrt(10**46).floor #=> 99999999999999991611392 (!) البنية العامة sqrt(n) → integer إن لم يكن العدد المُعطى صحيحًا، فسيُحوّل أولًا إلى عدد صحيح، أما إن كان سالبًا فسيُطلق الخطأ Math::DomainError. المعاملات n عدد صحيح ...

يعيد التابع abs القيمة المطلقة للعدد الجذري الذي استدعي معه. يملك هذا التابع اسمًا بديلًا هو magnitude. البنية العامة abs → rational‎ القيمة المعادة تعاد القيمة المطلقة للعدد الجذري المعطى. أمثلة مثال على استخدام التابع abs‎: (1/2r).abs #=> (1/2) (-1/2r).abs #=> (1/2)‎ انظر أيضًا التابع ceil: يعيد أصغر عدد من الأعداد الأكبر من أو تساوي العدد الجذري الذي استٌدعي معه. مصادر قسم التابع abs‎ في الصنف Rational‎ في توثيق روبي الرسمي.

يتحقق التابع closed?‎ إن كان مجرى د/خ مغلقًا تمامًا. بالنسبة إلى المجاري المزدوجة (duplex streams)، ينبغي أن يكون طرفي القراءة والكتابة مغلقين. البنية العامة closed? → true or false‎ القيمة المعادة تعاد القيمة true إن كان مجرى د/خ مغلقًا كليًّا، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع closed?‎: f = File.new("testfile") f.close #=> nil f.closed? #=> true f = IO.popen("/bin/sh","r+") f.close_write #=> nil f.closed? ...

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

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

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

يحول التابع to_s التوقيت المعطى إلى سلسلة نصية. وهو مكافئ لاستدعاء التابع strftime مع سلسلة تنسيق مناسبة. البنية العامة to_s → string‎ القيمة المعادة تعاد سلسلة نصية تمثل التوقيت المعطى. أمثلة مثال على استخدام التابع to_s: t = Time.now t.to_s => "2012-11-10 18:16:12 +0100" t.strftime "%Y-%m-%d %H:%M:%S %z" => "2012-11-10 18:16:12 +0100" t.utc.to_s ...

يمثل الصنف InstructionSequence تسلسلًا مصرّفًا (compiled sequence) للتعليمات الخاصة بالآلة الافتراضية (Virtual Machine) لروبي. يمكّنك هذا الصنف من الحصول على مؤشر (handle) للتعليمات التي تشكل التابع أو الكتلة البرمجية، وتصريف (compile) سلاسل روبي النصية إلى تعليمات الآلة الافتراضية (VM)، وتفكيك التعليمات إلى سلاسل نصية لتسهيل فحصها. هذا الصنف مفيد للغاية إن كنت ترغب في معرفة كيفية عمل آلة روبي الافتراضية، لكنه يتيح لك أيضًا التحكم في إعدادات المُصرِّف iseq لروبي. يمكنك العثور على مصدر إرشادات الآلة الافتراضية في الصفحة insns.defفي ...

يُعيد التابع encoding ترميز السلسلة النصية التي استُدعيت معه. البنية العامة encoding → encoding القيمة المعادة يُعاد ترميز السلسلة النصية المُعطاة. أمثلة مثال على استعمال التابع encoding: "hello".encoding   #=> #<Encoding:ASCII-8BIT> "\u0639".encoding #=> #<Encoding:UTF-8> انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع force_encoding: يغير ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. مصادر قسم التابع encoding‎ في الصنف String في توثيق روبي الرسمي.

يتحقق التابع binmode?‎ إذا تمت قراءة المجرى ARGF في الوضع الثنائي (binary mode). إن أردت تفعيل الوضع الثنائي للمجرى ARGF، فاستخدم التابع binmode. البنية العامة binmode? → true or false القيمة المعادة تعاد القيمة true إن تمت قراءة المجرى ARGF في الوضع الثنائي (binary mode)، أو القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع binmode?‎: ARGF.binmode? #=> false ARGF.binmode ARGF.binmode? #=> true انظر أيضًا التابع binmode: يفعِّل الوضع الثنائي (binary mode) للمجرى ARGF. التابع close?‎: يتحقق إن أُغلِق الملف ...

يعيد التابع ‎rect عددًا عقديًا وفق الشكل الجبري أو المستطيلي (rectangular form). يُمثَّل العدد العقدي جبريًّا بالشكل: z = a + b.i. البنية العامة rect(real[, imag]) → complex rectangular(real[, imag]) → complex المعاملات real يمثل الجزء الحقيقي (a) للعدد العقدي. imag يمثل الجزء التخيلي (b) للعدد العقدي. القيمة المعادة يعيد التابع ‎rect عددًا عقديًا وفق الشكل الجبري، إذ يمثِّل المعامل real جزأه الحقيقي (a) والمعامل imag جزأه التخيلي (b). أمثلة أمثلة عن استخدام التابع rect: Complex.rectangular(1, 2) #=> (1+2i) ...

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

يكرِّر التابع each_slice الكتلة المعطاة على كل قطعة مكونة من n عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه. إن لم تُعطَ الكتلة، فسيُعيد التابع كائنًا من النوع Enumerator. البنية العامة each_slice(n) { ... } → nil each_slice(n) → an_enumerator المعاملات n عدد العناصر في الشريحة التي ستطبَّق عليها الكتلة المعطاة. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية، أو يعاد كائنٌ من النوع Enumerator إن لم تُعطَ الكتلة. أمثلة مثال على استعمال التابع each_slice: (1..10).each_slice(3) { |a| p a } # outputs ...

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

يتحقَّق التابع ?nil فيما إذا كان الكائن المعطى هو nil أم لا. البنية العامة nil? → true or false القيم المعادة تُعاد القيمة true إذا كان الكائن المعطى هو nil؛ خلاف ذلك، تعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ?nil: Object.new.nil? #=> false nil.nil? #=> true انظر أيضًا التابع ?eql: يتحقَّق من استخدام كلا الكائنين نفس مفتاح التجزئة. التابع ?instance_of: يتحقَّق إذا كان الكائن الذي استدعي معه نسخةً من ...

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

يحذف التابع reject!‎ جميع عناصر المصفوفة التي لم تحقق شرطًا محددًا. قد لا تتغيير المصفوفة مباشرةً في كل مرة تستدعى فيها الكتلة block الممرَّرة إلى التابع. إن لم تُمرَّر أية كتلة إلى التابع !reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject! { |item| block } → ary or nil reject! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف عناصرها التي لم تعاد معها القيمة true عند تطبيق الكتلة bloc عليها، أو تعاد القيمة nil إن لم يحذف أي ...

يستدعي التابع each_with_index الكتلة المعطاة مع وسيطين هما: العنصر نفسه وفهرسه لكل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه. إن مُرِّر أي شيء إلى التابع، فسيُمرَّر مباشرةً إلى ()each. إن لم تُعطَ الكتلة، فسيُعيد التابع كائنًا من النوع Enumerator. البنية العامة each_with_index(*args) { |obj, i| block } → enum each_with_index(*args) → an_enumerator المعاملات args الوسائط المراد تمريرها إلى ()each. القيمة المعادة يعاد كائن قابل للتعداد يحوي نتائج تكرار الكتلة block على كل عنصر وفهرسه من عناصر الكائن القابل للتعداد المعطى، أو ...

يقيِّم التابع class_exec الكتلة المعطاة في سياق الصنف/الوحدة التي استُدعي معها. التابع المعرف في الكتلة سينتمي إلى المستقبِل (receiver). وستُمرر كل الوسائط المعطاة للتابع إلى الكتلة. يمكن استخدام هذا التابع إذا كانت الكتلة تحتاج إلى الوصول إلى متغيرات النسخ (instance variables). البنية العامة class_exec(arg...) {|var...| block } → obj‎ المعاملات arg...‎ الوسائط المراد تمريرها إلى الكتلة. القيمة المعادة يعاد ناتج تقييم الكتلة المعطاة في سياق الصنف/الوحدة المعطاة. أمثلة مثال على استخدام التابع class_exec‎: class Thing end Thing.class_exec{ def hello() "Hello there!" ...

يجري التابع ‎fdiv عملية القسمة على العدد العقدي. البنية العامة fdiv(numeric) → complex المعاملات numeric العدد المقسوم عليه. القيمة المعادة يعيد التابع ‎fdiv ناتج عملية قسمة العدد العقدي على الوسيط numeric. أمثلة أمثلة عن استخدام معامل التابع ‎fdiv: Complex(11, 22).fdiv(3) #=> (3.6666666666666665+7.333333333333333i) انظر أيضًا المعامل ‎/: يجري عملية القسمة على الأعداد العقدية. المعامل *‎: يجري عملية الضرب على الأعداد العقدية. مصادر قسم التابع fdiv‎ في الصنف Complex في توثيق روبي الرسمي.

يُستدعَى التابع 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?‎: يتحقق إن كان التابع المعطى مُعرّفًا في ...

تحوّل المكتبة Marshal مجموعات من كائنات روبي إلى مجرى من البايتات (byte stream)، مما يسمح بتخزينها خارج البرنامج النصي النشط حاليًا. يمكن بعد ذلك قراءة تلك البيانات وإعادة إنشاء الكائنات الأصلية أنشئت منها. تحتوي البيانات المرصوفة (Marshaled data) على أرقام الإصدار الرئيسية والثانوية مخزنةً مع معلومات الكائن. في الاستخدام العادي، تُحمّل فقط البيانات التي لها نفس رقم الإصدار الرئيسي، ورقم الإصدار الثانوي المساوي أو الأقل منه. وفي حال ضبط قيمة الراية "verbose" (عادةً باستخادم ‎-d أو ‎-v أو ‎-w أو ...

يعيد التابع ‎conjugate مرافق العدد العقدي الذي استدعي معه.  البنية العامة conjugate → complex القيمة المعادة يُعاد مرافق العدد العقدي المعطى. أمثلة أمثلة عن استخدام معامل التابع ‎conjugate: Complex(1, 2).conjugate #=> (1-2i) انظر أيضًا التابع ‎conj: يعيد مرافق العدد العقدي.  مصادر قسم التابع conjugate في الصنف Complex في توثيق روبي الرسمي.

يتحقق التابع saturday?‎ إن كان التوقيت يمثل يوم السبت. البنية العامة saturday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم السبت؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع saturday?‎: t = Time.local(2006, 6, 10) #=> 2006-06-10 00:00:00 -0500 t.saturday? #=> true‎ انظر أيضًا التابع tuesday?‎: يتحقق إن كان ...

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

يضبط التابع compile_option عند استدعائه بالشكل compile_option = options‎ القيم الافتراضية إلى القيم options‎ لتحسين أداء المصرف iseq لروبي. البنية العامة compile_option = options‎ تتضمن القيم المحتملة للخيارات options القيمة true، التي تفعِّل جميع الخيارات، والقيمة false، التي تعطل جميع الخيارات، والقيمة nil، التي تترك كل الخيارات دون تغيير. يمكن أن يكون options جدول Hash يحوي الخيارات التي تريد تغييرها، وسيتم آنذاك ترك أية خيارات غير موجودة في الجدول دون تغيير. تشمل أسماء الخيارات الممكنة (والتي ستكون مفاتيح في الجدول Hash) ...

يعيد التابع new كائنًا مجلديًا (directory object) جديدًا خاصًا بالمجلد المعطى. البنية العامة new( string ) → aDir new( string, encoding: enc ) → aDir المعاملات string  اسم المجلد المعطى. encoding يحدِّد هذا الوسيط الاختياري ترميز المجلد. وفي حال عدم إعطائه، سيُستخدم ترميز نظام الملفات. القيمة المعادة يعاد كائنٌ مجلديٌ (directory object) جديدٌ خاص بالمجلد string المعطى. انظر أيضًا التابع open: يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. مصادر قسم التابع new في الصنف Dir في توثيق روبي الرسمي.

يُعيد التابع stat المعلومات الداخلية للمتعقب. المحتويات المعادة مُتعلقة بالتنفيذ (implementation). وقد تتغير في المستقبل. هذا التابع مخصوص بتصحيح (debugging) الصنف TracePoint نفسه. البنية العامة stat → obj‎ القيمة المعادة تعاد المعلومات الداخلية للمتعقب. انظر أيضًا التابع new: يُعيد متعقبًا جديدًا. التابع trace: ينشِّط التعقب تلقائيًا. مصادر قسم التابع stat‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

يتحقق التابع sunday?‎ إن كان التوقيت يمثل يوم الأحد. البنية العامة sunday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم الأحد؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع sunday?‎: t = Time.local(1990, 4, 1) #=> 1990-04-01 00:00:00 -0600 t.sunday? #=> true‎ انظر أيضًا التابع tuesday?‎: ...

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

يُستدعَى التابع const_missing عند محاولة استخدام ثابت غير مُعرَّف في الوحدة. المعامل الوحيد المُمرَّر إليه يمثل الثابت غير المعرفة. ويعيد التابع قيمة ليتم استخدامها بدل ذلك الثابت كما يوضح المثال التالي: def Foo.const_missing(name) name # يعاد اسم الثابت كرمز end Foo::UNDEFINED_CONST #=> :UNDEFINED_CONST: أعيد الرمز البنية العامة const_missing(sym) → obj‎ المعاملات sym‎ رمز يمثل الثابتة. القيمة المعادة تعاد قيمةٌ ليتم استخدامها بدل الثابت. أمثلة في المثال التالي، عند محاولة الدخول إلى ثابت غير معرَّف، سيحاول التابع const_missing تحميل ملفٍ اسمه ...

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

يكتب التابع write السلاسل النصية المُمرَّرة إليه في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحا في وضعية للكتابة. سيتم تحويل الوسائط غير النصية إلى سلسلة نصية باستخدام التابع to_s. البنية العامة write(string, ...) → integer‎ المعاملات string‎ سلسلة نصية يراد كتابتها في المجرى المعطى. القيمة المعادة تعاد عدد البايتات المكتوبة في المجرى. أمثلة مثال على استخدام التابع write‎: count = $stdout.write("This is", " a test\n") puts "That was #{count} bytes of data"‎ الناتج: This is a test That was 15 bytes of ...

التابع rehash‎ لا يفعل أي شيء، فهو موجود لأغراض التوافقية مع الصنف Hash. البنية العامة rehash انظر أيضًا الصنف Hash. مصادر قسم التابع rehash في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع clock_gettime الوقت المعاد عبر الدالة clock_gettime()‎ الذي يخص POSIX. البنية العامة clock_gettime(clock_id [, unit]) → number تعيد الدالة الضمنية، التي هي clock_gettime()‎، عدد النانو ثواني. الكائن Float (العدد العشري المضاعف وفق المعيار IEEE 754) ليس كافيًا لتمثيل القيمة المعادة من أجل CLOCK_REALTIME. إن كان عدد النانو ثواني الدقيق نفسه مطلوب، فاستعمل القيمة ‎:nanoseconds مع المعامل unit. يختلف أصل (نقطة الصفر) القيمة المعادة. على سبيل المثال، يمكن أن يكون نقطة بدء تشغيل النظام، أو بدء تشغيل العملية، أو وقت بدء توقيت يونكس ...

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

يعيد التابع value القيمة المعادة من الوسم الذي استدعي معه. البنية العامة value→ obj‎ القيمة المعادة تعاد القيمة المعادة من الوسم المعطى. انظر أيضًا التابع to_s: يعيد رسالة منسقة تحتوي الوسم (tag). مصادر قسم التابع value‎ في الصنف UncaughtThrowError‎ في توثيق روبي الرسمي.

يمثل الصنف Encoding ترميز المحارف الذي يمكننا استخدامه في لغة روبي. تُعرَّف النّسخة المنشأة من الصنف Encoding بأنّها ثابتٌ (constant) يندرج ضمن مجال أسماء الصنف (encoding namespace)؛ يكون لها اسم، واسم بديل (Alias) اختياري. Encoding::ISO_8859_1.name #=> "ISO-8859-1" Encoding::ISO_8859_1.names #=> ["ISO-8859-1", "ISO8859-1"] التّوابع (methods) في لغة روبي التي تتعامل مع التّرميزات تعيد أو تقبل النسخ Encoding على شكل وسيط (عندما يقبل التّابع كائنًا على شكل وسيط، يمكن عندها أن نستخدم اسم أو لقب الترميز عوضًا عن الكائن). "some string".encoding #=> #<Encoding:UTF-8> string = "some string".encode(Encoding::ISO_8859_1) #=> "some string" string.encoding #=> ...

يعيد التابع compact كائن Hash جديد يحوي جميع الأزواج قيم/مفاتيح للكائن الذي استدعي معه باستثناء الأزواج المعدومة (أي ذات القيمة nil). البنية العامة compact → new_hash القيمة المعادة يعاد كائن جديد من النوع Hash يحوي جميع الأزواج قيم/مفاتيح للكائن المعطى باستثناء الأزواج المعدومة (أي ذات القيمة nil). أمثلة مثال على استعمال التابع compact: h = { "a" => 100, "b" => 200 } #=> {"a"=>100, "b"=>200} h.clear ...

يتحقق التابع stop?‎ إن كانت المهمة الفرعية ميتة أو نائمة. البنية العامة stop?→ true or false‎ القيمة المعادة تعاد القيمة true إن كانت المهمة الفرعية ميتة أو نائمة. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع stop?‎: a = Thread.new { Thread.stop } b = Thread.current a.stop? #=> true b.stop? #=> false‎ انظر أيضًا التابع alive?‎: يتحقق إن كانت المهمة الفرعية التي استُدعي معها قيد التشغيل أو نائمة. التابع status: يُعيد حالة المهمة الفرعية. مصادر قسم التابع stop?‎ في الصنف Thread‎ في ...

يعيد التابع arg القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. البنية العامة arg → 0 or float‎ القيمة المعادة تعاد القيمة 0 إن كانت القيمة موجبة، أو pi خلاف ذلك. انظر أيضا التابع angle: يعيد القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. التابع ceil: يعيد أصغر عدد أكبر من أو يساوي العدد العشري المعطى وبدقة محدَّدة. مصادر قسم التابع arg‎ في الصنف Float في توثيق روبي ...

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

ينتظر التابع 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 مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية: ...

السلاسل النصية (string) هي سلسلة تحتوي على حرف واحد أو أكثر وقد تحتوي على حروف أبجدية، مثل أرقام ورموز، ويكون كل حرف (أو رمز أو رقم) ممثلاً ببايت. السلاسل النصية في لغة البرمجة روبي عبارة عن كائنات (Objects)، وعلى عكس لغات البرمجة الأخرى، فإن النصوص قابلة للتغيير (Mutable) والتي تعني أننا نستطيع تعديل النصوص بدلًا من إنشاء نصوص جديدة. علامتا الاقتباس المزدوجتين والمفردتين يتم إنشاء السلاسل النصية (string) في لغة روبي باستعمال علامات الاقتباس المزدوجة (مثل "string") أو المفردة (مثل ...

يوزِّع التابع product عناصر المصفوفة التي استدعيت معه على جميع عناصر المصفوفات الممرَّرة إليه. طول المصفوفة الناتجة يساوي جداء طول المصفوفة التي استُدعيت مع التابع بأطوال المصفوفات المُمرّرة إليه. عندما يُستدعى التابع product مع كتلة برمجية، فسيُعِدّ التابع كل التبديلات الممكنة بين عناصر المصفوفات ثم يعيد المصفوفة نفسها. البنية العامة product(other_ary, ...) → new_ary product(other_ary, ...) { |p| block } → ary المعاملات other_ary مصفوفة يراد توزيع عناصر المصفوفة المعطاة على عناصرها. … مصفوفات أخرى يراد توزيع عناصر المصفوفة المعطاة ...

يستخلص التابع mon من التوقيت الذي استدعي معه رقم الشهر من السنة. البنية العامة mon→ integer month → integer‎ القيمة المعادة يعاد عدد صحيح بين 0 و 12 يمثل رقم الشهر من السنة للتوقيت المعطى. أمثلة مثال على استخدام التابع mon‎: t = Time.now #=> 2007-11-19 08:27:30 -0600 t.mon #=> 11 t.month #=> 11‎ انظر أيضًا التابع wday: يُعيد عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي ...

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

يحذف التابع ()clear كل الكائنات من الطابور الذي استُدعي معه. البنية العامة clear() انظر أيضًا التابع close : يغلق الطابور الذي استُدعي معه. التابع length : يعيد طول الطابور الذي استُدعي معه. التابع push : يضيف الكائن المُمرَّر إليه إلى الطابور المعطى. مصادر صفحة التابع clear في الصنف queue في توثيق روبي الرسمي.

ينشئ التابع local توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية. البنية العامة local(year) → time local(year, month) → time local(year, month, day) → time local(year, month, day, hour) → time local(year, month, day, hour, min) → time local(year, month, day, hour, min, sec_with_frac) → time local(year, month, day, hour, min, sec, usec_with_frac) → time local(sec, min, hour, day, month, year, dummy, dummy, isdst, dummy) → time‎ المعاملات year‎ عدد يمثِّل السنة. month‎ عدد بين 1 و 12 يمثِّل الشهر، أو ...

التابع inspect‎ هو اسم بديل للتابع to_s. البنية العامة inspect(*args) مصادر قسم التابع inspect‎ في الصنف Integer‎ في توثيق روبي الرسمي.

يعيد التابع unicode_normalize نسخة موحدة (normalized string، أي ذات ترميز موحد) للسلسلة النصية التي استدعيت معه، باستخدام ترميزات يونيكود الموحدة (Unicode normalizations) التالية: NFC، أو NFD، أو NFKC، أو NFKD. يطلق التابع استثناءً إذا كانت السلسلة النصية غير مُرمّزة بترميز اليونيكود. يُقصَد بترميز اليونيكود (Unicode Encoding) أيًا من الترميزات التالية: UTF-8، أو UTF-16BE/LE، أو UTF-32BE/LE، أو GB18030، أو UCS_2BE، أو UCS_4BE. تُحوَّل السلسلة النصية إلى الترميز UTF-8، إذا كانت مُرمّزة بترميز مغاير له، مما يجعل العملية أبطأ فيما إذا كانت ...

ينشئ التابع mkdir مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا. يمكن تعديل الأذونات بواسطة File::umask، ويتم تجاهلها في NT. إن لم يكن بالإمكان إنشاء المجلد، فسيُطلق الخطأ SystemCallError. راجع أيضًا مناقشة الأذونات في توثيق الصنف File. البنية العامة mkdir( string [, integer] ) → 0 المعاملات string  اسم المجلد الجديد المراد إنشاؤه. integer أذونات المجلد الجديد المراد إنشاؤه. أمثلة مثال عن استخدام التابع mkdir: Dir.mkdir(File.join(Dir.home, ".foo"), 0700) #=> 0 انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي ...

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

يُعيد التابع yday عددًا صحيحًا يمثل رقم اليوم في السنة للتوقيت الذي استدعي معه. البنية العامة yday → integer‎ القيمة المعادة يعاد عددٌ صحيحٌ بين 1 و 366 يمثل اليوم في السنة للتوقيت المعطى. أمثلة مثال على استخدام التابع yday‎: t = Time.now #=> 2007-11-19 08:32:31 -0600 t.yday #=> 323‎ انظر أيضًا التابع wday: يُعيد عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي استدعي معه. التابع sec: يستخلص من التوقيت رقم الثانية في ...

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

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

يعيد التابع to_s السلسلة النصية “ENV”. البنية العامة to_s → "ENV" القيمة المعادة تُعاد السلسلة النصية “ENV”. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.  التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. مصادر قسم التابع to_s في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع uid المُعرِّف الحقيقي للمستخدم المالك للعملية الحالية. البنية العامة uid → integer Process::UID.rid → integer Process::Sys.getuid → integer القيم المعادة يعاد عدد صحيح يمثِّل المُعرِّف الحقيقي للمستخدم المالك للعملية الحالية. أمثلة مثال على استعمال التابع uid: Process.uid #=> 501 انظر أيضًا التابع euid: يعيد مُعرِّف المستخدم الفعال (effective user ID) المالك لهذه العملية. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع ppid: يعيد معرِّف العملية الأب للعملية الحالية. التابع uid=‎: يضبط عند استدعائه بالشكل uid= user المُعرِّف ...

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

يعيد التابع owner الصنف أو الوحدة (module) التي تعرف التابع الحر الذي استدعي معه. البنية العامة owner → class_or_module‎ القيمة المعادة يعاد الصنف أو الوحدة (module) التي تعرف التابع الحر. انظر أيضًا التابع original_name: يعيد الاسم الأصلي للتابع الحر الذي استُدعي معه. التابع parameters: يعيد معلومات عن معاملات التابع الحر الذي استُدعي معه. مصادر قسم التابع owner‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

يُعيد التابع options مجموعة البتات (bits) المقابلة للخيارات المستخدمة عند إنشاء التعبير النمطي الذي استُدعي معه (انظر صفحة التابع new لمزيد من التفاصيل). لاحظ أنه قد يتم وضع بتات إضافية في الخيارات المُعادة التي تُستخدَم داخليًا بواسطة التعبير النمطي. يتم تجاهل هذه البتات الإضافية إذا تم تمرير الخيارات إلى new. البنية العامة options→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل مجموعة البتات (bits) المقابلة للخيارات المستخدمة عند إنشاء التعبير النمطي المعطى. أمثلة مثال على استخدام التابع options‎: Regexp::IGNORECASE ...

يتحقق التابع success?‎ من نجاح عملية الإنهاء. البنية العامة success? → true or false‎ القيمة المعادة تعاد القيمة true في حال نجاح عملية الإنهاء، وإلا فستعاد القيمة false. انظر أيضًا التابع status: يعيد قيمة الحالة المرتبطة بكائن SystemExit الذي استُدعي معه. مصادر قسم التابع success?‎ في الصنف SystemExit‎ في توثيق روبي الرسمي.

يعيد التابع first أول عنصر أو أول n عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه. البنية العامة first → obj or nil first(n) → an_array المعاملات n عدد صحيح يحدِّد عدد العناصر الأولى المراد جلبها من الكائن القابل للتعداد المعطى. القيمة المعادة يعاد أول عنصر من عناصر الكائن القابل للتعداد المعطى، أو تعاد مصفوفة تحوي أول n - إن أعطي - عنصر من ذلك الكائن، أو تعاد القيمة nil إن كان ذلك الكائن فارغًا ولم يُعطَ المعامل n، أو تعاد مصفوفة ...

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

يعيد التابع to_s التمثيل النصي للقيمة true، والتي هي "true". التابع inspect هو اسم بديل للتابع to_s. البنية العامة to_s→ "true"‎ القيمة المعادة يعاد التمثيل النصي للقيمة true، والتي هي "true". انظر أيضًا التابع inspect: يعيد التمثيل النصي للقيمة true، والتي هي "true". مصادر قسم التابع to_s‎ في الصنف TrueClass‎ في توثيق روبي الرسمي.

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

يعيد التابع transform_values كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل قيمة من قيم الكائن Hash الذي استدعي معه. لا يُغيّر هذا التابع المفاتيح. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_values {|value| block } → new_hash transform_values → an_enumerator القيمة المعادة يعاد كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل قيم من قيم الكائن Hash المعطى، أو يعاد كائن من النوع enumerator إن ...

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

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

يجمع التابع join جميع عناصر المصفوفة التي استُدعيت معها سويةً في سلسلة نصية ويفصل بينها بفاصل معين. البنية العامة join(separator=$,) → str المعاملات separator المحرف الذي يراد استعماله كفاصل بين عناصر المصفوفة عند وضعها في سلسلة نصية. إن كانت قيمة هذا الفاصل هي nil، فسيستخدم التابع المحرف $ الافتراضي. أما إن كانت قيمة كلٍّ من separator و $ هي nil، فسيستخدم التابع سلسلة نصية فارغة كفاصل. القيم المعادة تعاد سلسلة نصية تحوي جميع عناصر المصفوفة المعطاة مفصولةً بالفاصل separator. ...

يعد التابع bytes اسمًا بديلًا مهملًا للتابع each_byte. البنية العامة bytes() انظر أيضًا التابع each_byte: يكرر تنفيذ الكتلة المعطاة على كل بايت في المجرى. مصادر قسم التابع bytes‎ في الصنف IO‎ في توثيق روبي الرسمي.

يُبقِي التابع keep_if كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا ويحذف البقية. في حال لم تمرَّر أية كتلة برمجية إلى التابع، فسيعيد كائنًا من النوع enumerator. البنية العامة keep_if { |name, value| } → Hash keep_if → Enumerator القيمة المعادة يعاد كائن من النوع Hash بعد حذف متغيرات البيئة التي أعيدت معها القيمة false عند تمريرها إلى الكتلة المعطاة، أو يعاد كائن من النوع enumerator في حال عدم تمرير أية كتلة. انظر أيضًا التابع clear: يحذف جميع متغيرات البيئة. التابع delete: يحذف متغير ...

يعيد التابع sum المجموع التحقُّقي (checksum) ذي الحجم n بت لحروف السلسلة النصية التي استدعيت معه؛ هذا المجموع عبارة عن مجموع القيم الثنائية لكل بايت من بايتات السلسلة وفق المقياس: 1 - n**2، حيث يمكن تغيير قيمة n التي تأخذ افتراضيًا القيمة 16. البنية العامة sum(n=16) → integer المعاملات n عدد صحيح يمثل قيمة n في المقياس 1- 2**n المستعمل في حساب المجموع التحقُّقي، ويأخذ افتراضيًا القيمة 16. القيمة المعادة يُعاد المجموع التحقُّقي لمحارف السلسلة النصية المعطاة. انظر أيضًا التابع ...

يُطلق الاستثناء RangeError عند إعطاء تعبير نمطي غير صالح. إذا نفَّذنا السطر البرمجي التالي: Regexp.new("?") فسيُطلَق الاستثناء RangeError بالشكل التالي: RegexpError: target of repeat operator is not specified: /?/ مصادر صفحة الصنف RegexpError في توثيق روبي الرسمي.