نتائج البحث

السلاسل النصية (string) هي سلسلة تحتوي على حرف واحد أو أكثر وقد تحتوي على حروف أبجدية، مثل أرقام ورموز، ويكون كل حرف (أو رمز أو رقم) ممثلاً ببايت. السلاسل النصية في لغة البرمجة روبي عبارة عن كائنات (Objects)، وعلى عكس لغات البرمجة الأخرى، فإن النصوص قابلة للتغيير (Mutable) والتي تعني أننا نستطيع تعديل النصوص بدلًا من إنشاء نصوص جديدة. علامتا الاقتباس المزدوجتين والمفردتين يتم إنشاء السلاسل النصية (string) في لغة روبي باستعمال علامات الاقتباس المزدوجة (مثل "string") أو المفردة (مثل ...

تضمّ وحدة string عددًا من الثوابت والأصناف المفيدة في معالجة السلاسل النصية. وتدعم السلاسل النصية في بايثون مجموعة التوابع الخاصّة بالنوع str إلى جانب التوابع الخاصّة بالوحدة string. تقدّم الوحدة string الصنفين التاليين: الصنف Formatter: يتيح هذا الصنف من خلال توابعه إنشاء عمليات تنسيق السلاسل النصية جديدة وتخصيصها حسب الرغبة وبنفس الأسلوب المتّبع في الدالة الداخلية format()‎. الصنف Template: يقدّم هذا الصنف طريقة أبسط لإجراء عمليات الاستبدال في السلاسل النصية والموصوفة في PEP 292. حيث يمكن إجراء عمليات الاستبدال باستخدام ...

تنشئ الدالة String()‎ نسخةً من الصنف String. هنالك طرائق متعدِّدة لإنشاء سلاسل نصية من أنواع مختلفة من البيانات وهي استدعاء الدالة String()‎ مع: سلسلة نصية ثابتة من المحارف ضمن علامتي اقتباس مزدوجتين (أي مصفوفة من المحارف)، أو محرف ثابت وحيد ضمن علامتي اقتباس مفردتين، أو نسخة أخرى من الكائن String، أو عدد صحيح ثابت أو عدد طويل ثابت، أو عدد صحيح ثابت أو عدد طويل ثابت باستعمال أساس محدَّد، أو عدد صحيح أو عدد طويل متغير، أو عدد صحيح أو ...

تحول الدالة String()‎ جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد. البنية العامة inline fun String(bytes: ByteArray, charset: Charset): String inline fun String( bytes: ByteArray, offset: Int, length: Int, charset: Charset ): String بيئة التشغيل المطلوبة: JVM. تحول الدالة String()‎ جميع محتويات المصفوفة bytes أو جزءًا محددًا منها (يبدأ عند العنصر الذي ينزاح بمقدار offset ...

يتحقق المعامل == من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى. إذا لم يكن الكائن من نوع سلسلة نصية، فيمكن استعمال الدالة to_s لتحويله إلى سلسلة نصية إذا أمكن ذلك. البنية العامة str == obj → true or false المعاملات str سلسلة نصية تمثل الطرف الأول من عملية التحقق. obj الكائن المُراد التحقق من مساواته مع السلسلة النصية str. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية str مساويةً للكائن obj ...

يبدِّل المعامل [] عند استدعائه بالشكل ‎[]=‎‎ سلسلةً نصيةً محدَّدةً مكان جزءٍ محدَّد أو كامل محتوى سلسلة نصية أخرى. البنية العامة str[integer] = new_str str[integer, integer] = new_str str[range] = aString str[regexp] = new_str str[regexp, integer] = new_str str[regexp, name] = new_str str[other_str] = new_str يحدَّد الجزء المراد تبديله من السلسلة النصية str بالطريقة نفسها المذكورة في المعامل []. إن كان طول السلسلة النصية المعطاة لا يطابق طول السلسلة النصية (أو الجزء المحدّد) المراد تبديله، فستُعدَّل السلسلة النصية المعطاة تلك وفقًا لذلك. إن كان التعبير النمطي أو ...

ينسخ المعامل * سلسلة نصية عددًا محدَّدًا من المرات ثم يضعها في سلسلة نصية جديدة. البنية العامة str * integer → new_str المعاملات str السلسلة النصية المضروبة بالعدد integer لنسخها n مرة. integer عدد صحيح موجب يمثِّل عدد المرات التي يراد فيها نسخ السلسلة النصية str. القيمة المعادة تعاد سلسلة نصية جديدة مؤلفة من integer نسخة من السلسلة النصية str المعطاة. أمثلة مثال على استخدام المعامل *: "Ho! " * 3 #=> "Ho! Ho! Ho! " "Ho! " * ...

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

يُلحق المعامل >> الكائن المُعطى بالسلسلة النصية. في حال كان هذا الكائن عددًا صحيحًا، فإنه يُعتبر نقطة ترميز (codepoint) ويُحول إلى المحرف المقابل له قبل أن يضاف إلى السلسلة النصية. البنية العامة str << obj → str str << integer → str القيمة المعادة تعاد السلسلة النصية str مضافًا إليها الكائن obj أو العدد integer الصحيح بعد تحويله إلى المحرف المقابل له. أمثلة مثال على استخدام المعامل >>: a = "hello " a << "world" #=> "hello world" a << 33 ...

يعيد المعامل - عند استدعائه بالشكل str- نسخةً مطابقةً ومجمدةً للسلسلة النصية str في حال كانت غير مجمدة. أما إذا كانت مجمدة، فسيعيد التابع السلسلة النصية نفسها. البنية العامة -str → str (frozen) القيمة المعادة تُعاد نسخة مطابقة ومجمدة من السلسلة النصية str إن كانت هذه السلسلة غير مجمدة، أو تُعاد السلسلة النصية نفسها إن كانت مجمدة. أمثلة مثال على استعمال المعامل -: n1= “Hello” n1<<”World” #=> “HelloWorld” n2= -n1 n2<<”Guys” #=> FrozenError (can't modify frozen String) انظر أيضًا ...

يطبِّق المعامل % السلسلة النصية الواقعة على يساره التي تعد سلسلة تنسيق معيارية على الكائن المعطى الواقع على يمينه ثم يعيد الناتج. إن حوت سلسلة التنسيق أكثر من من عنصر نائب، فيجب أنذاك أن يكون الكائن الذي ستطبق عليه مصفوفةً أو كائنًا من النوع Hash يحوي القيم التي ستأخذ مكان العناصر النائبة المقابلة. البنية العامة str % arg → new_str المعاملات str سلسلة التنسيق التي ستُطبَّق على محتوى المعامل arg. لمزيد من التفاصيل حول صياغة سلسلة التنسيق، اطلع على صفحة ...

يجمع المعامل + سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة. البنية العامة str + other_str → new_str القيمة المعادة تعاد سلسلة جديدة مؤلفة من السلسلة str المُستدعاة مضافًا إليها السلسلة النصية other_str. أمثلة مثال على استخدام المعامل +: "Hello ” + “World” #=> “Hello world” "Hello from " + self.to_s #=> "Hello from main" انظر أيضًا المعامل ‎+@‎: يعيد عند استدعائه بالشكل str+ نسخةً مطابقةً للسلسلة النصية str وقابلةً للتغيير (Mutable) في حال كانت ...

يطابق المعامل ~= الكائن المُعطى مع سلسلة نصية. إذا كان الكائن عبارة عن تعبير نمطي (Regexp)، فإن المعامل يستعمله كنمط لمطابقة السلسلة النصية، ثم يعيد فهرس أول تطابق يعثر عليه، أو يعيد القيمة nil فى حال عدم وجود تطابق. عدا ذلك، فإنَّ المعامل يستدعي الكائن المعطى، ويمرر السلسلة النصية إليه كمعامل. ملاحظة: الصيغة str =~ regexp ليست مثل regexp =~ str، حيث تُعين السلاسل الملتقطة من مجموعات الالتقاط المسماة إلى المتغيرات المحلية فى الحالة الثانية فقط. البنية العامة str =~ ...

يعيد المعامل + عند استدعائه بالشكل str+ نسخةً مطابقةً للسلسلة النصية str وقابلةً للتغيير (Mutable) في حال كانت هذه السلسلة النصية مجمدة. أما إذا كانت السلسلة النصية غير مجمدة، فسيعيد المعامل السلسلة النصية نفسها. البنية العامة +str → str (mutable) c القيمة المعادة تعاد نسخة مطابقة وقابلة للتغيير (Mutable) من السلسلة النصية str المعطاة إن كانت هذه السلسلة مجمَّدة؛ أما إن لم تكن مجمدة، فستُعاد السلسلة النصية نفسها. أمثلة مثال على استعمال المعامل +: n1= “Hello ” n1.freeze n2 = +n1 n2<<”World” puts n2 المثال ...

يتحقق المعامل === من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى. إذا لم يكن الكائن من نوع سلسلة نصية، فيمكن استعمال الدالة to_s لتحويله إلى سلسلة نصية إذا أمكن ذلك. البنية العامة str === obj → true or false المعاملات str السلسلة النصية وتمثل الطرف الأول من عملية التحقق. obj الكائن المُراد التحقق من مساواته مع السلسلة النصية str. القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية str مساويةً للكائن obj ...

يُقارن المعامل <=> بين سلسلتين نصيتين ثم يعيد القيم 1-، أو 1، أو 0 إذا ما كانت السلسلة النصية الأولى أكبر أو أصغر أو تساوي السلسلة النصية الثانية على التوالي. يعيد المعامل القيمة nil إذا كانت القيمتين غير قابلتين للمقارنة. إذا اختلفت سلسلتين نصيتين في الطول، وكانتا متطابقتين حتى نقطة معينة، فإنَّ السلسلة الأطول من بعد هذه النقطة هي السلسلة الأكبر. البنية العامة string <=> other_string → -1, 0, +1, or nil المعاملات str السلسلة النصية الأولى. other_str السلسلة النصية ...

توفر الوحدة querystring مجموعة من الأدوات لتحليل وتنسيق سلاسل الاستعلامات في الروابط (URL query strings). يُمكِن استيراد الوحدة والبدء باستخدامها عبر تنفيذ: const querystring = require(‘querystring’); querystring.escape(str)‎ أُضيفَ في الإصدار 0.1.25. str من النوع <string>. يرمِّز هذا التابع المحارِف المُمرَّرة للمُعامِل الأوَّل str بترميز النسبة المئويّة لتحويله إلى سلسلة استعلامات صالحة. مثال: querystring.escape("foo=bar&bar=foo"); // 'foo%3Dbar%26bar%3Dfoo' يُستخدَم التابع querystring.escape()‎ عبر التابع querystring.stringify()‎ ولا يتوقع منه أن يستدعى مباشرةً. يُستخدَم هذا التابِع عادةً لتوفير آلية بديلة تقوم بعمليّة ترميز النسبة المئويّة إن لزم الأمر. ...

وحدة فك الترميز string_decoder توفر واجهة برمجية API لفك ترميز كائنات Buffer إلى سلاسل بطريقة تصون المحارف متعددة البايتات المرمزة بواسطة UTF-8 و UTF-16. يمكن الوصول إلى هذه الوحدة باستخدام: const { StringDecoder } = require('string_decoder'); المثال التالي يعرض الاستخدام الأساسي لصنف StringDecoder: const { StringDecoder } = require('string_decoder'); const decoder = new StringDecoder('utf8'); const cent = Buffer.from([0xC2, 0xA2]); console.log(decoder.write(cent)); const euro = Buffer.from([0xE2, 0x82, 0xAC]); console.log(decoder.write(euro)); عندما تُكتَب نسخة من الصنف Buffer إلى نسخة من الصنف StringDecoder، ستُستخدم ذاكرة مؤقتة داخلية لضمان أنّ السلسلة مفكوكة الترميز ...

يعيد التابع chop نسخةً عن السلسلة النصية مع حذف المحرف الأخير منها. إذا انتهت السلسلة بالمحرفين r\n\ على الترتيب، فسيحذف التابع هذين المحرفين. إذا استُعمل التابع chop مع سلسلة نصية فارغة،فسيعيد سلسلة نصية فارغة وليس القيمة nil. في أغلب الأحيان، يعتبر التابع chomp بديلاً أكثر أمانًا للتابع chop، لأنه يبقي نسخة السلسلة النصية بدون تغيير في حال لم تنتهِ بالفاصل المُحدد، على عكس التابع chop الذي يحذف المحرف الأخير دومًا. البنية العامة chop → new_str القيمة المعادة تُعاد نسخة عن ...

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

يعيد التابع 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 في توثيق روبي الرسمي.