نتائج البحث

يعدُّ التابع lines اسمًا بديلًا مهملًا للتابع each_line. البنية العامة lines(*args) انظر أيضًا التابع each_line: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه. مصادر قسم التابع lines‎ في الصنف IO‎ في توثيق روبي الرسمي.

يُدوّر التابع rotate!‎ عناصر المصفوفة التي استُدعيت معه ليكون العنصر ذو الفهرس الممرَّر إليها هو العنصر الأول. إن كان العدد الممرَّر إليها سالبًا، فسيُدوّر التابع rotate!‎ المصفوفة في الاتجاه المعاكس، إذ يُحسَب موضع العنصر بدءًا من نهاية المصفوفة فسيكون فهرس العنصر الأخير هو ‎-1‎. البنية العامة rotate!(count=1) → ary المعاملات count عددٌ صحيحٌ يمثل فهرس العنصر الذي يراد أن يصبح أول عنصرٍ في المصفوفة المعطاة. القيم المعادة تعاد المصفوفة نفسها المعطاة بعد إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس count ...

يحول التابع to_h الكائن القابل للتعداد المعطى إلى كائن من النوع Hash. البنية العامة to_h(*args) → hash المعاملات args الوسائط المراد استعمالها في عملية التحويل. القيمة المعادة يعاد كائن جديد من النوع Hash يحوي قائمة من الأزواج مفتاح/قيمة الناتجة عن تحويل الكائن القابل للتعداد المعطى. أمثلة مثال على استعمال التابع to_h: %i[hello world].each_with_index.to_h # => {:hello => 0, :world => 1} انظر أيضًا التابع to_a: يحول الكائن القابل للتعداد إلى مصفوفة. مصادر قسم التابع to_h في الصنف Enumerable في توثيق روبي ...

يعيد التابع downcase نسخةً من السلسلة النصية التي استدعي معها مع استبدال الحروف الكبيرة بنظائرها الصغيرة. استبدال الحروف بحروف أخرى يعتمد على المعامل المُمرَّر إلى التابع، وعلى ترميز السلسلة النصية المعطاة. البنية العامة downcase → new_str downcase([options]) → new_str المعاملات options يُستخدم للتحكم بعملية التبديل ويأخذ إحدى القيم التالية: الخيار الوصف بدون خيار يمثِّل ربط (mapping) محارف اليونيكود (Unicode) الكاملة ذات الحالة الكبيرة والصغيرة مع بعضها لتبديلها، وهذا مناسب لأغلب اللغات (اطلع على الخيار turkic: والخيار lithuanian: في الأسفل، إذ تعد ...

يجلب التابع getc المحرف التالي من المجرى ARGF. يعامل المجرى ARGF الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع getc مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا. البنية العامة getc → String or nil القيم المعادة تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى ARGF، أو تعاد القيمة ...

يتحقق التابع autoclose?‎ إن كان واصف الملف الأساسي لمجرى معين سيُغلق تلقائيًا عند الانتهاء منه. البنية العامة autoclose?→ true or false‎ القيمة المعادة تعاد القيمة true إن كان واصف الملف الأساسي للمجرى المعطى سيُغلق تلقائيًا عند الانتهاء منه، وإلا ستعاد القيمة false. انظر أيضًا التابع autoclose: يُعيّن عند استدعائه بالشكل autoclose = bool قيمة راية الإغلاق التلقائي (auto-close flag) إلى القيمة bool المنطقية. التابع close: يغلق مجرى د/خ، ويرسل (flushes) أي كتابات مُعلّقة إلى نظام التشغيل. التابع closed?‎: يتحقق إن كان مجرى د/خ ...

يُطلق الاستثناء 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في توثيق روبي الرسمي.

يتحقق التابع eql?‎ إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع ومتساويين. يعمل هذا التابع بشكل مخالف للمعامل ==‎ الذي يحول نوع العددين قبل إجراء الموزانة بينهما. البنية العامة eql?(numeric) → true or false‎ المعاملات numeric‎ عدد يراد التحقق من تساويه نوعًا وقيمةً مع العدد المعطى. القيمة المعادة تُعاد القيمة true إن كان العدد المعطى والعدد numeric من نفس النوع ومتساويين. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع eql?‎: 1 == 1.0 ...

يحول التابع ‎to_i العدد العقدي الذي استدعي معه إلى عدد صحيح إن كان ذلك ممكنًا (ينبغي أن يساوي الجزء التخيلي القيمة 0 تمامًا، وإلا فسيُطلَق الخطأ RangeError).  البنية العامة to_i → integer القيمة المعادة يعاد عدد صحيح يمثِّل ناتج تحويل العدد العقدي المعطى إن كان ذلك ممكنًا، أو سيُرمَى الخطأ RangeError إن لم يكن ذلك ممكنًا. أمثلة أمثلة عن استخدام التابع ‎to_i: Complex(1, 0).to_i #=> 1 Complex(1, 0.0).to_i # RangeError Complex(1, 2).to_i # RangeError انظر ...

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

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

تمثل كائنات الصنف Regexp التعابير النمطية التي تُستخدم لمطابقة نمط (pattern) معيّن في سلسلة نصية. تُنشَأ التعابير النمطية باستخدام الصياغتين /.../ و ‎%r{...}‎، أو باستعمال الباني new. التعابير النمطية هي أنماط تصف محتويات السلسلة النصية. يمكن استخدامها للتحقق من أنّ سلسلة نصية تحتوي على نمط معين، أو لاستخراج الأجزاء المُطابقة منها. عادةً ما يتم تحديد التعبير النمطي بخط مائل (/) كما يوضح المثال التالي: /hay/ =~ 'haystack' #=> 0 /y/.match('haystack') #=> #<MatchData "y"> ‎ إذا احتوت سلسلة نصية على النمط، فسيقال ...

يجمع التابع inject جميع عناصر الكائن القابل للتعداد الذي استدعي معه عبر تطبيق عملية ثنائية تُحدَّد بوساطة كتلة أو رمز يسمي تابعًا أو معاملًا. التابعان inject و reduce هما وجهين لعملة واحدة؛ أي كل منها اسم بديل للآخر. البنية العامة inject(initial, sym) → obj inject(sym) → obj inject(initial) { |memo, obj| block } → obj inject { |memo, obj| block } → obj إن حُدَّدَت كتلة مع هذا التابع، فسيُمرَّر لكل عنصر من عناصر الكائن القابل للتعداد المعطى قيمة تراكمية (memo) والعنصر نفسه. إن حُدَّدَ رمز ...

يُعيد التابع priority أولوية المهمة الفرعية التي استدعيت معه. تورث القيمة الافتراضية من المهمة الفرعية الحالية المسؤولة عن إنشاء المهمة الفرعية الجديدة، أو تكون القيمة صفر للمهمة الفرعية الرئيسية الابتدائية (initial main thread)؛ سيتم تشغيل المهام الفرعية ذات الأولوية العالية بشكل أكثر تكرارًا من مثيلاتها ذات الأولوية المنخفضة (ولكنها ستُشغّل على أي حال). هذا مجرد تلميح يستعمله مُجدوِل المهام الفرعية (thread scheduler) في روبي. مع ذلك، قد يتم تجاهله في بعض أنظمة التشغيل. البنية العامة priority→ integer‎ القيمة المعادة يعاد عدد ...

يعيد التابع intern بشكل عام الرمز المقابل لكائن ما. لذلك، عند استدعائه مع رمز، فسيعيد الرمز نفسه. البنية العامة intern→ sym‎ القيمة المعادة يعاد الرمز المعطى نفسه (self). انظر أيضًا التابع inspect: يعيد سلسلة نصية تمثل الرمز التي استُدعي معه. التابع size: يشبه التعبير sym.to_s.length. مصادر قسم التابع intern‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

يعيد التابع reject مصفوفة جديدة تحتوي جميع عناصر المصفوفة التي استُدعيت معها والتي لم تحقق شرطًا محددًا. يُحافَظ على ترتيب العناصر المرفوضة المعادة بنفس ترتيبها كما كانت في المصفوفة الأصلية. إن لم تُمرَّر أية كتلة إلى التابع reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject {|item| block } → new_ary reject → Enumerator القيم المعادة تعاد مصفوفة جديد تحوي جميع عناصر المصفوفة المعطاة التي لم تعاد معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع ...

يعدُّ التابع codepoints اسمًا بديلًا مهملًا للتابع each_codepoint. البنية العامة codepoints() انظر أيضًا التابع each_codepoint: ينفذ الكتلة المعطاة على رموز اليونيكود الخاصة بمحارف المجرى. مصادر قسم التابع codepoints‎ في الصنف IO‎ في توثيق روبي الرسمي.

يُعيد التابع fileno عددًا صحيحًا يمثل واصف الملف الرقمي (numeric file descriptor) للمجرى الذي استدعي معه. البنية العامة fileno → integer to_i→ integer‎ القيمة المعادة يعاد عددٌ صحيحٌ يمثل واصف الملف الرقمي للمجرى المعطى. أمثلة مثال على استخدام التابع fileno‎: $stdin.fileno #=> 0 $stdout.fileno #=> 1‎ انظر أيضًا التابع fdatasync: يكتب مباشرةً جميع البيانات المخزنة في مجرى د/خ على القرص. مصادر قسم التابع fileno‎ في الصنف IO‎ في توثيق روبي الرسمي.

يعيد التابع max_by العنصر الذي تعيد الكتلة المعطاة أكبر قيمة مقابلة له بعد تمرير عناصر الكائن القابل للتعداد إليها كلٌّ على حدة. إن لم تعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة max_by {|obj| block } → obj max_by → an_enumerator max_by(n) {|obj| block } → obj max_by(n) → an_enumerator المعاملات n إن أعطي هذا المعامل، فسيُعاد أكبر n عنصر في مصفوفة. تُرتَّب العناصر آنذاك في المصفوفة بشكل تنازلي بناءً على القيمة المقابلة التي تعيدها الكتلة. القيمة المعادة يعاد العنصر الذي تعيد ...

يعيد التابع captures مصفوفة الأجزاء المُطابقة (array of captures)؛ يكافئ mtch.to_a[1..-1]‎. البنية العامة captures→ array‎ القيمة المعادة تعاد مصفوفة الأجزاء المُطابقة. أمثلة مثال على استخدام التابع captures‎: f1,f2,f3,f4 = /(.)(.)(\d+)(\d)/.match("THX1138.").captures f1 #=> "H" f2 #=> "X" f3 #=> "113" f4 #=> "8"‎ انظر أيضا التابع begin: يعيد موضع (offset) بداية العنصر n من مصفوفة التطابق في السلسلة النصية. التابع end: يعيد موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية. مصادر ...