نتائج البحث

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

يجلب التابع last آخر عنصر أو آخر n عنصر من مصفوفة. البنية العامة last → obj or nil last(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة التي يراد جلبها من المصفوفة المعطاة. القيم المعادة يعاد العنصر الأخير من المصفوفة المعطاة إن لم يمرَّر أي وسيط، أو تعاد مصفوفة جديدة تحوي آخر n عنصر من المصفوفة المعطاة. إن كانت المصفوفة فارغة، فستعاد القيمة nil إن لم يمرَّر أي وسيط، أو تعاد مصفوفة فارغة إن أعطي الوسيط n. أمثلة ...

يعيد التابع names قائمة بأسماء الأجزاء المُلتقطة (captures) على هيئة مصفوفة من سلاسل نصية. البنية العامة names→ [name1, name2, ...]‎ القيمة المعادة تعاد قائمة بأسماء الأجزاء المُلتقطة (captures) على هيئة مصفوفة من سلاسل نصية. أمثلة مثال على استخدام التابع names‎: /(?<foo>.)(?<bar>.)(?<baz>.)/.names #=> ["foo", "bar", "baz"] /(?<foo>.)(?<foo>.)/.names #=> ["foo"] /(.)(.)/.names #=> []‎ انظر أيضًا التابع named_captures: يُعيد جدول Hash يحتوي معلومات حول الالتقاطات المسماة (named captures) للتعبير النمطي الذي استُدعي معه. التابع options: يُعيد مجموعة البتات (bits) المقابلة للخيارات المستخدمة عند إنشاء الكائن Regexp. مصادر قسم التابع names‎ في ...

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

يعيد التابع class صنف الكائن المعطى. يجب أن يُستدعى هذا التابع دائمًا مع مستقبل (receiver) صريح، إذ أنَّ class هي كلمةٌ محجوزةٌ في روبي. البنية العامة class → class القيم المعادة يعاد صنف الكائن المعطى المراد معرفة صنفه. أمثلة مثالٌ عن استخدام التابع class: 1.class #=> Integer self.class #=> Object انظر أيضًا التابع clone: يُنتج نسخةً سطحيةً من الكائن المعطى. التابع dup: ينتج نسخةً سطحية من الكائن. التابع tap: يُدخل الكائن المعطى إلى الكتلة ...

يمثل الصنف RubyVM الآلة الافتراضية (VM، اختصار إلى virtual machine). الثوابت DEFAULT_PARAMS يعرض هذا الثابت معاملات الآلة الافتراضية (VM) الأولية (default). لاحظ أنّ تغيير تلك القيم لا يؤثر على طريقة تشغيل الآلة الافتراضية. المواصفات ليست مستقرة، ويجب أن لا تعتمد على هذه القيمة. INSTRUCTION_NAMES يمثِّل هذا الثابت أسماء التعليمات. OPTS يحتوي هذا الثابت على خيارات الآلة الافتراضية (vm). توابع الصنف العامة stat يعيد كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). مصادر صفحة الصنف RubyVM في توثيق روبي الرسمي. ...

يُعيد التابع values_at قيم أعضاء البنية المقابلة لكل معامل مُمرَّر إليه على هيئة مصفوفة. البنية العامة values_at(selector, ...) → array‎ المعاملات selector قد يكون هذا المعامل إما موضعًا (عدد صحيح)، أو مجالًا من المواضع (كما في Array.values_at). القيمة المعادة تعاد قيم أعضاء البنية المقابلة لكل معامل selector معطى على هيئة مصفوفة. أمثلة مثال على استخدام التابع values_at‎: Customer = Struct.new(:name, :address, :zip) joe = Customer.new("Joe Smith", "123 Maple, Anytown NC", 12345) joe.values_at(0, 2) #=> ["Joe Smith", 12345]‎ انظر أيضًا التابع values: ...

لدى لغة روبي العديد من الطرق للتحكم في مسار تنفيذ البرنامج، وكل البنى المذكورة هنا تعيد قيمةً. في الاختبارات الشرطيّة في بنى التحكّم، تعدّ القيمة nil و false على أنّها قيم خطأ، بينما تُعدُّ القيمة true وأيّ كائن آخر على أنه قيم صحيحة. وفي هذا التوثيق، سنستخدم true للتعبير عن القيم الصحيحة و false للتعبير عن القيم الخطأ. بنية If الشرطية أبسط أشكال بنية if الشرطيّة يحتوي على جزأين، الاختبار الشّرطي، والجزء التّنفيذي then. هذه بنية if بسيطة: if true ...

يتحقق التابع member?‎ من احتواء كائن قابل للتعداد على عنصر محدَّد (مرة واحدة أو أكثر). يُتحقَّق من عملية التساوي عبر المعامل ==. البنية العامة member?(obj) → true or false المعاملات obj الكائن المراد التحقق من تساويه مع أحد عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد القيمة true إن احتوى الكائن القابل للتعداد المعطى على العنصر obj، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال التابع member?‎: a = [1, 2, 3, 4, 5, 0] a.drop_while { |i| i < 3 ...

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

يعيد التابع parameters معلومات عن معاملات التابع الحر الذي استُدعي معه على شكل مصفوفة. البنية العامة parameters → array‎ القيمة المعادة تعاد مصفوفة تحوي معلومات عن معاملات التابع الحر الذي استُدعي معه على شكل مصفوفة. أمثلة مثال على استخدام التابع parameters‎: def foo(bar); end method(:foo).parameters #=> [[:req, :bar]] def foo(bar, baz, bat, &blk); end method(:foo).parameters #=> [[:req, :bar], [:req, :baz], [:req, :bat], [:block, :blk]] def foo(bar, *args); end method(:foo).parameters #=> [[:req, :bar], [:rest, :args]] def foo(bar, baz, *args, &blk); end method(:foo).parameters #=> [[:req, :bar], [:req, :baz], [:rest, ...

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

يكرر التابع downto‎ تنفيذ الكتلة البرمجية المعطاة مع تمرير الأعداد تنازليًا بداية من العدد الذي استُدعيت معه وحتى العدد المعطى. في حال عدم تمرير أي كتلة برمجية، فسيُعاد الكائن Enumerator. البنية العامة downto(limit) {|i| block } → self downto(limit) → an_enumerator‎ المعاملات limit‎ الحد الأدنى لعملية التكرار. القيمة المعادة في حال تمرير كتلة، فسيعاد ناتج تنفيذ هذه الكتلة مع تمرير العدد المعطى في كل مرة تنازليًّا حتى الوصول إلى العدد limit، وإلا فسيعاد الكائن Enumerator. أمثلة مثال على ...

يحاول التابع try_convert تحويل الكائن المُمرَّر إليه إلى النوع Hash باستخدام التابع to_hash. يعيد التابع كائن من النوع Hash إن نجحت عملية التحويل أو القيمة nil إذا فشلت العملية لأي سبب. ash.try_convert({1=>2}) # => {1=>2} Hash.try_convert("1=>2") # => nil البنية العامة try_convert(obj) → hash or nil المعاملات obj الكائن المراد تحويله إلى النوع Hash. القيمة المعادة يعاد كائن من النوع Hash يمثِّل ناتج تحويل الكائن obj إن نجحت عملية التحويل، أو تعاد القيمة nil إذا فشلت العملية لأي ...

يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. إن لم يكن هنالك ملف، فسيُطلَق الخطأ ArgumentError. البنية العامة fileno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف الرقمي (numeric file descriptor) للملف الحالي. أمثلة مثالٌ على استخدام التابع fileno: ARGF.fileno #=> 3 انظر أيضًا التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع filename: يعيد اسم الملف الحالي. التابع lineno: يجلب ...

يعيد التابع keys جميع متغيرات البيئة في مصفوفة. البنية العامة keys → Array القيمة المعادة تُعاد مصفوفة تحوي جميع متغيرات البيئة. انظر أيضًا التابع key: يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. التابع values: يعيد جميع قيم متغيرات البيئة في مصفوفة. مصادر قسم التابع keys في الصنف ENV في توثيق روبي الرسمي.

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

يعيد التابع list مصفوفة تحوي جميع الكائنات Thread الموجودة والتابعة لمجموعة الخيوط التي استدعيت معه. البنية العامة list → array القيمة المعادة تعاد مصفوفة تحوي جميع الكائنات Thread الموجودة والتابعة لمجموعة الخيوط المعطاة. أمثلة مثال على استعمال التابع list: ThreadGroup::Default.list #=> [#<Thread:0x401bdf4c run>] انظر أيضًا التابع add: يضيف الخيط المُمرَّر إليه إلى مجموعة الخيوط التي استدعي معها. التابع enclose: يمنع إضافة أو إزالة أي خيط من مجموعة الخيوط التي استدعيت معه. التابع ?enclosed: يتحقق إذا كانت مجموعة الخيوط ...

يعيد التابع to_int العدد الصحيح الذي استُدعي معه دون تغيير . هذا التابع يكافئ to_i. البنية العامة to_int → integer‎ القيمة المعادة يعاد العدد الصحيح المعطى دون تغيير. انظر أيضا التابع to_s: يحول العدد الصحيح الذي استدعي معه إلى سلسلة نصية ممثلًا بأساس محدَّد.  التابع to_i: يعيد العدد الذي استُدعي معه دون تغيير. التابع to_r: يحول العدد الذي استُدعي معه إلى عدد جذري (rational). التابع to_f: يحول العدد الصحيح الذي استُدعي معه إلى عدد عشري. مصادر قسم التابع to_int‎ في الصنف Integer‎ ...

يُرجِع التابع rewind المؤشر إلى بداية الملف الحالي عند بداية المدخلات (input) ويعيد تعيين رقم السطر ARGF.lineno إلى القيمة 0. البنية العامة rewind → 0 القيم المعادة يعاد العدد 0 عند نجاح العملية. أمثلة مثالٌ على استخدام التابع rewind: ARGF.readline #=> "This is line one\n" ARGF.rewind #=> 0 ARGF.lineno #=> 0 ARGF.readline #=> "This is line one\n" انظر أيضًا التابع pos: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى ARGF. ...

يعيد التابع inspect سلسلة نصية تحتوي وصفًا لهذه البنية. البنية العامة to_s→ string inspect→ string‎ القيمة المعادة تعاد سلسلة نصية تحتوي وصفًا لهذه البنية. انظر أيضًا التابع hash: يعيد القيمة hash استنادًا إلى محتويات هذه البنية. التابع length: يُعيد عدد أعضاء البنية. مصادر قسم التابع inspect‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يكافئ التابع setpgrp الاستدعاء setpgid(0,0)‎. هذا التابع غير متاح على جميع المنصات. البنية العامة setpgrp → 0 القيم المعادة تعاد القيمة 0 بعد اكتمال تنفيذ العملية. انظر أيضًا التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع setpgid: يضبط مُعرِّف المجموعة المالكة لعملية محدَّدة أو العملية الحالية. مصادر قسم التابع setpgrp في الصنف Process في توثيق روبي الرسمي.

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

يعيد التابع last_status حالة آخر عملية ابن نفِّذَت في الخيط الحالي. البنية العامة last_status → Process::Status or nil القيم المعادة يعاد كائن من النوع Process::Status يمثِّل حالة آخر عملية ابن نفِّذَت في الخيط الحالي، أو تعاد القيمة nil إن لم تُنفَّذ أية عملية ابن على الإطلاق في الخيط الحالي. أمثلة مثال على استعمال التابع last_status: Process.wait Process.spawn("ruby", "-e", "exit 13") Process.last_status #=> #<Process::Status: pid 4825 exit 13> يوضح المثال التالي كيفية استعمال التابع last_status عند عدم وجود عمليات ابن منفَّذة في ...

يتحقّق التّابع ascii_compatible?‎ من توافق ترميز محدد مع الترميز ASCII. البنية العامة ascii_compatible? → true or false القيم المعادة تُعاد القيمة true في حال توافق الترميز المعطى مع التّرميز ASCII، أو تُعاد القيمة false خلاف ذلك. أمثلة مثالٌ عن استخدام التابع ascii_compatible?‎: Encoding::UTF_8.ascii_compatible? #=> true Encoding::UTF_16BE.ascii_compatible? #=> false انظر أيضًا التّابع ?dummy: يتحقّق من التّرميز الزّائف. التابع ?compatible: يتحقّق من توافق كائنين مع بعضهما بعضًا. التّابع replicate: يُنشئ نسخة مطابقة من ترميز الكائن. مصادر قسم التابع ...

يعيد التابع entries‎ مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط encoding الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات. البنية العامة entries( dirname ) → array entries( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المراد معرفة محتوياته. encoding ترميز المجلد. القيمة المعادة تُعاد مصفوفةٌ تحوي جميع أسماء الملفات في المجلد المحدد. أمثلة مثال عن استخدام التابع entries ...

ينفّذ التابع fdiv عملية القسمة، ويعيد القيمة كعدد عشري. البنية العامة fdiv(numeric) → float‎ المعاملات numeric‎ عدد يمثِّل المقسوم عليه. القيمة المعادة يعاد عدد عشري يمثِّل ناتج عملية قسمة العدد الجذري المعطى على العدد numeric. أمثلة مثال على استخدام التابع fdiv‎: Rational(2, 3).fdiv(1) #=> 0.6666666666666666 Rational(2, 3).fdiv(0.5) #=> 1.3333333333333333 Rational(2).fdiv(3) #=> 0.6666666666666666‎ انظر أيضًا المعامل /: ينفذ عملية القسمة. المعامل -: ينفذ عملية ...

يُعيد التابع tell موضع المؤشر الحالي (بالبايت) للمجرى الذي استدعي معه. البنية العامة tell → integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل موضع الموشر الحالي للمجرى المعطى بالبايت. أمثلة مثال على استخدام التابع tell‎: f = File.new("testfile") f.pos #=> 0 f.gets #=> "This is line one\n" f.pos #=> 17‎ انظر أيضًا التابع pos: يُعيد موضع المؤشر الحالي بدءًا من بداية الملف (بالبايت) للمجرى الذي استدعي معه. التابع rewind: يعيد مؤشر المجرى الذي استُدعي معه إلى موضع ...

يعيد التابع extname لاحقة الملف المعطى. لاحقة الملف هي جزء من اسمه وتتوضع في مساره بعد آخر نقطة فيه. إن كان المسار هو لملف الملف يبدأ بنقطة (dotfile) أو يبدأ المسار بنقطة، فلن يعامل معها على أنها بداية لاحقة الملف. البنية العامة extname(path) → string المعاملات path مسار الملف المراد استخراج لاحقته. القيمة المعادة تعاد سلسلة نصية تمثِّل لاحقة الملف ذي المسار path، أو تعاد سلسلة نصية فارغة إن كان النقطة آخر المسار path أو لم يكن هنالك لاحقة للملف. أمثلة ...

ر يعيد التابع gid المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. البنية العامة gid → integer Process::GID.rid → integer Process::Sys.getgid → integer القيم المعادة يعاد عدد صحيح يمثِّل المُعرِّف الحقيقي للعملية الحالية. أمثلة مثال على استعمال التابع gid: Process.gid #=> 500 انظر أيضًا التابع egid: يعيد مُعرِّف المجموعة الفعال (effective group ID) المالكة لهذه العملية. التابع getpgid: يعيد مُعرِّف المجموعة المالكة لعملية محدَّدة. التابع gid=‎: يضبط عند استدعائه بالشكل gid= integer مُعرِّف المجموعة المالكة للعملية الحالية إلى القيمة integer. مصادر قسم التابع ...

يعيد التابع cbrt الجذر التكعيبي للعدد المعطى. مجال التعريف: (‎-INFINITY ، INFINITY). المجال المقابل: (‎-INFINITY ، INFINITY). البنية العامة cbrt(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة الجذر التكعيبي للعدد x المعطى. أمثلة مثال على استخدام التابع cbrt‎: -9.upto(9) {|x| p [x, Math.cbrt(x), Math.cbrt(x)**3] } #=> [-9, -2.0800838230519, -9.0] # [-8, -2.0, -8.0] # [-7, -1.91293118277239, -7.0] # [-6, -1.81712059283214, -6.0] # [-5, -1.7099759466767, -5.0] # [-4, -1.5874010519682, -4.0] # ...

يُطلق الاستثناء SystemExit من قبل التعليمة exit لبدء عملية إنهاء الشيفرة البرمجية. توابع الصنف العامة new يُنشئ استثناءً جديدًا من النوع SystemExit مع تحديد حالة ورسالة الاستثناء. توابع النسخة العامة status يعيد قيمة الحالة المرتبطة بالكائن SystemExit الذي استُدعي معه. success?‎ يتحقق من نجاح عملية الإنهاء. مصادر صفحة الصنف SystemExit في توثيق روبي الرسمي.

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

يتحقق التابع tty?‎ إن كان المجرى الذي استدعي معه مرتبطًا بجهاز طرفي (tty). البنية العامة tty? → true or false‎ القيمة المعادة تعاد القيمة true إن كان المجرى الذي استدعي معه مرتبطًا بجهاز طرفي (tty)، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع tty?‎: File.new("testfile").isatty #=> false File.new("/dev/tty").isatty #=> true‎ انظر أيضًا التابع binmode?‎: يتحقق إن كان مجرى د/خ في الوضع الثنائي (binary mode). التابع closed?‎: يتحقق إن كان مجرى د/خ مغلقًا تمامًا. التابع ...

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

يجلب التابع lineno رقم السطر الحالي للمجرى ARGF ككُل. يمكن تعيين هذه القيمة يدويًا عبر استدعاء هذا التابع بالشكل lineno = integer. البنية العامة lineno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل رقم السطر الحالي للمجرى ARGF ككل. أمثلة مثالٌ على استخدام التابع lineno: ARGF.lineno #=> 0 ARGF.readline #=> "This is line 1\n" ARGF.lineno #=> 1 انظر أيضًا التابع lineno: يعيِّن عند استدعائه بالشكل lineno = integer رقم السطر الحالي للمجرى ARGF ككُل. التابع file: يعيد ...

يحول التابع to_s‎ العدد الصحيح الذي استدعي معه إلى سلسلة نصية ممثلًا بأساس محدَّد. البنية العامة to_s(base=10) → string‎ المعاملات base‎ عدد صحيح يمثل أساس العدد الصحيح المراد تمثيله به. تترواح هذا المعامل بين 2 و 36. القيمة الافتراضية هي: 10 (التمثيل العشري). القيمة المعادة تعاد سلسلة نصية تحتوي على العدد الصحيح المعطى وفق الأساس base. أمثلة مثال على استخدام التابع to_s‎: 12345.to_s #=> "12345" 12345.to_s(2) #=> "11000000111001" 12345.to_s(8) ...

يعيد التابع seed قيمة البذرة التي استُخدمَت في إنشاء المولِّد. قد يُستعمَل هذا التابع لإنشاء مولِّدٍ آخر بنفس الحالة في وقتٍ لاحق، مسببًا بذلك توليد نفس السلسلة من الأعداد. البنية العامة seed → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل قيمة البذرة التي استخدمت في إنشاء المولِّد. أمثلة مثالٌ عن استخدام التابع seed: prng1 = Random.new(1234) prng1.seed #=> 1234 prng1.rand(100) #=> 47 prng2 = Random.new(prng1.seed) prng2.rand(100) #=> 47 انظر أيضًا التابع new: يُنشئ مولِّد أعدادٍ شبه ...

الصنف MatchData هو نوع المتغير الخاص ‎$~‎ ، كما أنه نوع الكائنات المُعادة من Regexp.match و Regexp.last_match. فهو يغلف ويستوعب جميع نتائج التطابق مع تعبير نمطي. يمكن الوصول إلى النتائج من خلال المتغيرات الخاصة ‎$&‎ و ‎$'‎ و $ و ‎$`‎ و ‎$1 و ‎$2 وهكذا دواليك. توابع الصنف العامة (Public Class Methods) == يتحقق المعامل == من تطابق كائنان من النوع matchdata إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة. [] تتصرف الكائنات MatchData كمصفوفة، لذا يمكن الوصول إليها باستخدام تقنيات ...

يجلب التابع fetch‎ قيمة متغير بيئة ذي اسمٍ محدَّدٍ؛ في حال لم يكن ذلك الاسم موجودًا ولم يُمرَّر أي شي إلى التابع ولا حتى كتلة برمجية، فسيٌطلق الخطأ KeyError. أمَّا في حال تمرير كتلة، فستُستدعَى مع الاسم الذي لم يُعثَر عليه ويعاد ناتج تنفيذها، أو إذا أعطي الوسيط default، فستعاد قيمته إن لم تٌعطَ أي كتلة في تلك الحالة. البنية العامة fetch(name) → value fetch(name, default) → value fetch(name) { |missing_name| ... } → value المعاملات name اسم متغير البيئة المراد البحث ...

يُعيد التابع source_location اسم ملف روبي المصدري ورقم السَّطر الحاوي على كتلة proc محدَّدة، أو يُعيد القيمة nil إذا كانت هذه الكتلة غير مُعرَّفة في روبي (مثل native). البنية العامة source_location → [String, Integer] القيم المعادة تُعاد مصفوفةٌ تحوي سلسلةً نصيَّةً (String) تُمثِّل اسم ملف روبي المصدري وعددًا صحيحًا (Integer) يمثِّل رقم السطر الذي يحتوي كتلة proc المُحدَّدة، أو تُعاد القيمة nil إذا كانت هذه الكتلة غير مُعرَّفة في روبي. انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن ...

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

يبدأ التابع garbage_collect تجميع البيانات المهملة، ما لم تُعطَّل يدويًا. عُرِّف هذا التابع مع وسائط مسماة قِيَمَها الافتراضية هي true: def GC.start(full_mark: true, immediate_sweep: true); end ملاحظة: تعتمد الوسائط المسماة هذه على التنفيذ والإصدار المستعمل. ولا يُضمن أن تظل متوافقة في المستقبل، ويمكن تجاهلها إذا كان التنفيذ الأساسي لا يدعمها. البنية العامة garbage_collect → nil include GC; garbage_collect → nil garbage_collect(full_mark: true, immediate_sweep: true) → nil المعاملات full_mark استعمل القيمة false مع هذا المعامل لتنفيذ عملية GC ثانوية. القيمة الافتراضية هي: true. immediate_sweep استعمل ...

يتحقَّق التابع ?respond_to من استجابة الكائن الذي استدعي معه للتابع المُمرَّر إليه. ستُشمَل التوابع الخاصة والمحميَّة في عملية البحث فقط إذا مُرِّرت القيمة true إلى المعامل الثاني في التابع. إذا كان التابع غير مُنفَّذ، مثل التابع Process.fork في أنظمة ويندوز، والتابع File.lchmod في أنظمة GNU/Linux وغيرهما، فستُعاد القيمة false. إذا كان التابع غير معرَّفٍ، فسيُستدعى التابع ?respond_to_missing وتُعاد النتيجة. إن أعطي معامل اسم التابع بشكل سلسلةٍ نصية، فستُحوَّل هذه السلسلة النصية إلى رمز. البنية العامة respond_to?(symbol, include_all=false) → true or ...

إن كان العدد المُمرَّر إلى التابع numeric من نفس نوع العدد الذي استُدعي معه، فسيعيد مصفوفة تحوي هذين العددين. خلاف ذلك، سيحول هذين العددين إلى النوع Float ويعيدهما في مصفوفة. تُستخدَم هذه الآلية من التحويل للتعامل مع العمليات العددية التي تكون أنواع الأعداد فيها مختلفة؛ الغرض الأساسي من هذا التابع هو إيجاد نوعٍ متوافق بين عددين أو تحويلهما إلى النوع نفسه. البنية العامة coerce(numeric) → array‎ المعاملات numeric‎ العدد الثاني الذي سيُتحقق من مطابقة نوعه للعدد المعطى. القيمة ...

يعيد التابع count عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة (يتحقق من ذلك باستعمال المعامل ==) أو عدد العناصر التي تحقق شرطًا محددًا. البنية العامة count → int count(obj) → int count { |item| block } → int المعاملات obj كائن يراد معرفة عدد العناصر المتساوية مع قيمته في المصفوفة المعطاة. القيم المعادة يعاد عدد صحيح (أي من النوع int) يمثِّل عدد عناصر المصفوفة المعطاة إن لم يمرَّر أي شيء إلى الدالة. إن مرِّرت الوسيط ...

ينشئ التابع inspect نسخةً قابلةً للطباعة من e. البنية العامة inspect → string القيمة المعادة تعاد سلسلة نصية تمثل نسخةً قابلةً للقراءة من e. انظر أيضًا التابع feed: يضبط القيمة المراد إعادتها عبر الاستدعاء yield التالي داخل e. مصادر قسم التابع inspect في الصنف Enumerator في توثيق روبي الرسمي.

يعيد التابع name اسم الوحدة، أو يعيد القيمة nil إن كانت الوحدة مجهولة (anonymous modules). البنية العامة name → string‎ القيمة المعادة يعاد اسم الوحدة، أو القيمة nil إن كانت الوحدة مجهولة. انظر أيضا التابع module_function: ينشئ دوال وحدة (module functions) للتابع المعطى. مصادر قسم التابع name‎ في الصنف Module‎ في توثيق روبي الرسمي.

يُمرِّر التابع all?‎ كل عنصر من عناصر المجموعة التي استدعيت معه إلى الكتلة المعطاة ثمَّ يتحقق من عدم إعادة هذه الكتلة القيمة false أو nil مع كل عنصر من تلك العناصر. إن لم تعطَ أية كتلة، فستُضيف روبي الكتلة { ‎|obj| obj } والتي تدفع التابع لإعادة القيمة true عندما لا تكون قيمة كل عنصر من عناصر المجموعة هي false أو nil. إن مُرِّر نمط إلى التابع all?‎ بدلًا من الكتلة، فسيتحقق من تطابق هذا النمط مع كل عنصر من عناصر المجموعة المعطاة. ...

يحرِّر التابع ‎wait القفل المطبَّق (held) على الكائن mutex وينتظر، ثمَّ يستعيد القفل عند الإستيقاظ. في حال تمرير الوسيط timeout (انظُر فقرة البنية العامة)، يُعيِد هذا التابع بعد مرور timeout ثانية، حتى في حال عدم الإشارة (signal) من خيط آخر (thread). البنية العامة wait(mutex, timeout=nil) المعاملات mutex كائنٌ من النوع Mutex. timeout يمثل عدد الثواني التي يجب أن ينتظرها التابع قبل الإعادة، قيمته الإفتراضية هي: nil. انظر أيضًا التابع signal: يوقظ أول مهمة فرعية من بين المهام الفرعية (threads) التي تنتظر القفل (lock) المعيّن.  ...

يُعيد التابع sync قيمة راية وضع المزامنة (sync mode) للمجرى الذي استدعي معه. عندما تساوي قيمة وضع المزامنة القيمة true، فسيتم إرسال كل المخرجات مباشرةً إلى نظام التشغيل، ولن يُخزّن مؤقتًا في ذاكرة التخزين المؤقتة الداخلية لروبي. البنية العامة sync → true or false‎ القيمة المعادة تعاد قيمة منطقية تمثِّل قيمة راية وضع المزامنة للمجرى المعطى. أمثلة مثال على استخدام التابع sync‎: f = File.new("testfile") f.sync #=> false‎ انظر أيضًا التابع fsync: يكتب مباشرةً جميع البيانات المخزنة في المجرى الذي استدعي معه ...

يعيد التابع fdiv‎ العدد العشري الناتج عن عملية قسمة العدد الذي استُدعي معه على العدد المُمرّر إليه. البنية العامة fdiv(numeric) → float‎ المعاملات numeric‎ الطرف الثاني لعملية القسمة القيمة المعادة يعاد عدد عشري ناتج عن عملية قسمة العدد الذي استُدعي معه على العدد المُمرّر numeric. أمثلة مثال على استخدام التابع fdiv‎: 654321.fdiv(13731) #=> 47.652829364212366 654321.fdiv(13731.24) #=> 47.65199646936475 -654321.fdiv(13731) #=> -47.652829364212366 ‎ انظر أيضا المعامل /: يعيد ناتج عملية القسمة بين عددين. ...

يبحث التابع bsearch باستخدام خوارزمية البحث الثنائي (binary search) عن قيمة من المجال تحقق الشرط المعطى في مدةO (log n) ‎، إذ n يمثل حجم المجال. البنية العامة bsearch {|obj| block } → value‎ يمكنك استخدام هذا التابع بطريقتين: وضع البحث الأدنى (find-minimum mode)، أو وضع البحث العادي (find-any mode). وفي كلتا الحالتين، يجب أن تكون عناصر المجال مُرتبة (sorted) لأجل الكتلة. في وضع البحث الأدنى (يعد هذا خيارًا جيدًا في الحالات العادية)، يجب أن تُعيد الكتلة إما true أو false، ...

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

يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها من الوحدة. هذا يتضمن أسماء الثوابت في الوحدات المُتضمنة إلا إن مُرِّرت القيمة false. لا يوجد ضمانة لمعرفة الترتيب الذي ستُعاد به الثوابت. البنية العامة constants(inherited)→ array‎ المعاملات inherited‎ قيمة منطقية إن كانت false، فلن تشمل المصفوفة المعادة أسماء الثوابت في الوحدات المُتضمنة. القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها من الوحدة. أمثلة مثال على استخدام التابع constants‎: IO.constants.include?(:SYNC) ...

يشبه التابع each_with_index التابع with_index باستثناء أنه لا يوجد إزاحة بادئة لبدء العملية عند قيمة محدَّدة. إن لم تعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator يحوي الفهارس التي كانت الكتلة ستُكرَّر عبرها من الكائن المعطى. البنية العامة each_with_index {|(*args), idx| ... } each_with_index القيمة المعادة يعاد ناتج تكرار الكتلة على فهارس الكائن المُعدِّد المعطى، أو يعاد كائنٌ مُعدِّدٌ جديد إن لم تُعطَ الكتلة. انظر أيضًا التابع each: يتكرر عبر الكتلة المعطاة وفقًا للكائن المُعدِّد الذي استدعي معه والطريقة التي أُنشِئ ...

يتحقق التابع nil?‎ إن كان الكائن الذي استدعي معه هو الكائن nil. البنية العامة nil?→ true‎ القيمة المعادة تعاد القيمة true إن كان الكائن المعطى هو الكائن nil. خلا ذلك، تعاد القيمة true. انظر أيضا التابع inspect: يعيد دائمًا السلسلة النصية "nil". مصادر قسم التابع nil?‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

يعيد التابع values‎ مصفوفة تضم جميع قيم متغيرات البيئة. البنية العامة values → Array القيمة المعادة تُعاد مصفوفة تضم جميع قيم متغيرات البيئة. انظر أيضًا التابع keys: يعيد جميع متغيرات البيئة في مصفوفة. التابع key: يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. مصادر قسم التابع values في الصنف ENV في توثيق روبي الرسمي.

يعيد التابع to_write_io نسخةً من الصنف IO مرتبطةً بالمجرى ARGF للكتابة عليها في حال كان الوضع inplace مفعَّلًا. البنية العامة to_write_io → io القيم المعادة يعاد كائن من النوع IO مرتبط بالمجرى ARGF. انظر أيضًا التابع write: يكتب السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا. التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. التابع ...

يقرأ التابع to_a الملف الحالي في المجرى ARGF بشكل كامل ثم يضع محتوياته في مصفوفة. البنية العامة to_a(sep=$/) → array to_a(limit) → array to_a(sep, limit) → array المعاملات sep المحرف المستعمل كفاصل سطري في الملف المراد القراءة منه. القيمة الافتراضية هي: /$. limit عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. القيم المعادة تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى ARGF، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. أمثلة مثال ...

يتحقَّق التابع ?instance_variable_defined إذا كان متغيِّر النسخة (instance variable) المُمرَّر إليه مُعرَّفًا في الكائن المعطى. تُحوَّل الوسائط النصية التي من النوع String إلى رموزٍ (symbols). البنية العامة instance_variable_defined?(symbol) → true or false instance_variable_defined?(string) → true or false المعاملات symbol الرمز المراد التحقُّق من تعريفه في الكائن. string سلسلةٌ نصيةٌ من النوع String تُحوَّل إلى رمزٍ ثم يُتحقق من تعريفها في الكائن. القيم المعادة تُعاد القيمة true إذا كان متغيِّر النسخة symbol أو string مُعرَّفًا في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة ...

يوقظ التابع run المهمة الفرعية، ويجعلها متاحة للجدولة. انظر أيضًا صفحة تابع النسخة wakeup. البنية العامة run→ thr‎ القيمة المعادة تعاد المهمة الفرعية المعطاة. أمثلة مثال على استخدام التابع run‎: a = Thread.new { puts "a"; Thread.stop; puts "c" } sleep 0.1 while a.status!='sleep' puts "Got here" a.run a.join‎ هذا سوف ينتج: a Got here c انظر أيضًا التابع wakeup:يجعل المهمة الفرعية متاحة للجدولة، ولكن قد تظل معطلة في مجرى الدخل/الخرج (I/O). مصادر قسم التابع run‎ في الصنف Thread‎ في توثيق روبي الرسمي.11

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

يعيد التابع real العدد الذي استدعي معه (الكائن self). البنية العامة real → self‎ القيمة المعادة يعاد العدد المعطى. انظر أيضا التابع real?‎: يعيد القيمة true إن كان num عددًا حقيقيا (أي ليس من النوع Complex). مصادر قسم التابع real‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يُدخل التابع yield_self الكائن المعطى إلى الكتلة (block) ويُعيد ناتج تنفيذ هذه الكتلة. البنية العامة ield_self {|x| block } → an_object المعاملات x الكائن المراد إدخاله إلى الكتلة. block الكتلة المراد تنفيذها على الكائن. القيم المعادة يُعاد الكائن الناتج عن تنفيذ الكتلة block بعد تمرير الكائن المعطى إليها. أمثلة: مثالٌ عن استخدام التابع yield_self: "my string".yield_self {|s| s.upcase } #=> "MY STRING" 3.next.yield_self {|x| x**x }.to_s #=> "256" انظر أيضًا التابع class: يعيد ...

يعيد التابع restore نتيجة تحويل البيانات المُسلسلة (serialized) في المصدر إلى كائن روبي (ربما مع كائنات ثانوية [subordinate objects] مرتبطة به). قد يكون المصدر إما كائنًا من الصنف IO، أو كائنًا يستجيب إلى التابع to_str. في حال تمرير المعامل، فسيتم تمرير كل الكائنات إليه أثناء فك تسلسلها (deserialisation). تنبيه: لا تمرّر أبدًا إلى التابع restore بيانات غير موثوقة (بما في ذلك المدخلات التي يرسلها المستخدم). البنية العامة restore( source [, proc] ) → obj‎ المعاملات source‎ إمَّا كائنٌ من الصنف IO، أو كائنٌ يستجيب إلى التابع to_str يمثل المصدر. proc‎ ...

يُطلق الاستثناء IOError عند فشل عملية إدخال/إخراج (IO operation) في روبي. File.open("/etc/hosts") {|f| f << "example"} #=> IOError: not opened for writing File.open("/etc/hosts") {|f| f.close; f.read } #=> IOError: closed stream تذكر أنَّ فشل بعض عمليات الإدخال/الإخراج قد يؤدي إلى إطلاق الاستثناء SystemCallError، وهذا الاستثناء ليس متفرع من الصنف IOError. File.open("does/not/exist") #=> Errno::ENOENT: No such file or directory - does/not/exist مصادر صفحة الصنف IOError في توثيق روبي الرسمي.

يتحقَّق المعامل == من تساوي الحالة الداخلية لمولِّدين. المولِّدات المتكافئة ستعيد السلسلة نفسها من الأرقام شبه العشوائية (pseudo-random). سيمتلك مولِّدين اثنين عادةً الحالة نفسها فقط إذا أُنشئ كلٌّ منهما باستخدام البذرة (seed) نفسها. البنية العامة prng1 == prng2 → true or false المعاملات prng1 مولِّد الأعداد شبه العشوائيَّة الأول. prng2 مولِّد الأعداد شبه العشوائيَّة الثاني. القيم المعادة تُعاد القيمة true إذا كان للمولِّدان نفس الحالة الداخلية، خلاف ذلك تُعاد القيمة false. أمثلة مثالٌ عن استخدام المعامل ==: Random.new == Random.new ...

يجلب التابع take أول n عنصر من مصفوفة. إن مرِّر عدد سالب إلى هذا التابع، فسيُطلَق الخطأ ArgumentError. البنية العامة take(n) → new_ary المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة المعطاة. القيم المعادة تعاد مصفوفة جديدة تحوي العناصر n الأولى الموجودة في المصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع take: a = [1, 2, 3, 4, 5, 0] a.take(3) #=> [1, 2, 3] انظر ...

الصنف BasicObject هو الصنف الأب لجميع الأصناف في روبي، وهو صنف فارغ. يمكن استخدام الصنف BasicObject لإنشاء هرميات كائنية (object hierarchies) مستقلة عن الهرمية الكائنية للغة روبي، أو لإنشاء مغلفات الكائنات (proxy objects) مثل الصنف Delegator، أو حيث يجب تجنب إفساد مجال الأسماء (namespace pollution) من قبل توابع وأصناف روبي. لتجنب إفساد الصنف BasicObject للمستخدمين الآخرين، يجب إنشاء صنف فرعي من الصنف BasicObject تحت اسم مناسب بدلاً من تعديل BasicObject مباشرةً: class MyObjectSystem < BasicObject end لا يتضمَّن الصنف BasicObject الوحدة Kernel ...

يضيف التابع push الكائن المُمرَّر إليه إلى الطابور. إن كان الطابور ممتلئًا، فسينتظر هذا التابع حتى تصبح هناك مساحة شاغرة، ما لم تكن قيمة المعامل non_block المُمرَّر إلى التابع هي true. البنية العامة push(object, non_block=false) enq(object, non_block=false) <<(object)‎ المعاملات object‎ كائن. non_block‎ قيمة منطقية تحدد وضع عدم الحجز. إن كانت true، فلن يتم تعليق المهمة فرعية، وسيُطلق الاستثناء ThreadError. القيمة الافتراضية هي: false. انظر أيضًا التابع pop: يجلب بيانات من الطابور. مصادر قسم التابع push‎ في الصنف SizedQueue‎ في توثيق روبي الرسمي.

يُستخدم التابع ?equal في تحديد هويّة الكائن؛أي أنَّ (a.equal?(b محقَّقٌ فقط إذا وفقط إذا كان a  و b هما نفس الكائن. لذلك، لا يجب نهائيًا تجاوزه وإهماله في الأصناف الفرعية خلافًا للمعامل ==. البنية العامة equal?(other) → true or false المعاملات other الكائن الآخر الذي سيُتحقَق من تساويه مع الكائن الأصل. القيم المعادة تُعاد القيمة true إذا كان المعامل other والكائن المعطى هما نفس الكائن؛ خلاف ذلك، تُعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ?equal: other = obj.dup obj == ...

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

يرمى الاستثناء FloatDomainError عند محاولة تحويل قيم عشرية خاصة (مثل القيمة Infinity أو NaN على وجه الخصوص) إلى أصناف رقمية لا تدعمها. Float::INFINITY.to_r #=> FloatDomainError: Infinity مصادر صفحة الصنف FloatDomainError في توثيق روبي الرسمي.

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

يحذف التابع compact!‎ كل العناصر ذات القيمة nil من المصفوفة التي استدعيت معه ثم يعيدها. إن لم تحوي المصفوفة أي عنصر يساوي nil، فسيعيد التابع compact!‎ القيمة nil. البنية العامة compact! → ary or nil القيم المعادة تعاد المصفوفة نفسها المعطاة بعد حذف جميع العناصر ذات القيمة nil منها، أو تعاد القيمة nil إن لم تحوِ تلك المصفوفة على أي عنصر تساوي قيمة القيمة nil. أمثلة أمثلة على استخدام التابع compact!‎: [ "a", nil, "b", nil, "c" ].compact! ...

يُطلق الاستثناء SecurityError لوقف عملية التكرار (iteration)، خصوصًا عبر التابع Enumerator.next. يُعالج هذا الاستثناء بالتابع Kernel.loop. loop do puts "Hello" raise StopIteration puts "World" end puts "Done!" سيُنتج: Hello Done! توابع النسخة العامة result يعيد القيمة المعادة من المُكرر (iterator). مصادر صفحة الصنف StopIteration في توثيق روبي الرسمي.

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

ينشئ التابع new كائنًا جديدًا من النوع UncaughtThrowError. يُطلق هذا الاستثناء عندما يتم استدعاء throw مع وسم tag لا يحتوي على الكتلة catch المقابلة. البنية العامة new(*args) المعاملات args المعاملات المستعملة في إنشاء الكائن UncaughtThrowError. انظر أيضًا التابع tag: يعيد كائن الوسم (tag object) الذي استُدعي معه. مصادر قسم التابع new‎ في الصنف UncaughtThrowError‎ في توثيق روبي الرسمي.

يعيد التابع fetch_values مصفوفة تحتوي على القيم المقترنة بالمفاتيح المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح. البنية العامة fetch_values(key, ...) → array fetch_values(key, ...) { |key| block } → array المعاملات key المفتاح الذي يراد جلب القيمة المقترنة به. ... المفاتيح الأخرى المراد جلب القيم المقترنة بها. القيمة المعادة تعاد مصفوفة تحتوي على القيم المقترنة بالمفاتيح key و ... المعطاة. يرمى الاستثناء KeyError عند تعذر العثور على أحد المفاتيح. أمثلة مثال على استعمال التابع fetch_values: h = { "cat" ...

يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. البنية العامة to_a → Array القيمة المعادة تُعاد مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم متغيرات البيئة. أمثلة مثال عن استخدام التابع to_a: ENV.to_a # => [["TERM", "xterm-color"], ["SHELL", "/bin/bash"], ...] انظر أيضًا التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_a في الصنف ENV في توثيق روبي الرسمي.

يبحث التابع bsearch_index باستخدام البحث الثنائي (binary search) عن فهرسٍ لعنصر من مصفوفة يحقق شرطًا منطقيًّا محددًا ويستغرق ‎O(log n)‎، إذ n هي حجم المصفوفة. يدعم هذا التابع وضعين بحسب نوع الكتلة المحددة؛ هذان الوضعان مشابهان للوضعين في التابع bsearch مع فارق وحيد وهو أنَّ هذا التابع يعيد فهرس العنصر بدلًا من العنصر نفسه. راجع صفحة التابع bsearch لمزيد من التفاصيل. البنية العامة bsearch_index {|x| block } → int or nil القيم المعادة يعاد عدد صحيح يمثل فهرس أول ...

يقطِّع التابع slice_before عناصر الكائن القابل للتعداد إلى أجزاء تحدَّد بدايتها عبر نمطٍ محدِّدٍ أو كتلةٍ معطاةٍ ثم يعيد مُعدِّد لكل جزء من الأجزاء الناتجة. البنية العامة slice_before(pattern) → an_enumerator slice_before { |elt| bool } → an_enumerator إن كان النمط مطابقًا للعنصر (أي يعيد pattern === elt القيمة true) أو أعادت الكتلة القيمة true للعنصر المُمرَّر إليها، فسيُعدُّ العنصر بدايةً لجزء. يُستدعَى المعامل === والكتلة block من أول عنصر وحتى آخر عنصر من عناصر الكائن القابل للتعداد المعطى. يجري دومًا تجاهل النتيجة ...

يتحقق التابع finite?‎ إن كان العدد الذي استُدعي معه عددًا منتهيًا (finite). البنية العامة finite? → true or false‎ القيمة المعادة تعاد القيمة true إن كان العدد المعطى عددًا منتهيًا (finite)، وإلا فستُعاد القيمة false. انظر أيضا التابع eql?‎: يتحقق إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع ومتساويين. التابع floor: يعيد أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه. مصادر قسم التابع finite?‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يعيد التابع integer?‎ القيمة true دائمًا إن كان العدد المستدعى معه صحيح. البنية العامة integer? → true‎ القيمة المعادة تعاد القيمة true. انظر أيضا التابع odd?‎: يتحقق إن كان العدد الذي استٌدعي معه فرديًا. التابع even?‎: يتحقق إن كان العدد الذي استٌدعي معه زوجيًا.  مصادر قسم التابع integer?‎ في الصنف Integer‎ في توثيق روبي الرسمي.

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

يعيد التابع hash القيمة Hash للمصفوفة التي استُدعيت معه. إن كان لمصفوفتين نفس المحتوى، فسيكون لهما نفس قيمة Hash (وسيوازن بينهما باستخدام eql?‎). البنية العامة hash → integer القيم المعادة يعاد عدد صحيح يمثل القيمة Hash للمصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع hash: a = [ "a", "b", "c" ] a.hash # 2564204468492460516 انظر أيضًا التابع Object.hash: يعيد شيفرة Hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Array في توثيق روبي الرسمي.

يكرر التابع each_with_object الكتلة المعطاة على كل عنصر من عناصر الكائن الذي استدعي معه مع كائن آخر اعتباطي (الكائن المُمرَّر إليه). إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة each_with_object(obj) {|(*args), obj| ... } each_with_object(obj) المعاملات obj الكائن الذي سيُكرَّر مع كل عنصر من عناصر الكائن المعطى. القيمة المعادة يعاد الكائن obj المعطى، أو يعاد كائن جديد من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع each_with_object: to_three = Enumerator.new do |y| ...

يتحقق التابع 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?‎: يتحقق إن أُغلِق الملف ...

يعيد التابع rassoc‎ مصفوفة تضم اسم وقيمة متغير بيئة ذي قيمة محدَّدة، أو يعيد القيمة nil في حال لم تكن تلك القيمة موجودة. البنية العامة rassoc(value) المعاملات value قيمة متغير البيئة المراد جلب اسم المتغير المسند إليه. القيمة المعادة تُعاد مصفوفة تضم اسم وقيمة متغير البيئة ذي القيمة value، أو تُعاد القيمة nil في حال لم تكن تلك القيمة موجودة. انظر أيضًا التابع assoc: يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك ...

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

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

يجلب التابع take_while العناصر الأولى التي تحقق الكتلة المعطاة من الكائن القابل للتعداد الذي استدعي معه. البنية العامة take_while { |obj| block } → array take_while → an_enumerator القيمة المعادة تعاد مصفوفة تحوي العناصر الأولى من الكائن القابل للتعداد المعطى المحققة للكتلة block حتى أول عنصر تعيد الكتلة معه القيمة false أو nil، أو يعاد كائن من النوع Enumerator إن لم تُعطَ أية كتلة. أمثلة مثال على استعمال التابع take_while: a = [1, 2, 3, 4, 5, 0] a.take_while { |i| i < 3 ...

يفك التابع unbind ارتباط الكائن Method الذي استُدعي معه من مُستقبِله (receiver) الحالي. يمكن في وقت لاحق ربط الكائن الناتج UnboundMethod مع كائن جديد من نفس الصنف (انظر UnboundMethod). البنية العامة unbind → unbound_method‎ القيمة المعادة يعاد كائن من النوع UnboundMethod يمثِّل مستقبل الكائن Method المعطى. انظر أيضا التابع to_s: يعيد اسم التابع الأصلي (underlying method). مصادر قسم التابع unbind‎ في الصنف Method‎ في توثيق روبي الرسمي.

يعيد التابع to_i‎ العدد الصحيح الذي استُدعي معه دون تغيير. هذا التابع يشبه to_int. البنية العامة to_i → integer to_int → integer‎ القيمة المعادة يعاد العدد الصحيح المعطى دون تغيير. انظر أيضا التابع to_s: يحول العدد الصحيح الذي استدعي معه إلى سلسلة نصية ممثلًا بأساس محدَّد.  التابع to_int: يعيد العدد الذي استُدعي معه دون تغيير. التابع to_r: يحول العدد الذي استُدعي معه إلى عدد جذري (rational). التابع to_f: يحول العدد الصحيح الذي استُدعي معه إلى عدد عشري. مصادر قسم ...

تمثّل كائنات الصنف Location إطارات المكدس (stack frames)، وتُنشأ بواسطة التابع Kernel.caller_locations. إليك مثلًا الشيفرة التالية: # caller_locations.rb def a(skip) caller_locations(skip) end def b(skip) a(skip) end def c(skip) b(skip) end c(0..2).map do |call| puts call.to_s end‎ تشغيل الأمر ruby caller_locations.rb سوف ينتج: caller_locations.rb:2:in `a' caller_locations.rb:5:in `b' caller_locations.rb:8:in `c'‎ إليك مثالًا آخر بنتيجة مختلفة بعض الشيء: # foo.rb class Foo attr_accessor :locations def initialize(skip) @locations = caller_locations(skip) end end Foo.new(0..2).locations.map do |call| puts call.to_s end‎ الآن، إن قمت بتنفيذ ruby foo.rb، فيجب أن ترى ...

يضبط التابع egid عندما يستدعى بالشكل egid = integer المُعرِّف الفعَّال للمجموعة المالكة لهذه العملية إلى القيمة integer. هذا التابع غير متاح على جميع المنصات. البنية العامة egid = integer → integer القيم المعادة يعاد العدد الصحيح integer بعد تعيينه إلى المُعرِّف الفعَّال للمجموعة المالكة لهذه العملية. انظر أيضًا التابع egid: يعيد مُعرِّف المجموعة الفعال (effective group ID) المالكة لهذه العملية. التابع euid=‎: يضبط عندما يستدعى بالشكل euid = integer المُعرِّف الفعَّال للمستخدم المالك لهذه العملية إلى القيمة integer. مصادر ...

يضبط التابع setproctitle عنوان العملية الذي يظهر عند تنفيذ الأمر ps(1)‎. ليس بالضرورة أن يعمل هذا التابع على جميع المنصات. لن تُطلَق أية استثناءات عند استعمال هذا التابع مهما كانت النتيجة، ولا حتى الاستثناء NotImplementedError عندما لا تكون المنصة تدعم هذه الميزة. لا يؤثر استدعاء هذا التابع على القيمة 0$. ظهر هذا التابع أول مرة في الإصدار 2.1 من روبي ليعمل بشكل متغير عام هدفه هو تغيير عنوان العملية بحرية مطلقة. البنية العامة setproctitle(string) → string المعاملات string سلسلة نصية تمثِّل ...

يُطلق الاستثناء NotImplementedError عند عدم توفّر ميزة (feature) على نظام التشغيل الحالي. على سبيل المثال، قد تُطلِق التوابع التي تعتمد على استدعاء دالتي النظام fsync أو fork هذا الاستثناء إن كانتا غير مدعومتين على نظام التشغيل أو بيئة تشغيل روبي آنذاك. لاحظ أنه إن أطلقت الدالة fork الاستثناء NotImplementedError، فسيعيد التابع respond_to?(:fork)‎  القيمة false. مصادر قسم الصنف NotImplementedError في توثيق روبي الرسمي.

يعيد التابع max الحد الأقصى لحجم الطابور. البنية العامة max() القيمة المعادة يعاد الحد الأقصى لحجم الطابور. انظر أيضا التابع length: يعيد حجم الطابور الحالي. التابع max=‎: يضبط قيمة الحد الأقصى لحجم الطابور. مصادر قسم التابع max‎ في الصنف SizedQueue‎ في توثيق روبي الرسمي.