نتائج البحث

يعيد التابع 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 سلسلة نصية تمثل رقم السطر. إن أعطي هذا المعامل الاختياري، فسيُستعمَل ...

يشبه التابع binwrite التابع write باستثناء أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("wb: ASCII-8BIT‏")‏. البنية العامة binwrite(name, string, [offset] ) → integer binwrite(name, string, [offset], open_args ) → integer‎ المعاملات name‎ اسم الملف المراد الكتابة فيه. string‎ سلسلة نصية يراد كتابتها ضمن الملف name. offset‎ عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية الكتابة بدءًا من الموضع الحالي. open_args‎ خيارات فتح الملف للكتابة فيه. القيمة المعادة يعاد عددٌ صحيحٌ يمثِّل عدد ...

يتحقق التابع const_defined?‎ مما إذا كانت الوحدة التي استُدعي معها أو أحد أسلافها (ancestors) تحوي الثابت المعطى. Float.const_defined?(:EPSILON) #=> true, found in Float itself Float.const_defined?("String") #=> true, found in Object (ancestor) BasicObject.const_defined?(:Hash) #=> false إذا كانت الوحدة من النوع Module، فسيتم إضافة إلى ذلك فحص Object وكذلك أسلافه. Math.const_defined?(:String) #=> true, found in Object في كل الأصناف أو الوحدات المفحوصة، إذا لم يكن الثابت موجودًا وكان التحميل التلقائي (autoload) مفعلًا له، ...

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

يُقيِّم التابع class_eval السلسلة النصية أو الكتلة المعطاة في سياق الوحدة التي استُدعي معها، إلا أنه عند إعطاء كتلة، فلن تتأثر عملية البحث عن متغيرات الأصناف/الثوابت. يمكن استخدامه لإضافة توابع إلى صنف ما. يعيد التابع module_eval نتيجة تقييم الوسيط الممرر إليه. البنية العامة class_eval(string [, filename [, lineno]]) → obj class_eval {|mod| block } → obj‎ المعاملات string‎ السلسلة النصية المراد تقييمها. filename‎ يحدد هذا المعامل والمعامل lineno نص رسائل الخطأ. lineno‎ يحدد هذا المعامل والمعامل filename نص رسائل الخطأ. القيمة ...

يتحقّق التابع compatible?‎ من توافق كائنين مع بعضهما بعضًا. إذا كان نوع كلا الكائنين سلسلة نصية (string)، فإنهما يكونان متوافقين عندما يكونان قابلين للتسلسل (Concatenation). أمَّا إن لم يكن هذان الكائنان سلسلةً نصيةً، فسيُعدُّ كلاهما متوافقين عندما يملكان ترميزًا وكان: كلا الترميزين متوافق مع الترميز US-ASCII، أو أحد هذان التّرميزان هو ترميز من النوع 7-bit. البنية العامة compatible?(obj1, obj2) → enc or nil المعاملات obj1 الكائن الأول المراد التحقق من توافقه مع الكائن obj2. obj2 الكائن الثاني المراد التحقق من ...

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

يُحوِّل التابع id2ref_ معرِّف الكائن (id) إلى مرجعٍ للكائن. لا يجب استدعاؤه على معرِّف كائنٍ مُرِّر كمعامل ٍ إلى مُنهِي (finalizer). البنية العامة _id2ref(object_id) → an_object المعاملات object_id رقم معرِّف الكائن. القيم المعادة يُعاد الكائن المُسند إلى المُعرِّف object_id. أمثلة مثالٌ عن استخدام التابع id2ref_: s = "I am a string" #=> "I am a string" r = ObjectSpace._id2ref(s.object_id) #=> ...

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

يُرتِّب التابع sort_by!‎ المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة. لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. في حال عدم تمرير كتلة برمجية إلى التابع sort_by!‎، سيعيد كائنًا من النوع Enumerator. البنية العامة sort_by! { |obj| block } → ary sort_by! → Enumerator القيم المعادة تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها وفقًا للقيمة التي تعيدها ...

يعين التابع public المرئية (visibility) الافتراضية للتوابع المعرفة لاحقًا إلى public العامة إن لم يمُرَّر إليه أي شيء. أما في حال تمرير اسم تابع (أو عدة توابع إليه)، فسيضبط مرئية هذه التوابع المرئية public العامة.  تُحول الوسائط النصية String إلى رموز. البنية العامة public → self public(symbol, ...) → self public(string, ...) → self‎ المعاملات symbol‎ رمز يمثل التابع المراد ضبط مرئيته إلى عامة. string‎ سلسلة نصية تمثل التابع المراد ضبط مرئيته إلى عامة. يحول هذا المعامل إن أعطي إلى رمز. ... رمز أو سلسلة نصية تمثل التوابع المراد ضبط مرئيتها إلى عامة. القيمة المعادة ...

يعيد التابع urandom سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة. يفترض بالقيمة المعادة أن تكون عددًا محميًّا مشفرًا شبه عشوائي بالصيغة الثنائية. يرمي هذا التابع الاستثناء RuntimeError إذا فشلت الميزة المزودة من المنصة في تحضير النتيجة. في عام 2017، كتب في صفحة الدليل man للدالة (random(7 في لينكس: "لا يوجد تشفيرٌ أساسيٌ موجودٌ اليوم يمكن يعدنا بأكثر من 256 بت من الحماية". لذلك  تمرير قيمة ذات حجم أكبر من 32 إلى هذا التابع قد يكون أمرًا مريبًا. البنية العامة urandom(size) ...

يكتب التابع write_nonblock السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام استدعاء النظام write(2)‎ بعد تعيين قيمة الراية O_NONBLOCK الخاصة بواصف الملف (file descriptor) الأساسي. يستدعي التابع write_nonblock استدعاء النظام write(2)‎. ويتسبب في كافة الأخطاء التي يتسبب فيها استدعاء النظام write(2)‎، مثل Errno::EWOULDBLOCK و Errno::EINTR وغيرهما. قد تكون النتيجة أصغر من طول السلسلة النصية (أي أن الكتابة جزئية). لذا يجب أن يعالج المستدعي هذه الأخطاء، إضافة إلى مسألة الكتابة الجزئية. إن كان الاستثناء يساوي Errno::EWOULDBLOCK أو Errno::EAGAIN، فسيتم توسيعه ...

ينشئ التابع new تعبيرًا نمطيًّا جديدًا من النمط المُمرَّر إليه، والذي يمكن أن يكون إما سلسلة نصية أو كائنًا من النوع Regexp (وفي هذه الحالة يتم نشر خيارات التعبير النمطي)؛ وقد لا يتم تحديد الخيارات الجديدة (منذ روبي 1.8). البنية العامة new(string, [options]) → regexp new(regexp)→ regexp compile(string, [options])→ regexp compile(regexp) → regexp‎ المعاملات string‎ سلسلة نصية. options‎ الخيارات التي تتحكم بالتعبير النمطي. إن كان المعامل options عددًا صحيحًا، فيجب أن يساوي واحدًا أو أكثر من الثوابت التالية: Regexp::EXTENDED أو Regexp::IGNORECASE أو Regexp::MULTILINE، ...

يتحقق التابع unicode_normalized?‎ إذا كانت السلسلة النصية التي استدعيت معه ذات ترميز موحَّد باستخدام أحد ترميزات يونيكود الموحدة (Unicode normalizations). يطلق التابع استثناءً إذا كانت السلسلة النصية غير مُرمّزة بترميز يونيكود. لمزيد من التفاصيل، اطلع على صفحة التابع unicode_normalize. البنية العامة unicode_normalized?(form=:nfc) المعاملات form يحدد نمط ترميزات يونيكود الموحدة المراد التحقق منها مع السلسلة النصية المعطاة؛ ويأخذ إحدى القيم التالية: nfc: (القيمة الافتراضية) nfd: nfkc: nfkd: القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية مرمزة بأحد ترميزات يونيكود الموحدة ...

يُعيد التّابع destination_encoding_name اسم الترميز الهدف. البنية العامة destination_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الهدف. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف على شكل كائن. التابع error_char: يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز المصدر. مصادر قسم التابع destination_encoding_name في الصنف Encoding::UndefinedConversionError في توثيق روبي الرسمي.

يُعيد التّابع source_encoding_name اسم التّرميز المصدر. البنية العامة source_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز المصدر. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف على شكل كائن. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التابع error_char: يُعيد سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. التّابع source_encoding: يعيد التّرميز المصدر. مصادر صفحة التابع source_encoding_name في الصنف Encoding::UndefinedConversionError في توثيق روبي الرسمي.

يقرأ التابع readline سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع gets باستثناء أنَّه يُطلق الاستثناء EOFError عند نهاية الملف. البنية العامة readline(sep=$/ [, getline_args]) → string readline(limit [, getline_args])→ string readline(sep, limit [, getline_args]) → string‎ المعاملات sep‎ محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: /$. limit‎ عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها. getline_args راجع صفحة readlines لمزيد من التفاصيل حول هذا المعامل. القيمة المعادة تعاد سلسلة نصية تحوي السطر الذي قُرِئ من المجرى المعطى، أو يطلق ...

يكتب التابع pwrite السلسلة النصية المُمرَّرة إليه في موضع محدَّد من المجرى الذي استُدعي معه باستخدام استدعاء دالة النظام pwrite()‎. هذا مفيد مقارنة بالجمع بين التابعين seek و write معا في كونه ذريًا (atomic)، مما يسمح لعدة مهام فرعية/عمليات بالتشارك في نفس المجرى لقراءة الملف من مواضع مختلفة. هذا سيتجاوز أي مساحة تخزين مؤقت للمستخدمين من المجرى. سيعيد التابع pwrite عدد البايتات المكتوبة، أو سيُطلق الاستثناء SystemCallError في حال حدوث خطأ، أو NotImplementedError إذا لم يكن نظام الشغيل يدعم استدعاء النظام. البنية ...

يعيد التابع String المعامل المعطى على شكل سلسلة نصية (String). يحاول التابع String في البدء استدعاء التابع to_str ثم التابع to_s. البنية العامة String(arg)→ string‎ المعاملات arg القيمة المراد تحويلها إلى سلسلة نصية. القيمة المعادة تعاد سلسلة نصية تحوي قيمة المعامل arg المعطى. أمثلة مثال على استخدام التابع String‎: String(self) #=> "main" String(self.class) #=> "Object" String(123456) #=> "123456" ‎ انظر أيضا التابع Array: يعيد المعامل المعطى على شكل مصفوفة (Array). التابع Integer: يحول ...

يُطلق الاستثناء TypeError عند استقبال كائن من غير النوع المتوقع. [1, 2, 3].first("two") عند تنفيذ هذه الشيفرة، سيُطلق الاستثناء TypeError بالشكل التالي: TypeError: no implicit conversion of String into Integer مصادر صفحة الصنف TypeError في توثيق روبي الرسمي.

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

يُعيد التّابع asciicompat_encoding التّرميز المتوافق مع ASCII المقابل للترميز المعطى. هذا التّرميز المقابل الذي يعيده التابع هو ترميزٌ متوافقٌ مع ASCII يمثّل نفس المحارف تمامًا الموجودة في التّرميز المعطى غير المتوافق مع ASCII. بناءً على ذلك، لن يحدث أي خطأ عند التّحويل بين هذين التّرميزين. البنية العامة Encoding::Converter.asciicompat_encoding(string) → encoding or nil Encoding::Converter.asciicompat_encoding(encoding) → encoding or nil المعاملات string سلسلةٌ نصّيةٌ تمثل الترميز غير المتوافق مع ASCII. encoding كائن الترميز غير المتوافق مع ASCII. القيم المعادة يُعاد كائن من النوع Encoding ...

يُعيد التّابع destination_encoding_name اسم الترميز الهدف. البنية العامة destination_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الهدف. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع readagain_bytes: يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز المصدر. مصادر صفحة التابع destination_encoding_name في ...

يُعيد التّابع source_encoding_name اسم التّرميز المصدر. البنية العامة source_encoding_name → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز المصدر. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع readagain_bytes: يعُيد البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. التّابع source_encoding: يعيد التّرميز المصدر. مصادر صفحة التابع source_encoding_name ...

يكافئ المعامل []‎ الاستدعاء Dir.glob([string,...], 0)‎. البنية العامة Dir[ string [, string ...] [, base: path] ] → array القيمة المعادة تُعاد مصفوفة تحوي النتائج. أمثلة مثال عن استخدام المعامل []‎ مع المجلد testdir الذي يحتوي ملفين عاديين (الملف config.h والملف main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): Dir["config.?"] #=> ["config.h"] انظر أيضًا التابع chdir‎: يستبدل التابع chdir‎ مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه ...

يمثل الصنف InstructionSequence تسلسلًا مصرّفًا (compiled sequence) للتعليمات الخاصة بالآلة الافتراضية (Virtual Machine) لروبي. يمكّنك هذا الصنف من الحصول على مؤشر (handle) للتعليمات التي تشكل التابع أو الكتلة البرمجية، وتصريف (compile) سلاسل روبي النصية إلى تعليمات الآلة الافتراضية (VM)، وتفكيك التعليمات إلى سلاسل نصية لتسهيل فحصها. هذا الصنف مفيد للغاية إن كنت ترغب في معرفة كيفية عمل آلة روبي الافتراضية، لكنه يتيح لك أيضًا التحكم في إعدادات المُصرِّف iseq لروبي. يمكنك العثور على مصدر إرشادات الآلة الافتراضية في الصفحة insns.defفي ...

يعُيد التابع readagain_bytes البايتات المراد قراءتها مجدّدًا عندما يقع الخطأ InvalidByteSequenceError. البنية العامة readagain_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل البايتات المطلوب قراءتها مجدَّدًا عندما يقع الخطأ InvalidByteSequenceError. انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع error_bytes: يُعيد البايتات التي رُفضَت عندما وقع الخطأ InvalidByteSequenceError. التّابع ?incomplete_input: يتحقّق فيما إذا كان خطأ تسلسل البايت الحاصل ناتجًا عن إنهاءٍ مُبكِّرٍ للسّلسلة النّصية. التّابع source_encoding: يعيد التّرميز المصدر. التّابع source_encoding_name: يُعيد اسم التّرميز ...

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

يُعيد التّابع error_char سلسلة نصية تحوي المحرف الذي أدى إلى رمي الاستثناء UndefinedConversionError. البنية العامة error_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تحوي المحرف الذي كان سببًا في رمي الاستثناء UndefinedConversionError. أمثلة مثالٌ عن استخدام  التّابع error_char: ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP") begin ec.convert("\xa0") rescue Encoding::UndefinedConversionError puts $!.error_char.dump #=> "\xC2\xA0" p $!.error_char.encoding #=> #<Encoding:UTF-8> end انظر أيضًا التّابع destination_encoding: يُعيد التّرميز الهدف على شكل كائن. التّابع destination_encoding_name: يُعيد اسم الترميز الهدف. التّابع source_encoding: يعيد التّرميز المصدر. ...

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

يكافئ التابع printf التعبير التالي: io.write(sprintf(string, obj, ...))‎ أو التعبير التالي: $stdout.write(sprintf(string, obj, ...))‎ البنية العامة printf(io, string [, obj ... ]) → nil printf(string [, obj ... ]) → nil‎ المعاملات io‎ مجرى من النوع IO ستكتب عليه البيانات. string‎ السلسلة النصية المراد طباعتها. obj ...‎ كائنات أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد طباعة السلسلة string على مخرج الخرج القياسي أو المجرى io إن أعطي. انظر أيضا التابع print: يطبع الكائنات الممرة إليه بالتتابع على المجرى stdout$. ...

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

يعيد التابع inspect‎ محتوى البيئة (environment) في سلسلة نصية. البنية العامة inspect → string القيمة المعادة تُعاد سلسلة نصية تمثِّل محتوى البيئة. انظر أيضًا التابع select: يعيد نسخة من البيئة (environment) تضم المدخلات التي تحقِّق شرطًا معيَّنًا. التابع empty?‎: يتحقَّق من عدم وجود أي متغيرات بيئة. مصادر قسم التابع inspect في الصنف ENV في توثيق روبي الرسمي.

يزوِّد الصنف Random واجهةً لمولِّد أعدادٍ شبه عشوائيَّةٍ (pseudo-random number generator، أو يُدعى PRNG) في روبي. يُنتج مولِّد الأرقام شبه العشوائيَّة (PRNG) سلاسل محدَّدةً من البِتات تقارب العشوائيَّة الحقيقية. يمكن أن تمثِّل هذه السلاسل أعدادًا صحيحيةً (integers)، أو أعدادًا عشريةً (floats)، أو سلاسل نصيَّة ثنائيَّة (binary strings). يُهيَّأ هذا المولِّد ببذرة تعطى (seed) إمَّا من قبل النظام (system-generated) أو من قبل المستخدم (user-supplied) عبر استخدام التابع srand. يوفر تابع الصنف rand الوظيفة القاعديَّة للتابع Kernel.rand بالترافق مع معالجةٍ أفضل للقيم ...

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

يُعيد التّابع to_s معلوماتٍ عن الليف (fiber) بشكل سلسلةٍ نصيةٍ. لهذا التابع اسم بديل هو: inspect. البنية العامة to_s → string القيم المعادة تُعاد سلسلةٌ نصيةٌ تحتوي معلومات عن الليف. انظر أيضا التابع current: يعيد الليف (fiber) الحالي. التابع ?alive: يُعيد القيمة true إذا كان لا يزال استئناف (أو نقل) الليف (fiber) ممكنًا. مصادر صفحة التابع to_s في الصنف Fiber في توثيق روبي الرسمي.

يعيد التابع name الاسم المقترن بالاستثناء NameError الحالي. البنية العامة name → string or nil‎ القيمة المعادة تعاد سلسلة نصية تمثِّل الاسم المقترن بالاستثناء NameError الحالي. انظر أيضا التابع local_variables: يعيد قائمة بأسماء المتغيرات المحلية المُعرّفة حيث أُطلٍق الخطأ NameError. التابع receiver: يعيد المستقبل (receiver) المقترن بالاستثناء NameError الحالي. مصادر قسم التابع name‎ في الصنف NameError‎ في توثيق روبي الرسمي.

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

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

يعيد التابع b نسخة من السلسلة النصية التي استدعيت معه مرمزة بالترميز ASCII-8BIT. البنية العامة b → str القيمة المعادة تعاد نسخة من السلسلة النصية المعطاة مرمزة بالترميز ASCII-8BIT. انظر أيضًا التابع new: ينشئ سلسلةً نصيةً جديدةً تحوي البيانات المُمرَّرة إليه. التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. مصادر قسم التابع ‎b في الصنف String في توثيق روبي الرسمي.

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

يُعيد التابع encoding ترميز السلسلة النصية التي استُدعيت معه. البنية العامة encoding → encoding القيمة المعادة يُعاد ترميز السلسلة النصية المُعطاة. أمثلة مثال على استعمال التابع encoding: "hello".encoding   #=> #<Encoding:ASCII-8BIT> "\u0639".encoding #=> #<Encoding:UTF-8> انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع force_encoding: يغير ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. مصادر قسم التابع encoding‎ في الصنف String في توثيق روبي الرسمي.

يُعيد التّابع inspect اسم صنف الاستثناء ورسالته. البنية العامة inspect → string القيم المعادة تُعاد سلسلةٌ نصيةٌ تحوي اسم صنف الاستثناء ورسالته. انظر أيضا التابع to_s: يُعيد رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة). التابع full_message: يُعيد سلسلةً نصيةً منسّقةً من الاستثناء. التابع message: يُعيد ناتج استدعاء التّابع Exception.to_s. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه. مصادر صفحة التابع inspect في الصنف Exception في توثيق روبي الرسمي.

يعيد التابع getwd مسار مجلد العمل (working directory) الحالي للعملية الحالية. البنية العامة getwd → string القيمة المعادة تُعاد سلسلة نصية تحوي مسار مجلد العمل الحالي للعملية. أمثلة مثال عن استخدام التابع getwd: Dir.chdir("/tmp") #=> 0 Dir.getwd #=> "/tmp" Dir.pwd #=> "/tmp" انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي للعملية إلى مجلد آخر محدَّد. مصادر ...

يغيِّر التابع force_encoding ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. البنية العامة force_encoding(encoding) → str المعاملات encoding يمثل الترميز الجديد للسلسلة النصية. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد تغيير ترميزها إلى الترميز encoding. انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع encoding: يُعيد ترميز السلسلة النصية التي استُدعيت معه. مصادر قسم التابع ‎force_encoding في الصنف String في توثيق روبي الرسمي.

يتحقق التابع ascii_only?‎ إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. البنية العامة ascii_only? → true or false القيمة المعادة تُعاد القيمة true إذا كانت السلسلة مؤلفة فقط من محارف مرمزة بالترميز ASCII، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع ascii_only?‎: "abc".force_encoding("UTF-8").ascii_only? #=> true "abc\u{6666}".force_encoding("UTF-8").ascii_only? #=> false انظر أيضًا مصادر قسم التابع ?‎‎ascii_only في الصنف String في توثيق روبي الرسمي.

يُعيد التّابع error_bytes البايتات التي أهملت عندما وقع الخطأ InvalidByteSequenceError. البنية العامة error_bytes → string القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل البايتات التي أهملت (discarded bytes) عندما وقع الخطأ InvalidByteSequenceError. أمثلة مثالٌ عن استخدام  التّابع error_bytes: ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1") begin ec.convert("abc\xA1\xFFdef") rescue Encoding::InvalidByteSequenceError p $! #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "\xFF" on EUC-JP> puts $!.error_bytes.dump #=> "\xA1" puts $!.readagain_bytes.dump ...

يكافئ التابع chomp التعبير ‎$_ = $_.chomp( string)‎. انظر صفحة String.chomp. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر ‎-‎p/-n. البنية العامة chomp→ $_ chomp(string) → $_‎ القيمة المعادة يعاد ناتج التعبير ‎$_ = $_.chomp( string)‎. انظر أيضا التابع chop: يكافئ التعبير ‎($_.dup).chop!‎ ، باستثناء أنّ nil لا تُعاد أبدًا. مصادر قسم التابع chomp‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يضيف التّابع insert_output سلسلةً نصيّةً إلى محوِّل التّرميز، إذ سيُحول ترميز هذه السلسلة إلى ترميز الوجهة نفسه وتُوضع في نهاية مخرجات عملية التحويل. إذا كان التّرميز الوجهة هو من أحد الترميزات التي لها حالة (stateful encodings)، فستُحوَّل السلسلة حسب حالة الترميز وتُحدَّث الحالة بعدئذٍ. لا يجب استخدام هذا التّابع إلا عند حدوث أخطاء في عملية التحويل. البنية العامة insert_output(string) → nil المعاملات string السلسلة النصيّة المراد إدخالها في محوَّل الترميز. القيم المعادة تعاد القيمة nil بعد إضافة السلسلة النصية string ...

يُطلق الاستثناء NoMethodError عند استدعاء تابعٍ مع مستقبِل (receiver) غير مُعرَّف فيه مع فشل الاستجابة للتابع method_missing. "hello".to_ary سيُطلق الاستثناء NoMethodError عند تنيفذ الشيفرة السابقة بالشكل: NoMethodError: undefined method `to_ary' for "hello":String توابع الصنف العامة (Public Class Methods) new ينشئ استثناءً من النوع NoMethodError للتابع ذي الاسم المعطى مع الوسائط المُمرَّرة. توابع النسخة العامة (Public Instance Methods) args يعيد الوسائط التي تم تمريرها كمعامل ثالث إلى الباني new. ?private_call مصادر قسم الصنف NoMethodErrorفي توثيق روبي الرسمي.