نتائج البحث

يجلب التابع pop بياناتٍ من الطابور الذي استُدعي معه. إذا كان طابور الانتظار فارغًا، يُعلَّق الخيط (thread) الذي استدعى التابع حتى تضاف بيانات إلى هذا الطابور. إذا مُرِّرت القيمة true إلى التابع، فلن يُعلَّق الخيط، وسيُرمى الاستثناء ThreadError آنذاك. البنية العامة pop(non_blocock=false) المعاملات non_block قيمة منطقية تحدِّد إن كان يراد تعليق عمل الخيط إن كان الطابور فارغًا أم لا. القيمة الافتراضية له هي: false. القيم المعادة تُعاد البيانات المجلوبة من الطابور المعطى. انظر أيضًا التابع push : يضيف الكائن المُمرَّر إليه ...

يضبط التابع const_set قيمة ثابت محدَّد إلى قيمة الكائن المعطى ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابت جديد ويسند إلى تلك القيمة. البنية العامة const_set(sym, obj) → obj const_set(str, obj) → obj‎ المعاملات sym‎ رمز يمثل الثابت. إذا لم يكن المعامل sym اسم ثابت صالح، فسيُطلق الخطأ NameError مع التحذير "wrong constant name". obj‎ الكائن المراد ضبط قيمته إلى الثابت. str‎ سلسلة نصية تمثل الثابتة. إذا لم يكن المعامل str‎ اسم ثابت صالح، فسيُطلق ...

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

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

يعيد التابع each_line قيمة قابلة للعد (enumerator) تتكرر (iterates) عبر كل سطر (الذي يفصل بالفاصلة الممرَّرة) من كل ملف من الملفات الموجودة في ARGV. في حال تمرير كتلة برمجية للتابع each_line، فسيُمرّر كل سطر بدوره إلى تلك الكتلة، وإلا فستعاد قيمة قابلة للعد (enumerator). يسمح لك هذا التابع بمعالجة الملفات المُمرَّرة من سطر الأوامر كما لو كانت ملفًا واحدًا مكونًا من سلسلة من هذه الملفات المسماة. بعد إعادة السطر الأخير من الملف الأول، سيُعاد السطر الأول من الملف الثاني. يمكن ...

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

يعيد التابع coerce‎ مصفوفة تضم القيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، وذلك عبر تحويل numeric إلى Bignum. سيُطلق الخطأ TypeError في حال لم يكن numeric المعطى من النوع Fixnum أو Bignum. البنية العامة coerce(numeric) → array‎ القيمة المعادة تعاد مصفوفة تضم قيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، عبر تحويل numeric إلى Bignum. أمثلة مثال على استخدام التابع coerce‎: (0x3FFFFFFFFFFFFFFF+1).coerce(42) #=> [42, 4611686018427387904] ‎ انظر أيضا التابع chr: يعيد سلسلة نصية تحتوي على ...

يعيد التابع select‎ نسخة من البيئة (environment) تضم المدخلات التي حقَّقت شرطًا معيَّنًا. في حال عدم تمرير أي كتلة برمجية إلى التابع، فسيعيد كائنًا من النوع enumerator. البنية العامة select { |name, value| } → Hash select → Enumerator القيمة المعادة يُعاد كائن من النوع Hash يحوي نسخة من البيئة تضم المدخلات (entries) التي أعيدت القيمة true معها عند تمريرها إلى الكتلة البرمجية. وفي حال عدم تمرير أية كتلة برمجية، فسيُعاد كائن من النوع enumerator. انظر أيضًا التابع inspect: يعيد محتوى البيئة (environment) ...

يتحقّق التّابع ?to_tty فيما إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية tty. البنية العامة to_tty? → true or false القيم المعادة تُعاد القيمة true إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية tty، أو تُعاد القيمة false خلاف ذلك. انظر أيضا التابع to_s: يُعيد رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة). التابع full_message: يُعيد سلسلةً نصيةً منسّقةً من الاستثناء. مصادر صفحة التابع ?to_tty في الصنف Exception في توثيق روبي الرسمي.

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

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

يُنشئ التابع enum_for نسخةً من الصنف Enumerator الذي يجري عملية عدٍّ (enumerate) وتكرار عبر استدعاء التابع المُمرَّر إليها مع كائنٍ محدَّد، وتمرير وسائط إن أعطيت. إذا مُرِّرت كتلة (block) إلى التابع، فستُستخدم لحساب حجم نسخة الصنف Enumerator دون الحاجة إلى تكرارها (ألقِ نظرة على التابع Enumerator.size). البنية العامة enum_for(method = :each, *args) → enum enum_for(method = :each, *args){|*args| block} → enum المعاملات method التابع المُمرَّر. القيمة الافتراضية لهذا المعامل هي: each:. args* الوسائط المراد تمريرها إلى التابع. args| block*| الكتلة ووسائطها ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يعيد التابع ‎real?‎ القيمة false دائمًا مع العدد العقدي. البنية العامة real? → false القيمة المعادة تعاد القيمة false دومًا. أمثلة أمثلة عن استخدام التابع ‎real?‎: Complex(1.0/3, 0).real?‎ #=> false Complex(1, 0.0).real?‎ # false Complex(1, 2).real?‎ # false انظر أيضًا التابع ‎finite?‎: يتحقق فيما إذا كانت القيمة المطلقة (الطويلة r) للشكل القطبي للعدد العقدي الذي استُدعي معه منتهية (finite).  التابع ‎infinite?‎: يعيد قيمة بحسب ما إذا كانت القيمة المطلقة (الطويلة r) للشكل القطبي للعدد العقدي منتهية أو غير ...

يُدخل التابع tap الكائن المعطى إلى الكتلة (block)، ثم يعيده. الهدف الأساسي من هذا التابع هو "التداخل في" سلسلة التوابع، بهدف تنفيذ عملياتٍ على النتائج الوسطية التي تنتج خلال تنفيذ السلسلة. البنية العامة tap {|x| block } → obj المعاملات x الكائن المراد إدخاله إلى الكتلة. block الكتلة المراد تنفيذها على الكائن. القيم المعادة يُعاد الكائن نفسه. أمثلة مثالٌ عن استخدام التابع tap: (1..10) ...

يُعيد التابع inspect سلسلة نصية تمثل التوقيت الذي استدعي معه. هذا التابع مكافئ لاستدعاء التابع strftime مع سلسلة التنسيق المناسبة. البنية العامة inspect → string‎ القيمة المعادة تعاد سلسلة نصية تمثل التوقيت المعطى. أمثلة مثال على استخدام التابع inspect: 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 ...

يتحقق التابع none?‎ من خلو كائن قابل للتعداد من أي عنصر محقِّق للكتلة المعطاة (لا تعيد مع أي عنصر القيمة true) أو مطابق للنمط محدَّد. البنية العامة none? [{ |obj| block }] → true or false none?(pattern) → true or false المعاملات pattern نمط يراد التحقق من عدم مطابقته لأي عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد القيمة true إن لم تعيد الكتلة block القيمة true لجميع عناصر الكائن القابل للتعداد بعد تمرير كل واحد منها إليها، أو لم يتطابق ...

يحدِّد التابع srand بذرة مولد الأعداد شبه العشوائية (pseudo-random number generator) للنظام، بتعيين Random::DEFAULT، إلى القيمة المُمرَّرة إليه. يعيد التابع بعد استدعائه قيمة البذرة السابقة. في حال عدم أية قيمة إلى التابع srand، فسيبذُر المولد باستخدام مصدر للعشوائية (entropy) يوفره نظام التشغيل إن كان متاحًا (‎/dev/urandom على أنظمة Unix أو مُوفِّر خوارزمية التشفير [RSA] على نظام Windows)؛ تدمج هذه البذرة بين الوقت، ومعرف العملية (pid)، ورقم التسلسل لتوليدها من أجل أن تكون العشوائية كافية. يمكن استخدام srand لضمان تكرار تسلسلات ...

يُعيد التابع encoding كائنًا من النوع Encoding، والذي يمثل ترميز الكائن الذي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنٌ من النوع Encoding يمثِّل الترميز المستعمل. انظر أيضًا التابع casefold?‎: يعيد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). مصادر قسم التابع encoding‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

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

يعيد التابع 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: يستخلص من التوقيت رقم الثانية في ...