نتائج البحث

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

يفتح التابع open مجلدًا محدَّدًا ثمَّ يعيد كائنًا يشير إليه. إن لم تمرَّر إليه كتلة، فهو مرادف للتابع Dir::new. أمَّا إن مُرِّرت إليه كتلة، فسيُمرّر إليها aDir (انظر فقرة البنية العامة) كمعامل. يُغلَق المجلد في بعد الانتهاء من تنفيذ الكتلة، ويعيد التابع Dir::open ناتج تنفيذ هذه الكتلة. البنية العامة open( string ) → aDir open( string, encoding: enc ) → aDir open( string ) {| aDir | block } → anObject open( string, encoding: enc ) {| aDir | block } → anObject ...

يعيد التابع join سلسلة نصية جديدة مكونة من جمع السلاسل النصية المُمرَّرة إليها باستعمال الفاصل "/". البنية العامة join(string, ...) → string المعاملات string السلسلة النصية المراد جمعها مع سلاسل نصية أخرى. ... السلاسل النصية المراد جمعها مع بعضها بعضًا. القيمة المعادة تعاد سلسلة نصية جديدة مكونة من جمع السلاسل النصية string و ... المعطاة باستعمال الفاصل "/". أمثلة مثال على استعمال التابع join: File.join("usr", "mail", "gumby") #=> "usr/mail/gumby" انظر أيضا التابع absolute_path: يحول اسم مسار محدَّد إلى مسار ...

يعيد التابع to_s السلسلة النصية التي استدعيت معه نفسها. إذا استُعمل التابع مع صنف فرعي من الصنف String، فإنه يحوله إلى كائن من النوع String. البنية العامة to_s → str to_str → str القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها إن كانت من الصنف String، أو يعاد كائن من النوع String ناتج عن تحويل الصنف الفرعي المعطى. أمثلة أمثلة على استعمال التابع to_s: "hello".to_s #=> "hello" 123.to_s     #=> "123" انظر أيضًا التابع to_c: يحول السلسلة النصية التي استدعيت معه إلى عدد عقدي. ...

يُعيِّن التابع instance_variable_set قيمة متغيِّر نسخةٍ (instance variable) محدِّدٍ إلى قيمة معيَّنة في الكائن المُعطى؛ هذا يؤدي إلى إحباط جهود منشئ الصنف في محاولة توفير التغليف (encapsulation) المناسب. ليس من الضروري أن يتواجد المتغيِّر قبل استدعاء هذا التابع. إذا مُرِّر اسم متغيِّر النسخة بشكل سلسلةٍ نصيةٍ (string)، فستُحوَّل تلك السلسلة إلى رمز. البنية العامة instance_variable_set(symbol, obj) → obj instance_variable_set(string, obj) → obj المعاملات symbol الرمزُ الذي يشير إلى اسم متغيِّر النسخة المراد تعيين قيمة المعامل obj إليه في الكائن المُعطى. string ...

يفك التابع unpack ترميز السلسلة النصية التي استدعي معها (والتي قد تحوي بيانات ثنائية) وفقًا إلى سلسلة التنسيق المعطاة، ويعيد مصفوفة من كل قيمة مستخرجة. البنية العامة unpack(format) → anArray المعاملات format سلسلة نصية تمثِّل سلسلة التنسيق. تتكون سلسلة التنسيق من سلسلة من الموجهات ذات المحارف الفردية (اطلع على الجدول الآتي). يمكن أن يعقب كل موجِّه عددٌ يشير إلى عدد مرات تكرار هذا الموجه. سيستعمل الرمز * كل العناصر المتبقية. يمكن أن يلي كل موجه من الموجهات sSiIlL شرطة سفلية ...

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

يُحمّل التابع load_from_binary_extra_data البيانات الإضافية المُضمّنة في السلسلة النصية الثنائية (binary format String) المعطاة. البنية العامة RubyVM::InstructionSequence.load_from_binary_extra_data(binary) → str‎ المعاملات binary‎ سلسلة نصية ثنائية (binary format String). القيمة المعادة تعاد البيانات الإضافية المُضمّنة في السلسلة النصية الثنائية المعطاة. انظر أيضا التابع load_from_binary: يُحمّل سلسلة تعليمات من سلسلة نصية ثنائية (binary format String) مُنشأ بواسطة to_binary. مصادر قسم التابع load_from_binary_extra_data‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

يُحزِّمُ (packs) التابع pack محتويات المصفوفة التي استُدعيت معه على شكل تسلسل ثنائي (binary sequence) وفقًا للمُوجِّهات (directives) الواردة في المعامل aTemplateString؛ يمكن أن يتبع المُوجِّهات ","" و "A"" و ""a"" عددًا يحدّد عرض الحقل الناتج. قد تأخذ المُوجّهات المتبقية عددًا أيضًا مما يشير إلى عدد عناصر المصفوفة المطلوب تحويلها. إذا كان العدد يمثِّل محرف النجمة ("*")، فستُحوَّل جميع عناصر المصفوفة المتبقية. يمكن أن تُتبَع أيٌّ من المُوجّهات "sSiIlL" بشرطة سفلية ("_") أو إشارة تعجب ("!") لاستخدام الحجم الأصلي للمنصة ...

يتحقَّق التابع ?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 مُعرَّفًا في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة ...

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

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

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

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

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

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

يحذف التابع chomp!‎ الفاصل السطري المُحدد من نهاية السلسلة النصية المعطاة، أو يعيد القيمة nil إن لم يجري أي تعديل عليها. البنية العامة chomp!(separator=$/) → str or nil المعاملات separator الفاصل الذي سيُحذف من نهاية السلسلة النصية الجديدة. القيمة الافتراضية هي: /$. إن لم يغيَّر الفاصل /$ من سجل الفاصل الافتراضي لروبي، فسيحذف التابع chomp محارف العودة إلى بداية السطر أيضًا (أي سيحذف المحارف n\، و r\، و r\n\). أمَّا إن كان هذا المعامل سلسلة نصية فارغة، فسيحذف التابع جميع ...

يفتح التابع write ملفًا محدَّدًا ويكتب فيه السلسلة النصية المُمرَّرة إليه ثم يغلقه ويعيد عدد البايتات التي كتبها. يضمن التابع write أن يُغلق الملف قبل إعادة أية قيمة. إن كان المعامل الأخير عبارة عن جدول Hash، فسيحدد الخيارات الداخلية للتابع open()‎. البنية العامة write(name, string [, offset]) → integer write(name, string [, offset] [, opt])→ integer‎ المعاملات name‎ اسم الملف المراد كتابة السلسلة النصية string فيه. string‎ سلسلة نصية يراد كتابتها ضمن الملف. offset‎ عدد صحيح يمثل إزاحة موضع المؤشر في ...

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

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

يجمد التابع freeze السلسلة النصية التي استُدعيت معه، أي يجعلها غير قابلة للتعديل. البنية العامة freeze() القيمة المعادة تعاد السلسلة النصية المعطاة بعد تجميدها. أمثلة مثال على استعمال التابع freeze: a=”hello ” #=> “hello ” a<<”world” #=> “hello world” a.freeze #=> “hello world” a<<”Guys” #=> FrozenError (can't modify frozen String) انظر أيضًا المعامل >>: يُلحق الكائن المُعطى بالسلسلة النصية. الصنف FrozenError. مصادر قسم التابع freeze()‎‎ ...

يجلب التابع gets السطر التالي من الملف الحالي في المجرى ARGF. البنية العامة gets(sep=$/ [, getline_args]) → string or nil gets(limit [, getline_args]) → string or nil gets(sep, limit [, getline_args]) → string or nil يُفتَرض أنَّ الفاصل المستعمل لفصل الأسطر عن بعضها هو المحرف ‎$/‎. يمكن تغيير هذا الفاصل إلى محرف آخر عبر تمريره كسلسلة نصية إلى الوسيط sep. وظيفة الوسيط limit الاختياري هي تحديد عدد المحارف المراد جلبها من كل سطر. تعاد افتراضيًّا كل المحارف الموجودة في السطر. للمزيد من التفاصيل ...

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

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

يعيد التابع chr المحرف الأول من السلسلة النصية المُعطاة. البنية العامة chr → string القيمة المعادة تُعاد سلسلة جديدة مؤلفة من المحرف الأول للسلسلة النصية المُعطاة. أمثلة مثال على استخدام التابع chr: a = "abcde" a.chr #=> "a" انظر أيضًا التابع capitalize: يعيد نسخة عن السلسلة النصية المعطاة مع تحويل الحرف الأول فيها إلى حرف كبير، وباقي الأحرف إلى أحرف صغيرة. التابع chars: يُعيد محارف السلسلة النصية على شكل مصفوفة. مصادر قسم التابع ‎chr في الصنف String في ...

يعيد التابع string نسخةً مُجمدةً من السلسلة النصية التي تم تمريرها إلى التابع match لمطابقتها مع تعبير نمطي. البنية العامة string→ str‎ القيمة المعادة تعاد سلسلة نصية تمثِّل نسخةُ مُجمدةُ من السلسلة النصية التي تم تمريرها إلى التابع match. أمثلة مثال على استخدام التابع string‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.string #=> "THX1138."‎ انظر أيضا التابع size: يعيد عدد العناصر في مصفوفة المطابقة. التابع to_a: يعيد مصفوفة المطابقات. مصادر قسم التابع string‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

يعيد التابع inspect محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. يملك هذا التابع اسمًا بديلًا هو: to_s. البنية العامة to_s → string inspect → string القيمة المعادة تعاد سلسلة نصية تحوي جميع محتويات الكائن Hash المعطى. أمثلة مثال على استعمال التابع inspect: h = { "c" => 300, "a" => 100, "d" => 400, "c" => 300 } h.to_s #=> "{\"c\"=>300, \"a\"=>100, \"d\"=>400}" انظر أيضا التابع hash: يحسب الشيفرة hash للكائن Hash المستدعى معها. مصادر قسم التابع inspect ...

يُعيد التابع inspect نسخة قابلة للطباعة من السلسلة النصية محاطةً بعلامات تنصيص، مع تهريب الحروف الخاصة. البنية العامة inspect → string القيمة المعادة تُعاد نسخة قابلة للطباعة من السلسلة النصية المعطاة محاطةً بعلامات تنصيص، مع تهريب الحروف الخاصة. أمثلة مثال على استعمال التابع inspect: str = "hello" str[3] = "\b" str.inspect #=> "\"hel\\bo\"" انظر أيضًا التابع dump: يُعيد نسخة عن السلسلة النصية مع استبدال المحارف الغير مطبوعة بالرمز nnn\ وتهريب المحارف الخاصة. مصادر قسم التابع inspect‎ ...

يُعيد التابع ctime سلسلة نصية أساسية (canonical string) تحوي توقيت الكائن Time الذي استدعي معه. البنية العامة ctime→ string‎ القيمة المعادة تعاد سلسلة نصية أساسية تحوي توقيت الكائن Time المعطى. أمثلة مثال على استخدام التابع ctime‎: Time.now.asctime #=> "Wed Apr 9 08:56:03 2003" Time.now.ctime #=> "Wed Apr 9 08:56:03 2003"‎ انظر أيضًا التابع asctime: يُعيد سلسلة نصية أساسية (canonical string) تحوي توقيت الكائن Time الذي استدعي معه. مصادر قسم التابع ctime‎ في الصنف Time‎ في ...

يُعيد التابع asctime سلسلة نصية أساسية (canonical string) تحوي توقيت الكائن Time الذي استدعي معه. البنية العامة asctime → string‎ القيمة المعادة تعاد سلسلة نصية أساسية تحوي توقيت الكائن Time المعطى. أمثلة مثال على استخدام التابع asctime‎: Time.now.asctime #=> "Wed Apr 9 08:56:03 2003" Time.now.ctime #=> "Wed Apr 9 08:56:03 2003"‎ انظر أيضًا التابع ctime: يُعيد سلسلة نصية أساسية (canonical string) تحوي توقيت الكائن Time الذي استدعي معه. مصادر قسم التابع asctime‎ في الصنف Time‎ ...

يبحث التّابع find عن ترميزٍ باسمٍ محدّد. الأسماء التي يقبلها هذا التّابع هي الاسم الأساسي والاسم البديل الخاص بالتّرميز بما في ذلك الأسماء البديلة التالية: "external": يمثل الترميز الخارجي الافتراضي (default external encoding). "internal": يمثل الترميز الداخلي الافتراضي (default external encoding). "locale": يمثل الترميز المحدد في المحلية (locale encoding). "filesystem": يمثل ترميز نظام الملفات (filesystem encoding). البنية العامة find(string) → enc المعاملات string سلسلة نصية تمثل اسم الترميز المراد البحث عنه. القيم المعادة يعاد الترميز ذو الاسم string في حال ...

يشفِّر التابع crypt بناءً على القيمة Hash السلسلة النصية التي استدعي معها بطريقة غير قابلة للعكس (one-way cryptographic hash) عبر استدعاء دالة المكتبة القياسية crypt(3)‎ مع السلسلة النصية الإضافية المُمرَّرة إليه. لمَّا كان نمط التشفير والنتيجة تعتمدان على نظام التشغيل المستعمل، فإن استعمال سلسلةُ نصيةً إضافيةً (salt string) تطابق التعبير النمطي ‎\A[a-zA-Z0-9./]{2} ‎ يجب أن يكون صالحًا وآمنًا مهما كان نظام التشغيل المستعمل، إذ أول محرفين فيها مهمَّان لدرجة كبيرة. يعدُّ هذا التابع مخصَّصًا للاستعمال مع شيفرات مخصصة لنظام محدَّد، ...

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

يُحمّل التابع load_from_binary سلسلة تعليمات من سلسلة نصية ثنائية (binary format String) مُنشأ بواسطة to_binary. ليس لهذا المُحمَِل أداة تحقيق، لذا فإن تحميل سلسة نصية ثنائي معطوبة أو مُعدّلة قد يتسبب في حدوث مشاكل. عليك ألا تُحمّل البيانات الثنائية المقدمة من قبل الآخرين. يجب عليك استخدام البيانات الثنائية المترجمة من طرفك فقط. البنية العامة RubyVM::InstructionSequence.load_from_binary(binary) → iseq‎ المعاملات binary‎ سلسلة نصية ثنائية. القيمة المعادة يعيد التابع load_from_binary سلسلة تعليمات. انظر أيضًا التابع load_from_binary_extra_data: يُحمّل البيانات الإضافية المُضمّنة في السلسلة النصية الثنائية (binary format ...

يُعيد التابع itself الكائن المستقبل (receiver). البنية العامة itself → obj القيم المعادة يُعاد الكائن المستقبل. أمثلة مثالٌ عن استخدام التابع itself: string = "my string" string.itself.object_id == string.object_id #=> true انظر أيضًا التابع inspect: يُعيد سلسلةً نصيةً تحتوي تمثيلًا  يفهمه البشر للكائن الذي استدعي معه. التابع to_s: يُعيد سلسلةً نصيةً تُمثِّل الكائن الذي استدعي معه. التابع object_id: يعيد مُعرِّفا عدديًا للكائن الذي استُدعي معه. التابع extend: يُضيف توابع النسخة من كُلِّ وحدةٍ مُرِّرت إليه إلى الكائن الذي استدعي ...

يقرأ التابع readline السطر التالي من الملف الحالي في المجرى ARGF. يُفترَض أنَّ الفاصل المستعمل لفصل الأسطر هو المحرف /$؛ لاستخدام فاصل سطري مغاير، يمكن تمرير المحرف المراد استعماله كفاصل إلى التابع readline. يُطلَق الخطأ EOFError عند الوصول إلى نهاية الملف. البنية العامة readline(sep=$/) → string readline(limit) → string readline(sep, limit) → string الوسائط sep المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$. limit عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. القيم المعادة تعاد ...

يغيِّر التابع chdir‎ مجلد العمل (working directory) الحالي للعملية الحالية إلى مجلَّدٍ محدَّدٍ. عند استدعائه بدون تمرير وسيط، فسيغيِّر مجلد العمل إلى قيمة متغير البيئة HOME أو LOGDIR.SystemCallError (وربما Errno::ENOENT) إذا كان المجلد المُستهدَف غير موجود. في حال تمرير كتلة برمجية إلى التابع، فسيُمرّر إليها اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. بعد تنفيذ الكتلة والخروج منها، سيُستعَاد مجلد العمل الأصلي آنذاك. وتكون القيمة المعادة للتابع chdir مساويةً لقيمة الكتلة. يمكن أن تتشعّب الكتل chdir، ولكن سيُطلَق ...

يحاول التابع try_convert تحويل الكائن الذي مُرِّر إليه إلى سلسلة نصية. يجري هذا التابع عملية التحويل باستعمال التابع to_str. ملاحظة: يمكن استعمال الدالة to_s لتحويل الكائنات إلى سلاسل نصية إن أمكن أيضًا. البنية العامة try_convert(obj) → string or nil المعاملات obj الكائن المراد تحويله إلى سلسلة نصية. القيمة المعادة تعاد سلسلة نصية تمثِّل ناتج تحويل الكائن obj، أو تعاد القيمة nil إن لم يكن بالإمكان إجراء عملية التحويل لأي سبب كان. أمثلة مثال على استعمال التابع try_convert: String.try_convert("str") ...

يعيد التابع times بنيةً من النوع Tms (اطلع على Process::Tms) تحتوي على زمن المعالجة (CPU time، أو تدعى أيضًا زمن العملية [process time]) للعملية الحالية والعمليات الأبناء أيضًا. البنية العامة setproctitle(string) → string القيم المعادة تعاد سلسلة نصية تحوي قيمة زمن المعالجة بالثانية للعملية الحالية والعمليات الأبناء أيضًا. أمثلة مثال على استعمال التابع times: t = Process.times [ t.utime, t.stime, t.cutime, t.cstime ] #=> [0.0, 0.02, 0.00, 0.00] انظر أيضًا التابع last_status: يعيد حالة آخر عملية ابن نفِّذَت في الخيط ...

يُعيد التّابع exception المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلا ذلك، يُنشئ كائن استثناءٍ جديد (exception object)من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى string.to_str. البنية العامة exception(string) → an_exception or exc المعاملات string سلسلةٌ نصيةٌ تمثل الرسالة. القيم المعادة يُعاد المستقبل إن لم يمرر أي وسيط أو كان الوسيط المعطى نفسه المستقبل، أو يعاد كائن استثناء جديد يُمثِّل المستقبل. انظر أيضا التابع new: يُنشئ كائنًا ...

يجلب التابع gets السطر التالي من المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة وإلا سيُطلَق الاستثناء IOError. إن كان المجرى يحتوي على حروف متعددة البايتات، فستعيد gets(1)‎ الحرف بالكامل. البنية العامة gets(sep=$/ [, getline_args]) → string or nil gets(limit [, getline_args])→ string or nil gets(sep, limit [, getline_args]) → string or nil‎ المعاملات sep‎ المحرف الفاصل بين الأسطر. القيمة الافتراضية هي: /$. إن كانت قيمته nil، فستُقرَأ آنذاك جميع محتويات المجرى (أي سيمثِّل نهاية المجرى). limit‎ عدد ...

يُعيد التّابع name اسم التّرميز الفعلي لترميز محدد. البنية العامة name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الفعلي للترميز المعطى. أمثلة مثالٌ عن استخدام التابع name: Encoding::UTF_8.name      #=> "UTF-8" انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. ...

يوسع التابع extend_object الكائن المعطى بإضافة ثوابت و توابع هذه الوحدة (والتي تُضاف كتوابع فردية [singleton methods]). هذا هو التابع المستخدم من قبل Object.extend. البنية العامة extend_object(obj) → obj‎ المعاملات obj‎ الكائن المراد توسعته. القيمة المعادة يعاد الكائن obj بعد توسيعه. أمثلة مثال على استخدام التابع extend_object‎: module Picky def Picky.extend_object(o) if String === o puts "Can't add Picky to a String" else puts ...

يُدخل التابع 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: يعيد ...

يُعيد التّابع to_s اسم التّرميز الفعلي لترميز محدد. البنية العامة to_s → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الفعلي لترميز محدد. أمثلة مثالٌ عن استخدام التابع to_s: Encoding::UTF_8.name      #=> "UTF-8" انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. ...

يطلق التابع raise استثناء من مهمة فرعية معينة. لا يلزم أن يكون الُمستدعي (caller) هو المهمة الفرعية التي استُدعي التابع معها. انظر صفحة التابع Kernel.raise لمزيد من المعلومات. البنية العامة raise raise(string) raise(exception [, string [, array]])‎ أمثلة مثال على استخدام التابع raise‎: Thread.abort_on_exception = true a = Thread.new { sleep(200) } a.raise("Gotcha")‎ هذا سوف ينتج: prog.rb:3: Gotcha (RuntimeError) from prog.rb:2:in `initialize' from prog.rb:2:in `new' from prog.rb:2‎ انظر أيضا التابع abort_on_exception: يُعيد حالة الشرط المحلي (thread-local‏) "المقاطعة عند حدوث استثناء؟" (abort on exception) في المهمة الفرعية التي ...

يُعيد التابع to_s المُعرِّف الفريد (unique identifier) لكتلة proc محدّدة بالتزامن مع إشارة لمكان تعريف هذه الكتلة. يملك هذا التابع اسمًا بديلًا هو inspect. البنية العامة to_s → string القيم المعادة تُعاد سلسلةٌ نصيَّةٌ (string) تُمثِّل المُعرِّف الفريد للكتلة proc المعطاة بالإضافة إلى إشارة لمكان تعريف هذه الكتلة. انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن proc الذي استدعي معه. التابع binding: يُعيد الرَّبط الموافق للكائن Proc الذي استدعي معه. التابع curry: يُعيد كتلة proc مقسَّمة. التابع parameters: ...

ينشئ التابع attr_reader متغيرات نسخ (instance variables) والتوابع المقابلة التي تعيد قيمة متغيرات النسخ هذه. وهو مكافئ لاستدعاء "attr:name" على كل اسم name بالتتابع. تحول الوسائط النصية إلى رموز. البنية العامة attr_reader(symbol, ...) → nil attr(symbol, ...)→ nil attr_reader(string, ...) → nil attr(string, ...)→ nil‎ المعاملات symbol‎ رمز يمثل الخاصية. string‎ سلسلة نصية تمثل الخاصية. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr: الشكل الأول لهذا التابع مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ التابع attr_accessor. التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه ...

ينشئ التابع new وحدة مجهولة (anonymous module) جديدة. في حال إعطاء كتلة، فسيٌمرر إليها الوحدة (module)، وستُقيم الكتلة في سياق هذه الوحدة مثل module_eval. اضبط الوحدة وأسند إليها قيمةً ثابتةً (يبدأ اسمها بحرف كبير) إذا كنت تريد معاملتها كأنها وحدة عادية. البنية العامة new→ mod new {|mod| block }→ mod‎ القيمة المعادة تعاد وحدة مجهولة (anonymous module) جديدة. أمثلة مثال على استخدام التابع new‎: fred = Module.new do def meth1 "hello" end def meth2 ...

يقدِّر التابع eval تعابير لغة روبي الممررة إليه في السياق Binding. في حال تمرير الوسيطين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن وجود أخطاء في الصياغة (syntax errors). البنية العامة eval(string [, filename [,lineno]]) → obj المعاملات string سلسلة نصية تحوي تعابير روبي المراد تقديرها في السياق Binding. filename سلسلة نصية تمثل اسم الملف. إن أعطي هذا المعامل الاختياري، فسيُستعمَل عند الإبلاغ عن وجود أخطاء في الصياغة. lineno سلسلة نصية تمثل رقم السطر. إن أعطي هذا المعامل الاختياري، فسيُستعمَل ...