نتائج البحث

يُستخلص التابع hour من التوقيت رقم الساعة لليوم. البنية العامة hour → integer‎ القيمة المعادة يعاد عددٌ صحيحٌ بين 0 و 23 يمثِّل رقم الساعة لليوم من التاريخ المعطى. أمثلة مثال على استخدام التابع hour‎: t = Time.now #=> 2007-11-19 08:26:20 -0600 t.hour #=> 8‎ انظر أيضًا التابع yday: يُعيد عددًا صحيحًا يمثل يومًا من السنة الحالية. التابع sec: يستخلص من التوقيت رقم الثانية في الدقيقة. التابع year: يستخلص من التوقيت السنة (بما في ذلك ...

يُمثِّل الصنف EncodingError الصِّنفَ القاعديَّ (base class) لجميعِ أخطاء التّرميز (الصنف Encoding). مصادر صفحة الصنف EncodingError في توثيق روبي الرسمي.

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

يعيد التابع basename آخر مكوِّن من مسار اسم الملف المعطى. البنية العامة basename(file_name [, suffix] ) → base_name المعاملات file_name مسار الملف المراد اسخراج آخر مكون منه. يمكن أن يكون الفاصل المستعمل في فصل أجزاء هذا المسار هو File::SEPARATOR و File::ALT_SEPARATOR كلاهما عندما لا تكون قيمة الفاصل File::ALT_SEPARATOR هي nil. suffix معامل اختياري يحدد لاحقة الملف المراد إزالتها من الاسم الأساسي المستخرج من المسار. إن كانت قيمة هذا المعامل هي *.، فستُزال أية لاحقة تتبع الملف. القيمة المعادة يعاد الاسم الأساسي ...

يُنشئ التابع 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| ...

يكتب التابع warn رسالة التحذير المُمرَّرة إليه في المجرى ‎$stderr، متبوعة بسطر جديد إذا لم تنته الرسالة بسطر جديد. تستدعي روبي هذا التابع لكافة التحذيرات. البنية العامة warn(msg) → nil‎ المعاملات msg‎ رسالة التحذير المراد إظهارها في مجر الخطأ القياسي. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضًا الوحدة Warning. مصادر قسم التابع warn‎ في الصنف Warning‎ في توثيق روبي الرسمي.

يعيد التابع length عدد عناصر المصفوفة التي استُدعيت معه. البنية العامة length → int القيم المعادة يعاد عدد صحيح يمثل عدد عناصر المصفوفة المعطاة. أمثلة أمثلة على استخدام التابع length: [ 1, 2, 3, 4, 5 ].length #=> 5 [].length #=> 0 انظر أيضًا التابع count: يعيد عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة ...

يعيد التابع next الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة. عند وصول المؤشر إلى النهاية، يُطلَق الاستثناء StopIteration. البنية العامة next → object القيمة المعادة يعاد الكائن التالي في المُعدِّد المعطى. أمثلة مثال على استعمال التابع next: a = [1,2,3] e = a.to_enum p e.next #=> 1 p e.next #=> 2 p e.next #=> 3 p e.next #=> StopIteration انتبه إلى أنَّ السلسلة التعدادية المعادة عبر next لا تؤثر على التوابع التعدادية الغير ...

البنية العامة to_proc() انظر أيضا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_proc في الصنف Hash في توثيق روبي الرسمي.

يحذف التابع delete ملفًا محدَّدًا. يرمي هذا التابع استثناءً عند حصول أي خطأ. لمَّا كان التنفيذ الضمني لهذا التابع يعتمد على استدعاء النظام للدالة unlink(2)‎، فسيعتمد نوع الخطأ المرمي على أنواع الأخطاء الخاصة بها (اطلع على صفحة الدليل man لهذه الدالة لمزيد من التفاصيل) التي تأخذ شكلًا محدَّدًا مثل Errno::ENOENT. البنية العامة delete(file_name, ...) → integer المعاملات file_name اسم الملف المراد حذفه. ... أسماء الملفات الأخرى المراد حذفها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي أعطيت والتي يراد حذفها. انظر ...

يعدُّ التابع size اسمًا بديلًا للتابع length . البنية العامة size() انظر أيضًا التابع length : يعيد طول الطابور الذي استُدعي معه. التابع num_waiting : يعيد عدد الخيوط (threads) المنتظرة في الطابور الذي استُدعي معه. التابع pop : يجلب بياناتٍ من الطابور الذي استُدعي معه. مصادر صفحة التابع size في الصنف queue في توثيق روبي الرسمي.

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

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

يتحقق التابع empty?‎ إذا كان الكائن Hash الذي استدعي معه فارغًا أي لا يحتوي على أية أزواج. البنية العامة empty? → true or false القيمة المعادة تعاد القيمة true إذا الكائن Hash المعطى فارغًا أي لا يحتوي على أية أزواج. أمثلة مثال على استعمال التابع empty?‎: {}.empty? #=> true انظر أيضا التابع any?‎: يمرر كل زوج من مفتاح/قيمة من أزواج الكائن Hash المعطى إلى كتلة معينة ثم يعيد القيمة true إن أعادت الكتلة قيمة غير القيمة false أو nil. التابع eql?‎: يتحقق إذا كان كائنان من ...

يقتطع التابع each_line السلسلة النصية التي استدعيت معه إلى أجزاء (كل جزء يمثِّل سطرًا افتراضيًّا) مفصولة بفاصل محدَّد ثم يمرِّر كل منها على حدة إلى الكتلة المعطاة. البنية العامة each_line(separator=$/ [, getline_args]) {|substr| block } → str each_line(separator=$/ [, getline_args]) → an_enumerator المعاملات separator الفاصل المستعمل في تقطيع السلسلة النصية المعطاة إلى أجزاء. القيمة الافتراضية هي: /$ (فاصل سطر جديد). إن أعطي فاصل معدوم الطول (zero-length)، فستُقتطَع السلسلة النصية إلى فقرات محدَّدة عبر عدة محارف سطر جديد متتالية. getline_args اطلع على ...

يضبط التابع utime وقتي الوصول والتعديل لملف أو عدة ملفات محدَّدة. إن كان الملف المعطى وصلةً رمزيةً، فسيُنفَّذ هذا التابع على الملف الذي تشير إليه هذه الوصلة وليس على الوصلة نفسها. إن أردت سلوكًا معاكسًا لهذا، فاستعمل التابع lutime. البنية العامة utime(atime, mtime, file_name,...) → integer المعاملات atime وقت الوصول المراد تعيينه للملف أو الملفات المعطاة. mtime وقت التغيير المراد تعيينه للملف أو الملفات المعطاة file_name اسم الملف المراد تطبيق العملية عليه. ... أسماء الملفات الأخرى المراد تطبيق العملية عليها. القيمة المعادة يعاد عدد صحيح يمثِّل ...

يحول التابع to_i العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد صحيح ذي أساس محدَّد. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0 دون إطلاق أية استثناءات، بشرط أن يكون الأساس المراد تمثيل العدد به صحيحًا. البنية العامة to_i(base=10) → integer المعاملات base عدد صحيح يمثِّل الأساس الذي يُعاد وفقه العدد الموجود في بادئة السلسلة النصية المعطاة. تتراوح قيمة هذا المعامل ...

يبحث التابع rpartition عن تطابق نص أو نمط محدد بدءًا من نهاية السلسلة النصية ثم يعيد، إذا عثر التابع على تطابق، مصفوفةً من الجزء الذي يسبقه، والجزء المطابق، والجزء الذي يليه على التوالي. إذا لم يعثر التابع على تطابق، فإنَّه يعيد مصفوفة من سلسلتين فارغتين والسلسلة النصية المعطاة بعدهما على التوالي. البنية العامة rpartition(sep) → [head, sep, tail] rpartition(regexp) → [head, match, tail] المعاملات sep السلسلة النصية المُراد البحث عن تطابق لها ضمن السلسلة النصية المُعطاة. regexp التعبير النمطي المراد البحث ...

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

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

يتحقق التابع eql?‎ إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع (أي كلاهما عدد عشري) ومتساويين في القيمة. البنية العامة eql?(obj) → true or false‎ المعاملات obj عدد يراد التحقق من تساويه نوعًا وقيمةً مع العدد العشري المعطى. القيمة المعادة تُعاد القيمة true إن كان العدد العشري المعطى والعدد numeric من نفس النوع ومتساويين. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع eql?‎: 1.0.eql?(1) #=> false انظر أيضا المعامل<=>: يوازن بين ...

ينقل التابع flush أي بيانات مخزَّنة في المجرى الذي استدعي معه إلى نظام التشغيل (لاحظ أن هذا لا يشمل إلا التخزين المؤقت الداخلي لروبي؛ وقد يقوم نظام التشغيل بتخزين البيانات فيه أيضًا). البنية العامة flush → ios‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ العملية عليه. أمثلة مثال على استخدام التابع flush‎: $stdout.print "no newline" $stdout.flush‎ الناتج: no newline انظر أيضًا التابع fileno: يُعيد عددًا صحيحًا يمثل واصف الملف الرقمي للمجرى الذي استدعي معه. التابع fsync: يكتب مباشرةً جميع البيانات المخزنة في المجرى الذي استدعي ...

يعدُّ untrust تابعًا مهملًا (Deprecated method) وهو مكافئٌ تمامًا للتابع taint. البنية العامة untrust → obj القيم المعادة يُعاد الكائن المعطى بعد تعليمه ككائن فاسد (tainted). انظر أيضًا التابع taint: يصم الكائن الذي استدعي معه بأنه كائنٌ فاسد. التابع ?tainted: يتحقَّق إذا كان التابع فاسدًا. التابع trust: يعدُّ تابعًا مهملًا وهو مكافئٌ تمامًا للتابع untaint. التابع untaint: يُلغي علامة الحالة الفاسدة من الكائن الذي استدعي معه. التابع ?untrusted: يعتبر تابعًا غير منصوحٍ به وهو مكافئٌ للتابع ?tainted. مصادر صفحة التابع ...

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

يستدعي التابع include التابع append_features على كل المعاملات المُمرَّرة بترتيب عكسي. البنية العامة include(module, ...) → self‎ المعاملات module‎ يمثل الوحدة التي سيُستدعَى التابع append_features عليها. ... يمثل الوحدات الأخرى التي سيُستدعَى التابع append_features عليها بترتيب عكسي. القيمة المعادة يعاد الكائن المعطى. انظر أيضا التابع include?‎: يتحقق إن كانت الوحدة المعطاة مُضمّنة في الوحدة التي استُدعي معها أو في أحد أسلافها (ancestors). التابع included: يُستدعى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع included_modules: يعيد قائمة بالوحدات المضمنة في ...

يعيد التابع keys مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. البنية العامة keys → array القيمة المعادة تعاد مصفوفة جديدة تحوي مفاتيح الكائن Hash المعطى. أمثلة مثال على استعمال التابع keys: h = { "a" => 100, "b" => 200, "c" => 300, "d" => 400 } h.keys #=> ["a", "b", "c", "d"] انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. التابع key: يعيد المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي ...

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

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

يعيد التابع denominator المقام (denominator) للعدد الكسري الذي استدعي معه، ويكون دائمًا موجبًا. البنية العامة denominator → integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل المقام للعدد الكسري المعطى. انظر أيضا التابع numerator: يعيد البسط (numerator) للعدد الكسري الذي استدعي معه. مصادر قسم التابع denominator‎ في الصنف Float في توثيق روبي الرسمي.

يحاول التابع try_convert()‎ أن يحوّل كائنًا إلى مصفوفة بالاستعانة بالتابع to_ary. يمكن كذلك استخدام هذا التابع للتحقق مما إذا كان الوسيط المُمرّر إليه مصفوفةً أم لا. البنية العامة try_convert(obj) → array or nil المعاملات obj الكائن المراد تحويله إلى مصفوفة. القيم المعادة تعاد مصفوفة جديدة تضم محتوى الكائن obj، أو القيمة nil في حالة تعذر تحويل الكائن obj لسبب ما. أمثلة بعض الأمثلة لاستخدام التابع try_convert()‎: Array.try_convert([1]) #=> [1] Array.try_convert("1") #=> nil if tmp = Array.try_convert(arg) ...

يعيد التابع source السلسلة النصية الأصلية للنمط (pattern). لاحظ أنه سيتم الاحتفاظ بمحارف التهريب كما هي. البنية العامة source→ str‎ القيمة المعادة يعيد التابع source السلسلة النصية الأصلية للنمط. أمثلة مثال على استخدام التابع source‎: /ab+c/ix.source #=> "ab+c"‎ /\x20\+/.source #=> "\\x20\\+" انظر أيضا التابع to_s: يُعيد سلسلة نصية تحتوي على التعبير النمطي وخياراته. مصادر قسم التابع source‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

يعيد التابع reject مصفوفة تحوي جميع عناصر الكائن القابل للتعداد الذي استدعي معه باستثناء تلك التي لم تحقق الكتلة المعطاة (أي التي أعادت معها القيمة false عند تمريرها إليها). إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة reject { |obj| block } → array reject → an_enumerator القيمة المعادة تعاد مصفوفة تحوي جميع عناصر الكائن القابل للتعداد الذي استدعي معه باستثناء تلك التي لم تحقق الكتلة المعطاة (أي التي أعادت معها القيمة false عند تمريرها إليها)، أو ...

يعدُّ التابع grep_v نسخة معاكسة للتابع grep، إذ يعيد مصفوفة تحوي كل العناصر الغير مطابقة لنمط محدَّد من عناصر الكائن القابل للتعداد المعطى. البنية العامة grep_v(pattern) → array grep_v(pattern) { |obj| block } → array المعاملات pattern النمط المراد مطابقته لكل عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد مصفوفة تحوي كل عنصر غير مطابق للنمط pattern من عناصر الكائن القابل للتعداد المعطى، أو القيم التي تعيدها الكتلة لكل عنصر غير مطابق للنمط بعد تمريره إليها. أمثلة مثال على استعمال التابع ...

يعيد التابع to_a المصفوفة التي استُدعيت معه. في حال استدعاء هذا التابع مع كائن من صنف فرعي (subclass) من الصنف Array، فسيُحوَل ذلك الكائن إلى كائن من الصنف Array. البنية العامة to_a → ary القيم المعادة تعاد المصفوفة نفسها المعطاة. أمثلة مثالٌ على استخدام التابع to_a: [ "a", nil, "b", nil, "c", nil ].to_a #=> [ "a", nil, "b", nil, "c", nil ] انظر أيضًا التابع to_ary: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة ...

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

يعيد التابع birthtime وقت إنشاء ملف محدَّد. إن لم تكن المنصة المستعملة تدعم تسجيل وقت إنشاء الملف للملف المراد معرفة وقت إنشائه، فسيُرمَى الاستثناء NotImplementedError. البنية العامة birthtime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد معرفة زمن إنشائه. القيمة المعادة يعاد كائن من النوع Time يمثِّل الزمن الذي أُنشئ فيه الملف file_name.  أمثلة مثال على استعمال التابع birthtime: File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003 انظر أيضا التابع atime: يعيد ...

يحسب التابع acos معكوس جيب التمام (arc cosine) للعدد المعطى ويعيد قيمة من المجال ‎0..PI. مجال التعريف:‎[-1 ، 1] ‎. مجال النتائج:‎[0، PI] ‎. البنية العامة acos(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة معكوس جيب التمام (arc cosine) للعدد x المعطى. أمثلة مثال على استخدام التابع acos‎: Math.acos(0) == Math::PI/2 #=> true‎ انظر أيضا التابع acosh: يحسب معكوس جيب التمام القطعي للعدد المعطى. مصادر قسم التابع acos‎ في الصنف Math‎ في ...

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

يعدُّ هذا التابع اسمًا بديلًا للتابع length. انظر أيضًا التابع count: يعيد عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة (يتحقق من ذلك باستعمال المعامل ==) أو عدد العناصر التي تحقق شرطًا محددًا. التابع length: يحسب عدد عناصر المصفوفة التي استدعيت معه. مصادر قسم التابع size في الصنف Array في توثيق روبي الرسمي.

يُنشئ التابع new مولِّد أعدادٍ شبه عشوائيةٍ (PRNG) باستخدام قيمة محدَّدة للبذرة لضبط الحالة الأولية. إذا أُهملت البذرة، سيُهيَّأ التابع باستعمال البذرة new_seed العشوائية. ألقِ نظرةً على التابع srand لمعرفة المزيد عن استخدام البذرة. البنية العامة new(seed = Random.new_seed) → prng المعاملات seed قيمة البذرة المراد استعمالها مع مولد الأعداد العشوائية. إذا لم يعطَ هذا المعامل، فسيكون مساويًا إلى القيمة المعادة عبر استدعاء التابع Random.new_seed. القيم المعادة يُعاد مولِّد الأرقام شبه العشوائية. انظر أيضًا التابع new_seed: يعيد قيمةً عشوائية تمثِّل البذرة. ...

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

يتحقق التابع dst?‎ إن وقع التوقيت أثناء التوقيت الصيفي في منطقته الزمنية. البنية العامة dst? → true or false‎ القيمة المعادة تعاد القيمة true إن وقع التوقيت أثناء التوقيت الصيفي في منطقته الزمنية، وإلا فسيعيد القيمة false. أمثلة أمثلة على استخدام التابع dst?‎: # CST6CDT: Time.local(2000, 1, 1).zone #=> "CST" Time.local(2000, 1, 1).isdst #=> false Time.local(2000, 1, 1).dst? #=> false Time.local(2000, 7, 1).zone #=> "CDT" ...

يعدُّ التابع to_s اسمًا بديلًا للتابع inspect. انظر أيضًا التابع inspect: يحول مصفوفة إلى سلسلة نصية. مصادر قسم التابع to_s في الصنف Array في توثيق روبي الرسمي.

يعيد التابع flatten مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash الذي استدعي معه. أي أنَّ لكل مفتاح أو قيمة تكون مصفوفة، تستخرج عناصرها إلى مصفوفة جديدة. على عكس Array.flatten، لا يُسطِّح هذا التابع بشكل عَودي (recursively) افتراضيًا. يمكن تحديد مستوى عودية التسطيح عبر تمرير قيمة إلى التابع. البنية العامة flatten → an_array flatten(level) → an_array المعاملات level عدد صحيح يحدد مستوى عودية التسطيح. القيمة المعادة تعاد مصفوفة جديدة والتي تكون تسطيح أحادي الأبعاد للكائن Hash المعطى. أمثلة مثال على استعمال ...

يعيد التابع name اسم المهمة الفرعية. البنية العامة name→ string‎ القيمة المعادة تعاد سلسلة نصية تمثِّل اسم المهمة الفرعية. انظر أيضا التابع name=‎: يعين اسم معين لمهمة فرعية في روبي مصادر قسم التابع name‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يدمج التابع zip بين كل عنصر من عناصر الكائن القابل للتعداد الذي استدعي معه مع العناصر المقابلة له من كل معامل من المعاملات المُمرَّرة إليه. هذا يولد سلسلة من المصفوفات المكونة من n عنصر، إذ n هي عدد أكبر من عدد المعاملات المُمرَّرة بمقدار 1. طول السلسلة الناتجة ستكون enum.size. إن كان طول أي معامل أقل من enum.size، فستحل القيم nil مكان العناصر الشاغرة. إن أعطيت كتلة، فستُستدعَى لكل مصفوفة ناتجة؛ خلا ذلك، ستُعاد مصفوفة من المصفوفات الناتجة. البنية العامة zip(arg, ...) ...

يغيِّر التابع chmod بتات الأذونات لملف أو عدة ملفات محدَّدة. تعتمد التأثيرات الفعلية لاستدعاء هذا التابع على المنصة المستعملة (راجع شرح بتات الأذونات في بداية شرح الصنف File). في الأنظمة الشبيهة بيونكس، اطلع على الدالة chmod(2)‎ لمزيد من التفاصيل. البنية العامة chmod(mode_int, file_name, ... ) → integer المعاملات mode_int نمط الأذونات الجديدة المراد تعيينها إلى الملفات المحدَّدة. file_name اسم الملف المراد تغيير أذوناته. ... أسماء الملفات الأخرى المراد تغيير أذوناتها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي غُيِّرت أذوناتها. ...

ينشئ التابع deprecate_constant قائمة بالثوابت الموجودة المهملة. البنية العامة deprecate_constant(symbol, ...) => mod‎ المعاملات symbol‎ رمز يمثل الثابت. القيمة المعادة تعاد قائمة بالثوابت الموجودة المُتجاوزة. انظر أيضا التابع define_method: يعرف تابع نُسخة (instance method) في المُستقبِل (receiver). التابع extend_object: يوسع الكائن المعطى بإضافة ثوابت و توابع. مصادر قسم التابع deprecate_constant‎ في الصنف Module‎ في توثيق روبي الرسمي.

تُغلِّف كائنات الصنف Binding سياق التنفيذ (execution context) في مكان معين في الشيفرة البرمجية، وتحتفظ بذلك السياق لاستخدامه مستقبلًا. يُحتفَظ بالمتغيرات، والتوابع، وقيمة self، وربما كتلة المكرر (iterator block) وكل ما يمكن الوصول إليه في هذا السياق. يمكن إنشاء كائنات الصنف Binding باستخدام التابع Kernel.binding، واستدعاؤها بوساطة التابع Kernel.set_trace_func. يمكن تمرير كائنات الربط (binding objects) هذه كوسيط ثانٍ للتابع Kernel.eval لإنشاء بيئة للتقييم (evaluation). class Demo def initialize(n) @secret = n end def get_binding ...

اسمٌ بديلٌ (alias) للتّابع to_s. البنية العامة inspect() انظر أيضا التابع to_s: يحوِّل القيمة false المنطقية إلى سلسلةٍ نصيةٍ. مصادر صفحة التابع inspect في الصنف FalseClass في توثيق روبي الرسمي.

يتحقق التابع fnmatch من تطابق مسار مع نمط محدَّد. هذا النمط ليس تعبيرًا نظاميًّا بل يتبع قواعد مشابهة لتعميم أسماء الملفات في الصدفة. البنية العامة fnmatch( pattern, path, [flags] ) → (true or false) fnmatch?( pattern, path, [flags] ) → (true or false) المعاملات pattern النمط المراد منه مطابقة المسار path المعطى. يمكن أن يحتوي على المحارف الخاصَّة (metacharacters، أو تدعى محارف الصدفة أيضًا) التالية: المحرف الخاص الوصف * يطابق أي ملف. يمكن أن يُقيَّد بقيم أخرى في النطاق العام (glob). هذا ...

يتحقق التابع allbits?‎ إن كانت قيم كل بتات ناتج تطبيق العملية & على العدد الصحيح المعطى مع القناع الممرر إليه تساوي الواحد. البنية العامة allbits?(mask) → true or false‎ المعاملات mask‎ عدد صحيح يمثل القناع. القيمة المعادة تعاد القيمة true إن كانت قيم كل بتات ناتج العملية int & mask تساوي واحد، وإلا فستعاد القيمة false. انظر أيضا المعامل &: ينفذ العملية AND بين بتات العددين المعطيين.  التابع anybits?‎: يعيد القيمة true إن كانت قيمة إحدى بتات ناتج تطبيق العملية & على ...

يغير التابع chroot المجلد الجذر (root) لنظام الملفات الخاص بالعملية الحالية. العمليات التي تمتلك الصلاحيات الكافية هي العمليات المُخوّلة لاستدعاء هذا التابع. التابع غير متوفر على جميع أنظمة التشغيل. البنية العامة chroot( string ) → 0 المعاملات string المجلد الجذر الجديد لنظام الملفات الخاص بالعملية الحالية. انظر أيضًا التابع chdir‎: يغيِّر مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ . مصادر قسم التابع chdir في الصنف Dir في توثيق روبي الرسمي.

يحول التابع ‎to_s العدد العقدي الذي استدعي معه إلى سلسلة نصية إن كان ذلك ممكنًا (ينبغي أن يساوي الجزء التخيلي القيمة 0 تمامًا، وإلا فسيُطلَق الخطأ RangeError).   البنية العامة to_s → string القيمة المعادة تعاد سلسلة نصية تمثِّل ناتج تحويل العدد العقدي المعطى إن كان ذلك ممكنًا، أو سيُرمَى الخطأ RangeError إن لم يكن ذلك ممكنًا. أمثلة أمثلة عن استخدام معامل التابع ‎to_s: Complex(2).to_s ...

يمكن تمثيل عدد جذري (rational) كزوج من الأعداد الصحيحة بالشكل a / b‎ حيث b > 0؛ العدد a يمثل البسط، والعدد b يمثل المقام. من الناحية الرياضية، العدد الصحيح a يساوي العدد الجذري a / 1. في روبي، ​​يمكنك إنشاء الكائنات (الأعداد) الجذرية باستخدام التوابع Kernel.Rational أو to_r أو rationalize، أو عن طريق إضافة المُبدِّل r إلى عددٍ. ستكون القيم المعادة كسورًا غير قابلة للاختزال (irreducible fractions). Rational(1) #=> (1/1) Rational(2, 3) #=> ...

يحسب التابع log10 اللوغاريتم ذا الأساس 10 للعدد المعطى. مجال التعريف: (‎0 ، INFINITY]. المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة log10(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل ناتج اللوغاريتم ذي الأساس 10 للعدد x المعطى. أمثلة مثال على استخدام التابع log10‎: Math.log10(1) #=> 0.0 Math.log10(10) #=> 1.0 Math.log10(10**100) #=> 100.0‎ انظر أيضا التابع log: يحسب لوغاريتم العدد المعطى. التابع log2: يحسب اللوغاريتم ذا الأساس ...

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

يتحقق التابع isdst إن وقع التوقيت الذي استُدعي معه أثناء التوقيت الصيفي في منطقته الزمنية. البنية العامة isdst → true or false‎ القيمة المعادة تعاد القيمة true إن وقع التوقيت المعطى أثناء التوقيت الصيفي في منطقته الزمنية. خلا ذلك، تعاد القيمة flase. أمثلة مثال على استخدام التابع isdst‎: # CST6CDT: Time.local(2000, 1, 1).zone #=> "CST" Time.local(2000, 1, 1).isdst #=> false Time.local(2000, 1, 1).dst? #=> false Time.local(2000, 7, 1).zone ...

يُعيد التابع succ توقيتا جديدًا، مع إضافة ثانية واحدة على التوقيت الذي استُدعي معه. التابع succ أصبح مهملًا منذ روبي 1.9.2 بالنسبة للتوقيتات الكسرية. استخدم بدلًا هذا التابع الشكل time + 1. البنية العامة succ→ new_time‎ القيمة المعادة يعاد توقيتٌ جديدًٌ مع إضافة ثانية واحدة على التوقيت المعطى. أمثلة مثال على استخدام التابع succ‎: t = Time.now #=> 2007-11-19 08:23:57 -0600 t.succ #=> 2007-11-19 ...

يمسح التابع clear جميع محتوى السلسلة النصية المعطاة ويجعلها فارغة. البنية العامة clear → string القيمة المعادة تُعاد السلسلة النصية المعطاة بعد إفراغها وحذف محتواها. أمثلة مثال على استخدام التابع clear: a = "abcde" a.clear #=> "" انظر أيضًا التابع delete: يعيد نسخة عن السلسلة النصية المُعطاة محذوفًا منها محارف السلسلة النصية المُمرَّرة إليه. التابع delete_prefix: يعيد نسخة عن السلسلة النصية التي استدعي معها محذوفًا منها سابقة مُحددة. مصادر قسم التابع clear‎ في الصنف String في توثيق روبي ...

يحول التابع inspect مصفوفةً إلى سلسلة نصية. البنية العامة inspect → string القيم المعادة تعاد سلسلة نصية تمثل المصفوفة المعطاة. أمثلة أمثلة على استخدام التابع inspect: [ "a", "b", "c" ].inspect #=> "[\"a\", \"b\", \"c\"]" انظر أيضًا التابع to_s: يعدُّ اسمًا بديًلا للتابع inspect. التابع to_a: يعيد المصفوفة التي استُدعيت معه. التابع to_h: يعيد نتيجة تحويل المصفوفة التي استُدعيت معه إلى مصفوفة مكونة من الأزواج [key, value]. مصادر قسم التابع inspect في الصنف ...

يُعيد التابع DEBUG مستوى التصحيح في المهمة الفرعية (thread debug level). متوفر فقط في حالة تصريفه (compiled) مع الخيار THREAD_DEBUG = -1. البنية العامة DEBUG → num‎ القيمة المعادة يعاد عددٌ يمثل مستوى التصحيح في المهمة الفرعية (thread debug level). انظر أيضًا التابع DEBUG=‎: يعيّن عند استدعائه بالشكل DEBUG = num قيمة مستوى تصحيح المهمة الفرعية (thread debug level) إلى القيمة num. مصادر قسم التابع DEBUG‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يعيد التابع event نوع الحدث التي يجري تعقبه. راجع صفحة الصنف TracePoint لمزيد من المعلومات حول الأحداث المتاحة. البنية العامة ‎event() القيمة المعادة يعاد نوع الحدث الذي يجري تعقبه. انظر أيضًا التابع inspect: يُعيد سلسلة نصية تحتوي حالة كائن TracePoint وفق صيغة قابلة للقراءة. مصادر قسم التابع event‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

يحسب التابع ‎abs الطويلة (r) للعدد العقدي بشكله القطبي الذي استدعي معه ثم يعيدها. البنية العامة abs → real القيمة المعادة يعاد عدد حقيقي يمثِّل الطويلة للعدد العقدي بشكله القطبي. أمثلة أمثلة عن استخدام التابع ‎abs: Complex(-1).abs #=> 1 Complex(3.0, -4.0).abs #=> 5.0 انظر أيضًا التابع abs2: يعيد مربع القيمة المطلقة للعدد العقدي الذي استدعي معه. التابع arg: يعيد الجزء الزاوي (الزاوية θ) للشكل القطبي من العدد العقدي الذي استدعي معه. مصادر قسم ...

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

يحذف التابع reject!‎ الأزواج التي ترفضها الكتلة المعطاة من الكائن Hash الذي استدعي معه. يشبه هذا التابع التابع delete_if، ولكن يُعيد القيمة nil إذا لم تُجرى أية تغييرات على الكائن المعطى. البنية العامة reject! {| key, value | block } → hsh or nil reject! → an_enumerator القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد حذف الأزواج التي تعيد الكتلة block المعطاة معها القيمة false، أو تعاد القيمة nil إن لم تُجرَى أية تغييرات على الكائن. انظر أيضًا التابع reject: يعيد كائن ...

يوفر المخلوط Enumerable مجموعة من الأصناف مع توابع بحث ونقل (traversal) عديدة قادرة على ترتيب عناصر مجموعة مع بعضها بعضًا. يجب أن يوفر الصنف التابع each الذي يعيد العضو التالي من المجموعة. إن استعمل التابع max، أو mix، أو sort، فيجب أن يُوازَن بين الكائنات في المجموعة باستعمال المعامل <=> الذي تعتمد عليه تلك التوابع في ترتيب عناصر المجموعة الواحدة مع بعضها بعضًا. توابع النسخة العامة all?‎ يتحقق إن كان كل عنصر من عناصر المجموعة التي استدعيت معه محقَّقًا للكتلة ...

يعيد التابع lineno رقم سطر هذا الإطار. البنية العامة lineno() القيمة المعادة يعيد التابع lineno رقم سطر هذا الإطار. أمثلة مثال على استخدام التابع lineno‎ مع الملف caller_locations.rb من Thread::Backtrace::Location: loc = c(0..1).first loc.lineno #=> 2‎ انظر أيضًا التابع label: يعيد تسمية هذا الإطار. التابع path: يُعيد اسم ملف هذا الإطار. مصادر قسم التابع lineno‎ في الصنف Location‎ في توثيق روبي الرسمي.

يعيد التابع fetch قيمة من الكائن Hash لمفتاح معين. إذا كان المفتاح غير موجود، هناك عدة خيارات متاحة لتطبيقها وهي: مع عدم تمرير معاملات أخرى غير المفتاح، سيُرمَى الاستثناء KeyError. إذا مُرِّرت قيمة أخرى بعد المفتاح، فستُعاد هذه القيمة على أساس أنها قيمة افتراضية. إذا أعطيت الكتلة الاختيارية، فستُنفَّذ وتُعاد نتيجتها. البنية العامة fetch(key [, default] ) → obj fetch(key) {| key | block } → obj المعاملات key المفتاح المراد جلب القيمة المرتبطة به في الكائن Hash. default القيمة الافتراضية التي ...

ينتظر التابع value اكتمال المهمة الفرعية، باستخدام التابع join ثم يُعيد قيمتها، أو يطلق الاستثناء الذي أنهى المهمة الفرعية. البنية العامة value→ obj‎ القيمة المعادة تعاد القيمة المعادة من المهمة الفرعية أو يطلق الاستثناء الذي أنهى المهمة الفرعية. أمثلة مثال على استخدام التابع value‎: a = Thread.new { 2 + 2 } a.value #=> 4 b = Thread.new { raise 'something went wrong' } b.value #=> RuntimeError: something went wrong‎ انظر أيضًا التابع to_s: يضع اسم ومعرِّف وحالة المهمة الفرعية في ...

يحسب التابع pow‎ ناتج رفع الأس إلى أساس محدد أو باقي قسمة الناتج السابق على عدد محدَّد. أي يحسب ناتج العملية الموضحة بالشكل: a.pow(b) #=> same as a**b a.pow(b, m) #=> same as (a**b) % m, but avoids huge temporary values ‎ البنية العامة pow(numeric) → numeric pow(integer, integer) → integer‎ المعاملات numeric عدد صحيح يمثِّل القوة للأساس المعطى. integer عدد صحيح اختياري يمثل المقسوم عليه. القيمة المعادة يعاد ناتج رفع الأس ...

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

يجلب التابع values_at عنصرًا واحدًا أو أكثر ذا فهرس محدد من مصفوفة. البنية العامة values_at(selector, ...) → new_ary المعاملات selector عدد صحيح يمثل فهرس العنصر المراد جلبه من المصفوفة المعطاة. … أعداد صحيحة تمثل فهارس العناصر المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي عنصرًا واحدًا أو أكثر ذي الفهرس selector من المصفوفة المعطاة. إن كان الوسيط selector مجالًا، فستُجلَب العناصر التي تقع فهارسها ضمن ذلك المجال وتوضع في المصفوفة المعادة. إن وقع فهرس عنصر خارج مجال ...

يعيد التابع rewind ضبط موضع المؤشر الحالي في المجلد إلى بدايته. البنية العامة rewind → dir القيمة المعادة يعيد التابع rewind الكائن Dir بعد إعادة ضبط موضع المؤشر فيه إلى بدايته. أمثلة مثال عن استخدام التابع rewind على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") d.read #=> "." d.rewind #=> #<Dir:0x401b3fb0> d.read #=> "." أنظر أيضًا التابع pos: يعيد موضع المؤشر الحالي في المجلد الذي استٌدعي معه. التابع seek: ...

يعيد التابع report_on_exception حالة "التبليغ عند الاستثناء" (report on exception). القيمة الافتراضية هي true منذ روبي 2.5. كل المهام الفرعية التي يتم إنشاؤها عندما تكون قيمة هذه الراية مساوية للقيمة true ستبعث رسالة إلى المجرى stderr$ إذا أنهى استثناء ما هذه المهمة الفرعية. يُستخدَم هذا التابع لإمساك الأخطاء في المهمة الفرعية في وقت مبكر. لكن في بعض الحالات، قد لا ترغب في هذه المخرجات. هناك عدة طرق لتجنب المخرجات الزائدة: إذا لم يكن الاستثناء مقصودًا، فأفضل خيار أمامك هو إصلاح سبب ...

يعيد التابع collect_concat مصفوفة جديدة مع نتائج متصلة لتنفيذ الكتلة المعطاة مع كل عنصر من عناصر المُعدِّد الذي استدعي معه. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة collect_concat { |obj| block } → array collect_concat → an_enumerator القيمة المعادة تعاد مصفوفة تحوي نتائج تنفيذ الكتلة المعطاة بشكل متصل (concatenated) مع كل عنصر من عناصر المُعدِّد المعطى، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع collect_concat: [1, 2, 3, 4].collect_concat ...

يعيد التابع id2name الاسم أو السلسلة نصية التي تمثل الرمز. البنية العامة id2name→ string‎ القيمة المعادة تعاد سلسلة نصية تمثِّل الاسم أو السلسلة نصية التي تمثل الرمز. أمثلة مثال على استخدام التابع id2name‎: :fred.id2name #=> "fred" :ginger.to_s #=> "ginger"‎ انظر أيضا التابع encoding: يُعيد الترميز الذي يمثل ترميز الرمز التي استُدعي معه. التابع inspect: يعيد سلسلة نصية تمثِّل الرمز التي استُدعي معه. التابع intern: يُعيد الرمز المقابل للسلسلة النصية التي استدعي معها، أو يُنشىء ذلك الرمز إذا لم يكن ...

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

يعيد التابع mtime وقت التعديل للملف المحدَّد. البنية العامة mtime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد تطبيق العملية عليه. القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت تعديل الملف file_name. أمثلة مثال على استعمال التابع mtime: File.mtime("testfile") #=> Tue Apr 08 12:58:04 CDT 2003 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ. التابع ctime: يعيد وقت آخر تغيير أجري على ملف محدَّد. التابع lutime: يعين وقتي ...

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

يُنفِّذ التابع spawn أمرًا محدَّدًا ثم يعيد مُعرِّف العملية الخاصة به. البنية العامة spawn([env,] command... [,options]) → pid spawn([env,] command... [,options]) → pid يشبه التابعُ spawn التابعَ system باستثناء أنّه لا ينتظر إلى أن ينتهي تنفيذ الأمر. يجب على العملية الأب (parent process) أن تستخدم التابع Process.wait لتحصيل حالة الإنهاء للعملية الفرعية، أو تستخدم Process.detach للإبلاغ بعدم الاهتمام بحالتها؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات ميتة (zombie processes). التابع spawn لديه مجموعة من الخيارات لتحديد خاصيات العملية: env: hash name => val ...

يُعيد التّابع list قائمةً بالترميزات المُحمّلة (loaded encodings). البنية العامة list → [enc1, enc2, ...] القيم المعادة: تعاد قائمة بالتّرميزات المُحمّلة. أمثلة بعض الأمثلة عن استخدام التابع list‎: Encoding.list #=> [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>, #<Encoding:ISO-2022-JP (dummy)>] Encoding.find("US-ASCII") #=> #<Encoding:US-ASCII> Encoding.list #=> [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>, #<Encoding:US-ASCII>, #<Encoding:ISO-2022-JP (dummy)>] انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد ...

يعيد التابع to_s اسم ومعرِّف وحالة مهمة فرعية على هيئة سلسلة نصية. البنية العامة to_s → string‎ القيمة المعادة يعاد اسم ومعرِّف وحالة المهمة الفرعية على هيئة سلسلة نصية. انظر أيضًا التابع value: ينتظر اكتمال المهمة الفرعية باستخدام join، ثم يُعيد قيمتها. مصادر قسم التابع to_s‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يعيد التابع name اسم التابع الحر الذي استُدعي معه. البنية العامة name → symbol‎ القيمة المعادة يعاد اسم التابع الحر المعطى. انظر أيضًا التابع inspect: يعيد اسم التابع الأصلي (underlying method). التابع original_name: يعيد الاسم الأصلي للتابع الحر الذي استُدعي معه. مصادر قسم التابع name‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

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

يغلق التابع close مجرى مجلد محدَّدٍ. بدءًا من الإصدار 2.3، أصبح يُتجاهَل استدعاء هذا التابع مع مجلدٍ مغلق. البنية العامة close → nil القيمة المعادة تُعاد القيمة nil بعد إغلاق المجلد المعطى. أمثلة مثال عن استخدام التابع close: d = Dir.new("testdir") d.close #=> nil انظر أيضًا التابع open: يفتح مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه.  مصادر قسم التابع close في الصنف Dir في توثيق روبي الرسمي.

يجعل التابع compare_by_identity الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. البنية العامة compare_by_identity → hsh القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد يقارن مفاتيحه بواسطة مُعرِّفاتها. أمثلة مثال على استعمال التابع compare_by_identity: h1 = { "a" => 100, "b" => 200, :c => "c" } h1["a"] #=> 100 h1.compare_by_identity h1.compare_by_identity? #=> true h1["a".dup] #=> nil # different objects. h1[:c] ...

ينشئ التابع gm توقيتا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيرها وفق التوقيت العالمي الموحد UTC ‏(GMT). يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون nil، أو قد تُحذف). سيُطلق الاستثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع to_a. البنية العامة gm(year) → time gm(year, month) → time gm(year, month, day) → time gm(year, month, day, hour) → time gm(year, month, day, hour, min) ...

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

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

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

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

يبدأ التابع garbage_collect عملية جمع المهملات (garbage collection)، إلّا إذا عُطِّلت يدويًا. يُعرَّف هذا التابع عبر وسائط الكلمات المفتاحية (keyword arguments) المُعيَّنة افتراضيًا للقيمة true: def GC.start(full_mark: true, immediate_sweep: true); end يمكنك تعيين القيمة false للمعامل full_mark لتنفيذ الوحدة GC الثانوية. ويمكنك تعيين القيمة false للمعامل immediate_sweep لتأجيل الكنس (sweeping، استخدام الكنس الكسول [lazy sweep]). ملاحظة: تعتمد وسائط الكلمات المفتاحية على التطبيق والاصدار المُستخدم من روبي. لا يُضمن أن تبقى متوافقةً مستقبلًا، وقد يتم تجاهلها إذا كان التطبيق الأساسي لا يدعمها. ...

يُطلق الاستثناء Interrupt عند استقبال إشارة المقاطعة (interrupt signal)، عادةً لأن المستخدم ضغط على Ctrl-C (على معظم منصات POSIX). وعلى هذا النحو، فهو صنف فرعي من SignalException. begin puts "Press ctrl-C when you get bored" loop {} rescue Interrupt => e puts "Note: You will typically use Signal.trap instead." end ستُنتج عند تنفيذها: Press ctrl-C when you get bored ثم انتظر إلى أن يُقاطع بالضغط على Ctrl-C، وحينها ستطبع المخرجات التالية: Note: You will typically use Signal.trap instead. مصادر قسم الصنف ...

يعيد التابع rect المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. البنية العامة rect → array rectangular → array‎ القيمة المعادة تعاد المصفوفة [num, 0] إذ num يمثل العدد المعطى. انظر أيضا التابع rectangular: يعيد المصفوفة [num, 0] إذ num يمثل العدد الذي استُدعي معه. مصادر قسم التابع rect‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يعيد التابع names قائمة بأسماء الأجزاء المُلتقِطَة (captures) في التعبير النمطي. يشبه التابع names التابع mtch.regexp.names. البنية العامة names→ [name1, name2, ...]‎ القيمة المعادة تعاد مصفوفة من السلاسل النصية تحوي أسماء الأجزاء المُلتقِطَة (captures). أمثلة مثال على استخدام التابع names‎: /(?<foo>.)(?<bar>.)(?<baz>.)/.match("hoge").names #=> ["foo", "bar", "baz"] m = /(?<x>.)(?<y>.)?/.match("a") #=> #<MatchData "a" x:"a" y:nil> m.names #=> ["x", "y"]‎ انظر أيضا ...

يضيف التابع add الخيط المُمرَّر إليه إلى مجموعة الخيوط التي استدعي معها. انتبه إلى أن الخيط سيزال من أية مجموعة خيوط أضيف إليها مسبقًا. البنية العامة add(thread) → thgrp المعاملات thread الخيط المراد إضافته إلى المجموعة المعطاة. القيمة المعادة تعاد مجموعة الخيوط المعطاة بعد إضافة الخيط thread إليها. أمثلة مثال على استعمال التابع add: puts "Initial group is #{ThreadGroup::Default.list}" tg = ThreadGroup.new t1 = Thread.new { sleep } t2 = Thread.new { sleep } puts "t1 is #{t1}" puts "t2 is #{t2}" tg.add(t1) puts "Initial group now ...

يعيّن التابع DEBUG عند استدعائه بالشكل DEBUG = num قيمة مستوى تصحيح المهمة الفرعية (thread debug level) إلى القيمة num. متوفر فقط في حالة تصريفه (compiled) مع الخيار THREAD_DEBUG = -1. البنية العامة DEBUG = num‎ انظر أيضا التابع DEBUG: يُعيد مستوى التصحيح في المهمة الفرعية (thread debug level). مصادر قسم التابع DEBUG=‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يعيد التابع hash القيمة hash للعدد العشري الذي استدعي معه. البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash للعدد العشري المعطى. انظر أيضا التابع hash: يعيد القيمة hash للكائن الذي استدعي معه. التابع to_int: يحول العدد العشري الذي استدعي معه إلى عدد صحيح. مصادر قسم التابع hash في الصنف Float في توثيق روبي الرسمي.

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