نتائج البحث

يعيد التابع 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]). ملاحظة: تعتمد وسائط الكلمات المفتاحية على التطبيق والاصدار المُستخدم من روبي. لا يُضمن أن تبقى متوافقةً مستقبلًا، وقد يتم تجاهلها إذا كان التطبيق الأساسي لا يدعمها. ...

يُطلق الاستثناء NameError عندما يكون الاسم المعطى غير صالح أو غير مُعرّف. انظر إلى السطر البرمجي التالي: puts foo سيُطلق عند تنفيذه الاستثناء التالي: NameError: undefined local variable or method `foo' for main:Object أسماء الثوابت يجب أن تبدأ بحرف كبير، لذلك فالشيفرة البرمجية التالي: Integer.const_set :answer, 42 ستطلق الاستثناء NameError: NameError: wrong constant name answer توابع الصنف العامة (Public Class Methods) new ينشئ استثناءً جديدًا من النوع NameError. توابع النسخة العامة (Public Instance Methods) local_variables يعيد قائمة بأسماء المتغيرات المحلية المُعرّفة حيث أُطلٍق ...

يعيد التابع 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 إن ...

يبحث التابع scan عن نمط محدَّد ضمن السلسلة النصية التي استدعيت معه ويعيد النتائج المتطابقة في مصفوفة أو يمرِّرها إلى الكتلة المعطاة ويعيد الناتج الذي تعيده. البنية العامة scan(pattern) → array scan(pattern) {|match, ...| block } → str المعاملات pattern تعيبر نمطي أو سلسلة نصية يراد البحث عنها ومطابقتها في السلسلة النصية المعطاة. إن لم يحتوي هذا المعامل على مجموعات، فستتألف كل نتيجة فردية من السلسلة النصية المتطابقة (أي &$). أمَّا إن احتوى على مجموعات، فستكون كل نتيجة فردية مصفوفةً بحد ...

يستدعي التابع prepend التابع prepend_features على كل المعاملات المعطاة بترتيب عكسي. البنية العامة prepend(module, ...) → self‎ المعاملات module‎ يمثل وحدةً من النوع Module. القيمة المعادة يعاد الكائن المعطى. انظر أيضا التابع prepend_features: يُستدعَى في الوحدة المعطاة عندما تُرفَق هذه الوحدة في أخرى، وتُمرَّر إليها الوحدة المُستقبِلة (receiving module) في الوحدة التي مُمرِّرت إليه.  مصادر قسم التابع prepend‎ في الصنف Module‎ في توثيق روبي الرسمي.

يعيد التابع divmod مصفوفة تحتوي على حاصل (quotient) وباقي قسمة العدد الذي استُدعي معه على العدد المُمرَّر إليه. البنية العامة divmod(numeric) → array‎ إن كان لدينا العددين q و r = x.divmod(y)‎، فيكون: q = floor(x/y) x = q*y + r يتم تقريب حاصل القسمة نحو اللانهاية السالبة، كما هو موضح في الجدول التالي: a | b | a.divmod(b) | a/b | a.modulo(b) | a.remainder(b) ------+-----+---------------+---------+-------------+--------------- 13 | ...

البنية العامة fetch(*args) المعاملات args انظر أيضًا التابع group: يُعيد مجموعة الخيوط ThreadGroup التي تحتوي على المهمة الفرعية المعطاة، أو يُعيد nil إذا لم تكن المهمة الفرعية عضوًا في أي مجموعة. التابع join: يوقف عند استدعائه تنفيذ المهمة الفرعية المُستدعيَة (calling thread)، وبدء تنفيذ المهمة الفرعية التي استُدعي معها. مصادر قسم التابع fetch في الصنف Thread في توثيق روبي الرسمي.

يحول التابع inspect سلسلة التعليمات التي استُدعي معها إلى سلسلة نصية قابلة للقراءة تتضمن أيضًا الاسم والمسار. البنية العامة inspect() القيمة المعادة تعاد سلسلة نصية قابلة للقراءة لسلسلة التعليمات المعطاة، التي تتضمن أيضًا الاسم والمسار. انظر أيضًا التابع first_lineno: يعيد رقم أول سطر في المصدر حيث تم تحميل تسلسل التعليمات الحالي. التابع label: يُعيد تسمية (label) سلسلة التعليمات. مصادر قسم التابع inspect‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

المهام الفرعية (Threads، وتدعى "الخيوط" أيضًا) هي الطريقة التي تنفذ بها روبي البرمجة المتزامنة (concurrent programming). البرامج التي تتطلب تنفيذ عدة مهام فرعية يمكنها استخدام الصنف Thread. على سبيل المثال، يمكننا إنشاء مهمة فرعية جديدة منفصلة عن المهمة الرئيسية باستخدام التابع new. thr = Thread.new { puts "Whats the big deal" }‎ ثم يمكننا إيقاف تنفيذ المهمة الفرعية الرئيسية مؤقتًا إلى حين إنتهاء المهمة الفرعية خاصتنا باستخدام التابع join: thr.join #=> "Whats the big deal"‎ في حال عدم استدعاء التابع join قبل ...

يعيد التابع stat كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). يتضمن الكائن Hash معلومات حول تسلسلات ذاكرة التخزين المؤقت (cache serials) الخاصة بالتوابع والثوابت مثل: { :global_method_state=>251, :global_constant_state=>481, :class_serial=>9029 }‎ تقديم (implementation) محتويات الكائن Hash مخصوصة، ويمكن أن تتغير مع مرور الوقت. لا يُتوقّع أن يعمل هذا التابع إلا على على C Ruby. البنية العامة stat → Hash stat(hsh) → hsh stat(Symbol) → Numeric‎ القيمة المعادة يعاد كائن من النوع Hash يحوي عدادات مُخصصة داخل ...

يُطلق الاستثناء fatal عندما تصادف روبي خطأ فادحًا (fatal error) بحيث يتوجب عليها إنهاء البرنامج فورًا، لأنه لا يمكن معالجة هذا الاستثناء. مصادر صفحة الصنف fatal في توثيق روبي الرسمي.

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

يشبه التابع next!‎ التابع next تمامًا باستثناء أنه يعدل على السلسلة النصية التي تُستدعَى معه. البنية العامة next! → str القيمة المعادة تعاد السلسلة النصية المعطاة نفسها بعد زيادتها عبر حساب السلسلة النصية اللاحقة لها. انظر أيضًا التابع chop!‎: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع next: يعيد السلسلة النصية اللاحقة للسلسلة النصية التي استدعي معها. التابع reverse!‎: يعدل على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. مصادر قسم التابع next!‎‎ في الصنف String في توثيق روبي ...

يُعيد التابع bytes سلسلةً نصيةً ثنائيةً عشوائية بحجم محدَّدٍ من البايتات. البنية العامة bytes(size) → a_string المعاملات size حجم السلسلة النصية المراد توليدها. القيم المعادة تُعاد سلسلةٌ نصيةٌ ثنائيةٌ عشوائية بحجم قيمة المعامل size. أمثلة مثالٌ عن استخدام التابع bytes: random_string = Random.new.bytes(10) # => "\xD7:R\xAB?\x83\xCE\xFAkO" random_string.size # => 10 انظر أيضًا التابع urandom : يعيد سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة. التابع ...

يعيد inspect اسم التابع الأصلي (underlying method). البنية العامة inspect→ string‎ القيمة المعادة يعاد اسم التابع الأصلي المعطى. أمثلة مثال على استخدام التابع inspect‎: "cat".method(:count).inspect #=> "#<Method: String#count>"‎ انظر أيضًا التابع hash: يعيد القيمة hash المقابلة التابع الحر الذي استُدعي معه. التابع name: يعيد اسم التابع الحر الذي استدعي معه. مصادر قسم التابع inspect‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

يعيد التابع ctime وقت آخر تغيير أجري على الملف الذي استدعي معه. يشير وقت التغيير هذا إلى الزمن الذي تغيرت فيه معلومات المجلد حول الملف وليس الملف نفسه. البنية العامة ctime → time القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت آخر تغيير جرى للمعلومات حول الملف file_name. في أنظمة ويندوز (أي أنظمة الملفات NTFS)، يعاد وقت إنشاء الملف وليس وقت التغيير. أمثلة مثال على استعمال التابع ctime: File.new("testfile").ctime #=> Wed Apr 09 08:53:14 CDT 2003 انظر أيضا ...

يقرأ التابع read_nonblock عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى ARGF في وضع عدم الحجز (non-blocking mode). البنية العامة read_nonblock(maxlen[, options]) → string read_nonblock(maxlen, outbuf[, options]) → outbuf المعاملات maxlen عدد البايتات الأعظمي المراد قراءته من المجرى ARGF. options خيارات إضافية. outbuf سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى ARGF. القيم المعادة تعاد سلسلة نصية تمثل البيانات المقروءة من المجرى ARGF، أو يعاد الوسيط outbuf (إن أعطي) بعد تخزين البيانات المقروءة فيه. انظر أيضًا التابع read: يقرأ ...

يتحقق التابع wednesday?‎ إن كان التوقيت يمثل يوم الأربعاء. البنية العامة wednesday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم الأربعاء؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع wednesday?‎: t = Time.local(1993, 2, 24) #=> 1993-02-24 00:00:00 -0600 p t.wednesday? #=> true‎ انظر أيضًا التابع tuesday?‎: يتحقق إن كان التوقيت يمثل ...

يغلق التابع close_write طرف الكتابة الخاص بمجرى د/خ مزدوج (duplex)؛ أي تلك المجاري التي تحتوي على مجريي قراءة وكتابة، مثل الأنابيب (pipes). سيُطلق الاستثناء IOError إن لم يكن المجرى مزدوجًا. أصبحت روبي تتجاهل استدعاء هذا التابع على مجاري د/خ المغلقة منذ الإصدار 2.3. البنية العامة close_write→ nil‎ القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. أمثلة مثال على استخدام التابع close_write‎: f = IO.popen("/bin/sh","r+") f.close_write f.print "nowhere"‎ ناتج تنفيذ هذه الشيفرة هو: prog.rb:3:in `write': not opened for writing (IOError) from prog.rb:3:in `print' from prog.rb:3‎ ...

يتحقق التابع zero?‎ إن كانت قيمة العدد الذي استُدعي معه تساوي الصفر. البنية العامة zero? → true or false‎ القيمة المعادة تعاد القيمة true إن كانت قيمة العدد المعطى تساوي الصفر. خلا ذلك، تعاد القيمة false. انظر أيضا التابع integer?‎: يتحقق إن كان العدد الذي استُدعي معه من النوع Integer. التابع negative?‎: يتحقق إن كان العدد الذي استُدعي معه عددًا سالبًا. التابع positive?‎: يتحقق إن كان العدد الذي استُدعي معه عددًا موجبًا. التابع real?‎: يتحقق إن كان العدد الذي استُدعي مهه عددًا حقيقيًّا (أي ليس ...

يعيد التابع has_value?‎ إذا كانت قيمةٌ معيَّنةٌ موجودةً في الكائن Hash المعطى ومرتبطة بمفتاح. البنية العامة has_value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها. القيمة المعادة تعاد القيمة true إذا كانت القيمة value المُعطاة موجودةً ومرتبطة بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في ...

يعيد التابع compact نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي nil منها. البنية العامة compact → new_ary القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء العناصر ذات القيمة nil. أمثلة مثالٌ على استخدام التابع compact: [ "a", nil, "b", nil, "c", nil ].compact #=> [ "a", "b", "c" ] انظر أيضًا التابع compact! ...

يعيد التابع original_name الاسم الأصلي للكائن Method الذي استُدعي معه. البنية العامة original_name → symbol‎ القيمة المعادة يعاد رمزٌ يمثِّل الاسم الأصلي للكائن Method المعطى. أمثلة مثال على استخدام التابع original_name‎: class C def foo; end alias bar foo end C.instance_method(:bar).original_name # => :foo‎ انظر أيضا التابع name: يعيد اسم التابع. التابع owner: يعيد الصنف أو الوحدة (module) التي تُعرِّف الكائن Method الذي استُدعي معه. مصادر قسم التابع original_name‎ في الصنف Method‎ في توثيق روبي الرسمي.

يضبط التابع gid عند استدعائه بالشكل gid= integer مُعرِّف المجموعة المالكة للعملية الحالية إلى القيمة integer. البنية العامة gid= integer → integer القيم المعادة يعاد العدد الصحيح integer بعد تعيينه إلى مُعرِّف المجموعة المالكة للعملية الحالية. انظر أيضًا التابع egid=‎: يضبط عندما يستدعى بالشكل egid = integer المُعرِّف الفعَّال للمجموعة المالكة لهذه العملية إلى القيمة integer. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. مصادر قسم التابع gid في الصنف Process في توثيق روبي الرسمي.

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

يقرأ التابع read المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. عند الوصول إلى نهاية المجلد، يعيد التابع القيمة nil. البنية العامة read → string or nil القيم المعادة تُعاد سلسلة نصية تمثل المدخلة التالية في المجلد المعطى، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى. أمثلة مثال عن استخدام التابع read على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") d.read #=> "." d.read #=> ".." d.read ...

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

يحول التابع to_r قيمة التوقيت المعطى إلى عدد جذري يمثل عدد الثواني التي مرت منذ توقيت يونكس. هذا التابع هو أحد التوابع التي تستعمل للحصول على قيمة دقيقة تمثل عدد النانوثواني التي مرت منذ توقيت يونيكس. يمكنك استخدام هذا التابع لتحويل التوقيت إلى "توقيت حقبة أخرى". البنية العامة to_r → a_rational‎ القيمة المعادة تعاد قيمة التوقيت كعدد جذري يمثل عدد الثواني التي مرت منذ توقيت يونيكس. أمثلة مثال على استخدام التابع to_r‎: t = Time.now p t.to_r ...

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

يعيد التابع to_s‎ القيمة "ARGF". البنية العامة to_s → String القيم المعادة تعاد السلسلة النصية "ARGF". أمثلة مثال على استخدام التابع to_s: ARGF.to_s # => “ARGF” انظر أيضًا التابع inspect: يعيد القيمة "ARGF". التابع binmode: يفعِّل الوضع الثنائي (binary mode) للمجرى ARGF. مصادر قسم التابع to_s في الصنف ARGF في توثيق روبي الرسمي.

البنية العامة add_stress_to_class(*args) انظر أيضا التابع remove_stress_to_class. التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمالmalloc()‎. مصادر قسم التابع add_stress_to_class‎ في الصنف GC في توثيق روبي الرسمي.

يستبدل التابع succ!‎ السلسلة النصية التي استدعيت معه بالسلسلة التي تليها؛ وتُحسَب هذه السلسلة بزيادة حروف السلسلة المُعطاة بدءًا من أول حرف أبجدي رقمي (alphanumeric) في أقصى اليمين، أو أي محرف آخر فى حال عدم وجود حروف أبجدية رقمية في السلسلة. زيادة رقم ينتج عنه رقم آخر، وزيادة حرف ينتج عنه حرف آخر؛ أما الحروف الغير الأبجدية أو رقمية، فإن الزيادة تتم حسب تسلسل ترتيب مجموعة الحروف الأساسية. في حال أدت زيادة الحرف إلى حصول حمل، فإن التابع يزيد الحرف ...

يعطي التابع pass إلى مُجدوِل المهام الفرعية (thread scheduler) تلميحًا لتمرير التنفيذ إلى مهمة فرعية أخرى. مسألة تبديل المهمة الفرعية قيد التشغيل من عدمها تعتمد على نظام التشغيل والمعالج المستخدمين. البنية العامة pass→ nil‎ القيمة المعادة تعاد القيمة nil. انظر أيضًا التابع new: ينشئ مهمة فرعية جديدة لتنفيذ الكتلة المعطاة. مصادر قسم التابع pass‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يعيد تابع النسخة disasm سلسلة التعليمات المعطاة على هيئة سلسلة نصية قابلة للقراءة. البنية العامة disasm → str القيمة المعادة تعاد سلسلة نصية تحوي سلسلة التعليمات بشكل قابل للقراءة. أمثلة مثال على استخدام التابع disasm‎: puts RubyVM::InstructionSequence.compile('1 + 2').disasm الناتج سيكون: == disasm: <RubyVM::InstructionSequence:<compiled>@<compiled>>========== 0000 trace 1 ...

يعيد التابع pre_match الجزء الذي يسبق المطابقة (match) الحالية من السلسلة النصية الأصلية. يكافئ هذا التابع المتغير الخاص `$. البنية العامة pre_match→ str‎ القيمة المعادة يعاد الجزء الذي يسبق المطابقة (match) الحالية من السلسلة النصية الأصلية. أمثلة مثال على استخدام التابع pre_match‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.pre_match #=> "T"‎ انظر أيضا التابع post_match: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية. مصادر قسم التابع pre_match‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يتحقَّق التابع ?lambda إذا كانت معالجة الوسائط صارمةً في الكائن Proc (أي يجب تمرير نفس العدد تمامًا من الوسائط المعرَّفة عند إنشاء الكائن). تُنشأ هذه الكائنات عادةً بوساطة lambda. كائنات الصنف Proc المُنشأة بوساطة proc ليست صارمةً وتمتلك الميزات التالية: تتجاهل الوسائط الإضافيَّة: proc {|a,b| [a,b] }.call(1,2,3)    #=> [1,2] تُعيِّن القيمة nil للوسائط الناقصة: proc {|a,b| [a,b] }.call(1)        #=> [1,nil] توسِّع وسيط مصفوفة مفردة: proc {|a,b| [a,b] }.call([1,2])    #=> [1,2] كائن الصنف Proc المُنشأ بواسطة lambda لا يمتلك هذه الميِّزات. lambda ...

يحذف التابع rmdir‎ مجلدًا محدَّدًا. سيُطلق خطأٌ من صنف فرعي من SystemCallError  في حال لم يكن المجلد فارغًا. البنية العامة rmdir( string ) → 0 المعاملات string اسم المجلد المُراد حذفه. انظر أيضًا التابع delete‎: يحذف مجلدًا محدَّدًا.  التابع unlink‎: يحذف مجلدًا محدَّدًا.   مصادر قسم التابع rmdir في الصنف Dir في توثيق روبي الرسمي.

يعيد التابع lcm‎ أصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعطى. النتيجة دائمًا موجبة، كما يعيد التعبيران ‎0.lcm(x)‎ و x.lcm(0)‎. القيمة 0.  البنية العامة lcm(other_int) → integer‎ المعاملات other_int‎ عدد صحيح. القيمة المعادة يعيد التابع lcm‎ أصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعطى other_int‎. أمثلة مثال على استخدام التابع lcm‎: 36.lcm(60) #=> 180 2.lcm(2) ...

يعيد التابع inspect سلسلة نصية تصف الكائن Dir الذي استُدعي معه. البنية العامة inspect → string القيم المعادة تُعاد سلسلة نصية تصف الكائن Dir الذي استُدعي معه. انظر أيضًا التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) المُستخدم في الكائن Dir الذي استُدعي معه. مصادر قسم التابع inspect في الصنف Dir في توثيق روبي الرسمي.

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

يعيد التابع squeeze نسخة عن السلسلة النصية التي استدعي معها مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها. يمكن تحديد المحارف المراد إزالة تكرارها دون غيرها عبر تمريرها إلى التابع. البنية العامة squeeze([other_str]*) → new_str المعاملات other_str تحدد السلسلة other_str مجموعة المحارف المُراد إزالة تكرارها من نسخة السلسلة النصية المُعطاة. عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يشمل جميع المحارف عدا محارف تلك السلسلة. الصيغة c1-c2 تعني جميع المحارف الواقعة في المجال بين c1 و ...

يتحقق التابع ‎finite?‎ مما إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي الذي استُدعي معه منتهية (finite). البنية العامة finite? → true or false القيمة المعادة تعاد القيمة true إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي المعطى منتهية (finite)، وإلا فستُعاد القيمة false. أمثلة أمثلة عن استخدام معامل التابع ‎finite?‎: puts Complex(3.0, -4.0).finite? ; # true انظر أيضًا التابع ‎infinite?‎: يتحقق ما إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي منتهية أو غير ...

يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات ...

يتحقَّق التابع ?is_a إن كان الصنف المُمرَّر إليه هو نفسه صنف الكائن الذي استدعي معه، أو إن كان هذا الصنف أحد الأصناف العليا (superclasses) للكائن المعطى أو الوحدات المُضمَّنة في هذا الكائن. البنية العامة is_a?(class) → true or false المعاملات class الصنف المراد التحقق منه. القيم المعادة تُعاد القيمة true إذا كان الصنف class هو نفسه صنف الكائن المعطى، أو أنه أحد الأصناف العليا أو الوحدات المُضمَّنة في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ...

ينتج التابع dup نسخةً سطحية (shallow copy) من الكائن. تُنسَخ متغيرات النسخة (instance variables) من الكائن، ولكن لا تُنسَخ الكائنات التي تشير إليها (referenced objects). يَنسخ التابع dup الحالة التالفة (tainted state) من الكائن. قد يملك هذا التابع سلوكًا محدَّدًا بالصنف (class-specific behavior)، إذا كان كذلك، سيُوثَّق هذا السلوك تحت التابع ‎.initialize_copy من الصنف نفسه. ما هو الفرق بين التابع clone والتابع dup؟ عمومًا، قد يمتلك التابعين clone و dup دلالاتٍ مختلفةٍ في الأصناف السليلة (descendant classes). لمَّا كان التابع ...

يعيد التابع parameters معلومات عن معاملات الكائن Method الذي استُدعي معه. البنية العامة parameters → array‎ القيمة المعادة تعاد مصفوفة تحوي معلومات عن وسائط الكائن Method المعطى. أمثلة مثال على استخدام التابع 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, :args], [:block, :blk]]‎ انظر أيضا التابع owner: يعيد الصنف ...

يستبدل التابع !tr مجموعة محارف محدَّدة في السلسلة النصية المُعطاة بمحارف مقابلة لها. البنية العامة tr!(from_str, to_str) → str or nil يستبدل التابع !tr مجموعة حروف السلسلة  from_str في السلسلة النصية المُعطاة بالمحارف المقابلة لها في السلسلة to_str. إذا كانت السلسلة to_str أقصر من السلسلة from_str، فسيكرر الحرف الأخير فيها حتى تصبحان متساويتين من أجل الحفاظ على التنسيق. يمكن أن تحتوي كلا السلسلتين from_str و to_str على الصيغة c1-c2، والتي تُستعمَل للإشارة إلى مجال محدد من الحروف. يشير الرمز ^ فى ...

يعيد التابع to_r الصفر كعدد جذري (rational). البنية العامة to_r → (0/1)‎ القيمة المعادة يعاد الصفر كعدد جذري. انظر أيضا التابع to_i: يعيد دائما الصفر. التابع to_s: يعيد سلسلة نصية فارغة دائمًا. مصادر قسم التابع to_r‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

يقرأ التابع read عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه عندما يُستدعى التابع read في نهاية الملف، فسيعيد إما nil أو ""، بناءً على الطول المُمرَّر إليه، مثلا، ستعيد التعبيرات read و read(nil)‎ و read(0)‎ القيمة ""، فيما سيعيد التعبير read( positive_integer )‎ القيمة nil. لاحظ أنَّ هذا التابع يتصرف بطريقة مشابهة للدالة fread()‎ في لغة C. وهذا يعني أنَّه سيحاول إجراء استدعاءات النظام read(2)‎ لقراءة البيانات بالطول المحدَّد (أو حتى يصادف محرف نهاية الملف EOF). يستمر هذا السلوك ...

يشبه التابع lstat التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size ...

يزيل التابع remove_const تعريف ثابت محدَّد، ويعيد القيمة السابقة له. إذا كان هذا الثابت يشير إلى وحدة، فلن يُغيَّر اسم الوحدة، وهو ما قد يكون مصدر إرباك. البنية العامة remove_const(sym)→ obj‎ المعاملات sym‎ رمز يمثل الثابت المراد إزالته. القيمة المعادة يعاد كائن يمثِّل القيمة السابقة للثابت ذي الاسم sym بعد حذفه. انظر أيضا التابع remove_class_variable: يزيل تعريف متغير محدَّد من صنفٍ ثم يعيد قيمة ذلك الثابت. التابع remove_method: يزيل تابعًا ذا اسم محدَّد من الصنف الحالي. مصادر قسم التابع remove_const‎ في الصنف Module‎ ...

الوحدات تخدم الوحدات (Modules) غايتين اثنتين في لغة روبي وهما: ميّزة نطاقات الأسماء (namespace)، والخلط الضمني (mix-in) التي سنوضّحها لاحقًا. يستخدم نطاق الأسماء لتنظيم الشيفرة البرمجية ضمن مجموعات مستقلّة تمنع تداخل التوابع والمتغيّرات ذات الأسماء المتشابهة فيما بينها. فعلى سبيل المثال، نطاق الأسماء IRB يوفّر عمليات irb والتي تمنع التصادم مع الاسم الشائع "Context". وظيفة الخلط الضمني (Mix-in) تسمح بمشاركة توابع مشتركة عبر عدد من الأصناف أو الوحدات، إذ يأتي مع لغة روبي على سبيل المثال الوحدة Enumerable التي توفّر ...

يعيد التّابع locale_chaemap اسم مخطّط توزيع الأحرف (charmap) للمحلية (locale) الحالية. البنية العامة locale_charmap → string القيم المعادة تعاد سلسلة نصية تمثل اسم مخطّط توزيع الأحرف (charmap) للمحلية الحالية، أو تعاد القيمة nil العدمية  إذا لم توجد معلومات موافقة. أمثلة بعض الأمثلة عن استخدام التابع locale_charmap‎‎: Debian GNU/Linux LANG=C Encoding.locale_charmap #=> "ANSI_X3.4-1968" LANG=ja_JP.EUC-JP Encoding.locale_charmap #=> "EUC-JP" SunOS 5 LANG=C Encoding.locale_charmap #=> "646" LANG=ja ...

يعيد التابع numerator البسط للعدد الجذري الذي استدعي معه. البنية العامة numerator → integer‎ القيمة المعادة يعاد البسط (numerator) للعدد الجذري المعطى. أمثلة مثال على استخدام التابع numerator‎: Rational(7).numerator #=> 7 Rational(7, 1).numerator #=> 7 Rational(9, -4).numerator #=> -9 Rational(-2, -10).numerator #=> 1‎ انظر أيضا التابع denominator‎: يعيد المقام للعدد الجذري الذي استدعي معه. مصادر قسم التابع numerator‎ في الصنف Rational‎ في توثيق روبي الرسمي.

يجلب التابع instance_variable_get قيمة مُتغيِّر النسخة (instance variable) المُمرَّر إليه من الكائن المعطى، أو يُعيد قيمةً عدميّةً nil إذا كان المتغيِّر غير معيَّن في ذلك الكائن. يجب أن يحتوي اسم المُتغيِّر على الرمز @ في حال كان من متغيرات النسخة النظامية (regular instance variables). يُرمى الاستثناء NameError إذا كان الرَّمز المُعطى غير معرَّفٍ على أنَّه اسمٌ لمتغيِّر نسخة. تُحوَّل الوسائط النّصية المُمرَّرة إلى التابع إلى رموز. البنية العامة instance_variable_get(symbol) → obj instance_variable_get(string) → obj المعاملات symbol الرمزُ المراد جلب قيمته في ...

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

يعيد التابع autoload?‎ اسم الملف الذي سيُحمل إن كان المعامل المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. البنية العامة autoload?(name)→ String or nil‎ القيمة المعادة تعاد سلسلة نصية تمثِّل اسم الملف الذي سيُحمل إن كان الوسيط المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع autoload?‎: module A end A.autoload(:B, "b") A.autoload?(:B) #=> "b"‎ انظر أيضا التابع autoload: يُُسجل اسم الملف ...

يتحقق التابع tuesday?‎ إن كان التوقيت يمثل يوم الثلاثاء. البنية العامة tuesday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم الثلاثاء؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع tuesday?‎: t = Time.local(1991, 2, 19) #=> 1991-02-19 00:00:00 -0600 p t.tuesday? #=> true‎ انظر أيضًا التابع wednesday?‎: يتحقق إن كان ...

يحول التابع to_r العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد جذري. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. يمكن الفصل بين سلاسل الأرقام باستعمال الشرطة السفلية (underscore). إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0/1 دون إطلاق أية استثناءات. استعمال التابع مع سلسلة نصية (مثل ‎“0.3”.to_r) يعيد نتيجة مختلفة عن استعماله مع عدد عشري (مثل ‎0.3.to_r). يكافئ الشكل الأول القيمة "3/10" ولكن الأخير لا يكافئ هذه القيمة. ...

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

يتحقق التابع compare_by_identity?‎ إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. البنية العامة compare_by_identity? → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. خلا ذلك، تعاد القيمة false. انظر أيضا التابع compare_by_identity: يجعل الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. مصادر قسم التابع compare_by_identity?‎ في الصنف Hash في توثيق روبي الرسمي.

يفعِّل التابع enable جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. البنية العامة enable → true or false القيمة المعادة تعاد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع enable: GC.disable #=> false GC.enable #=> true GC.enable #=> false انظر أيضا التابع disable: يعطِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. مصادر قسم التابع ...

يعيد التابع conj الكائن الذي استُدعي معه (الكائن self). البنية العامة conj → self conjugate → self‎ القيمة المعادة يعاد الكائن المعطى نفسه (الكائن self). انظر أيضا التابع coerce: إن كان العدد المُمرَّر إليه من نفس نوع العدد الذي استُدعي معه، فسيعيد مصفوفة تحوي هذين العددين. خلاف ذلك، سيحول هذين العددين إلى النوع Float ويعيدهما في مصفوفة. التابع conjugate: يعيد الكائن self. مصادر قسم التابع conj‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يُنشئ التابع ()new نسخةً جديدةً من الصنف Queue. البنية العامة new() القيم المعادة تُعاد نسخةٌ من الصنف Queue. انظر أيضًا التابع clear : يحذف كل الكائنات من الطابور الذي استُدعي معه. التابع close : يغلق الطابور الذي استُدعي معه. التابع length : يعيد طول الطابور الذي استُدعي معه. مصادر صفحة التابع new في الصنف queue في توثيق روبي الرسمي.

يحول التابع signame رقم الإشارة إلى اسم الاسم المقابل لها. البنية العامة signame(signo) → string or nil‎ المعاملات signo‎ رقم الإشارة المراد معرفة اسمها. القيمة المعادة يعيد التابع signame سلسلة نصية تمثل اسم الإشارة، أو تعاد القيمة nil إن لم يكن المعامل signo رقم إشارة صالح. أمثلة مثال على استخدام التابع signame‎: Signal.trap("INT") { |signo| puts Signal.signame(signo) } Process.kill("INT", 0)‎ ناتج تنفيذ الشيفرة هو: INT انظر أيضًا التابع list: يعيد قائمة بأسماء الإشارة المعيَّنة لأرقام الإشارة الأصلية المقابلة لها. التابع trap: يربط معالجًا بإشارة ...

يأخذ التابع disasm كائنًا يمكن أن يكون من النوع Method أو من النوع Proc ويعيد سلسلة نصية تعليمات قابلة للقراءة لهذا المعامل المعطى. البنية العامة disasm(body) → str disassemble(body) → str‎ المعاملات body‎ كائن من النوع Method أو من النوع Proc. القيمة المعادة تعاد سلسلة نصية تحوي المعامل body على هيئة تعليمات قابلة للقراءة. أمثلة مثال على استخدام التابع disasm‎ مع تمرير الكائن Method إليه: # /tmp/method.rb def hello puts "hello, world" end puts RubyVM::InstructionSequence.disasm(method(:hello)) الناتج سيكون: == disasm: <RubyVM::InstructionSequence:hello@/tmp/method.rb>============ 0000 trace ...

يستدعي التابع each_value الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير قيمة كل زوج إليها. البنية العامة each_value {| value | block } → hsh each_value → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير قيمة كل زوج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك.   أمثلة مثال على استعمال التابع each_value: h = { "a" => 100, ...

يعيد التابع rewind مؤشر المجرى الذي استُدعي معه إلى موضع بداية الإدخال؛ هذا يؤدي إلى تعيين رقم السطر lineno إلى القيمة صفر. لاحظ أنَّه لا يمكن استخدام هذا التابع مع المجاري من مثل الأنابيب (pipes) والطرفيات tty، والمقابس (sockets). البنية العامة rewind → 0‎ القيمة المعادة تعاد القيمة صفر بعد تنفيذ العملية. أمثلة مثال على استخدام التابع rewind‎: f = File.new("testfile") f.readline #=> "This is line one\n" f.rewind #=> 0 f.lineno #=> 0 f.readline ...

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

يُعيد التابع tv_nsec عدد النانوثواني المقابلة للتوقيت المعطى التي مرت منذ توقيت يونيكس. لاحظ أنه تختلف الأرقام الدنيا المعادة من التابع to_f والتابع subsec لأن الأعداد العشرية المضاعفة ذات المعيار IEEE 754 ليست دقيقة بما يكفي لتمثيل عدد النانوثواني التي مرت منذ حقبة يونيكس. يُعيد التابع nsec قيمة أكثر دقة. البنية العامة tv_nsec → int‎ القيمة المعادة يعاد عدد صحيح يمثِّل عدد النانوثواني المقابلة للتوقيت المعطى التي مرت منذ حقبة يونيكس. أمثلة مثال على استخدام التابع tv_nsec‎: t = Time.now ...

يعيّن التابع lineno عند استدعاءه بالشكل lineno = integer رقم السطر الحالي يدويًا إلى القيمة integer. لن يُحدّث المتغير ‎$.‎ إلا عند القراءة التالية. البنية العامة lineno = integer → integer‎ القيمة المعادة يعاد العدد الصحيح integer بعد تعيينه إلى رقم السطر الحالي. أمثلة مثال على استخدام التابع lineno=‎: f = File.new("testfile") f.gets #=> "This is line one\n" $. ...

يُعيد التابع binding الرَّبط (binding) الموافق للكائن Proc الذي استدعي معه. لاحظ أنَّ التابع Kernel.eval يقبل إما كائنًا من النوع Proc أو النوع Binding على أنَّه معامله الثّاني. البنية العامة binding → binding القيم المعادة يُعاد كائنٌ من النوع Binding. أمثلة مثالٌ عن استخدام التابع binding: def fred(param) proc {} end b = fred(99) eval("param", b.binding) #=> 99 انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن proc الذي استدعي معه. التابع curry: يُعيد كتلة proc مقسَّمة. التابع to_s: ...

يتحقق التابع pending_interrupt?‎ مما إذا كان طابور الانتظار غير المتزامن (asynchronous queue) فارغًا أم لا. بما أنه يمكن استخدام handle_interrupt لتأجيل الأحداث غير المتزامنة، فمن الممكن استخدام هذا التابع للتحقق مما إذا كانت هناك أي أحداث مؤجلة. إن أعاد هذا التابع القيمة true، فيمكنك إنهاء كتل ‎:never. إذا مُرِّر نوع الخطأ إلى التابع، فسيتحقق فقط من الأحداث المؤجلة من النوع error. الاستخدام اطلع على المثال التالي: th = Thread.new{ Thread.handle_interrupt(RuntimeError => :on_blocking){ while true ...

يمرر التابع select قيم كل أعضاء البنية إلى الكتلة المعطاة ويعيد مصفوفة تحتوي قيم الأعضاء التي أعادت الكتلة معها القيمة true. هذا التابع يكافئ التابع Enumerable.select. البنية العامة select {|obj| block } → array select → enumerator‎ القيمة المعادة تعاد مصفوفة تحوي أعضاء البنية التي أعيدت القيمة true معها بعد تمريرها إلى الكتلة block المعطاة. يعاد كائن من النوع enumerator إن لم تعطَ الكتلة block. أمثلة مثال على استخدام التابع select‎: Lots = Struct.new(:a, :b, :c, :d, :e, :f) l = ...