نتائج البحث

يحذف التابع shift متغير بيئة (اسم المتغير وقيمته) من البيئة ENV ثمَّ يعيده في مصفوفة. في حال كانت البيئة فارغة، فسيعيد التابع القيمة nil. البنية العامة shift → Array or nil القيمة المعادة تُعاد قيمة متغير البيئة المحذوف. أو تعاد القيمة nil في حال كانت البيئة فارغة. انظر أيضًا التابع clear: يحذف جميع متغيرات البيئة. التابع delete: يحذف متغير بيئة ذي اسم محدَّد، ثم يعيد قيمته. التابع delete_if: يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا. مصادر قسم التابع shift في الصنف ENV في ...

يجلب التابع groups مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. البنية العامة groups → array القيم المعادة تعاد مصفوفة تحوي مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. أمثلة مثال على استعمال التابع groups: Process.groups #=> [27, 6, 10, 11] انظر أيضًا التابع getpgid: يعيد مُعرِّف المجموعة المالكة لعملية محدَّدة. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع groups=‎: يضبط عند استدعائه بالشكل groups= ...

يتحقق التابع has_key?‎ إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include?‎ والتابع member?‎ لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة has_key?(key) → true or false المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_key?‎: h = { "a" => 100, "b" => 200 } h.has_key?("a") #=> true h.has_key?("z") ...

يعيد التابع zone اسم المنطقة الزمنية المستخدمة في التوقيت الذي استدعي معه. منذ روبي 1.8، تُعاد السلسلة النصية "UTC" بدلاً من "GMT" لتمثيل التوقيت العالمي الموحد UTC. البنية العامة zone → string‎ القيمة المعادة يعاد اسم المنطقة الزمنية المستخدمة في التوقيت المعطى. أمثلة مثال على استخدام التابع zone‎: t = Time.gm(2000, "jan", 1, 20, 15, 1) t.zone #=> "UTC" t = Time.local(2000, "jan", 1, 20, 15, 1) t.zone #=> "CST"‎ انظر أيضًا التابع to_f: يحول قيمة التوقيت المعطى إلى عدد عشري يمثل ...

يُعيد التّابع cause الاستثناء السابق (!$) عندما يُرمَى هذا الاستثناء. هذا مفيد في الاستثناءات المغلقة والاحتفاظ بمعلومات الاستثناء الأصلية. البنية العامة cause → an_exception or nil القيم المعادة يعاد الاستثناء الذي سبق الاستثناء المرمي، أو تعاد القيمة nil خلا ذلك. انظر أيضا التابع message: يُعيد ناتج استدعاء التّابع Exception.to_s. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه. التابع new: يُنشئ كائنًا جديدًا من النّوع Exception، ويمرِّر رسالةً اختياريًّا إليه. التابع inspect: يُعيد اسم صنف الاستثناء ورسالته. التابع backtrace: يُعيد أيَّ تتبّعٍ ...

يُنتج التابع clone نسخةً سطحيةً (shallow copy) من الكائن المعطى. تُنسَخ متغيرات النسخة (instance variables) ولكن لا تُنسَخ الكائنات التي تشير إليها. يَنسَخ التابع clone حالة الكائن المجمدة (إلا إذا كان وسيط الكلمة المفتاحية freez: مساويًا للقيمة falsefalse) والتالفة (tainted). انظر أيضًا النقاش في صفحة التابع Object.dup. قد يمتلك هذا التابع سلوكًا  محدّدًا بالصنف (class-specific). إذا كان كذلك، سيُوثَّق السلوك تحت التابع ‎.initialize_copy من نفس الصنف. البنية العامة clone(freeze: true) → an_object المعاملات freeze وسيطُ مسمى (keyword argument) يأخذ القيمة ...

يعيد التابع hash القيمة hash استنادًا إلى محتويات هذه البنية. البنية العامة hash→ integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash استنادًا إلى محتويات البنية المعطاة. انظر أيضًا التابع inspect: يعيد سلسلة نصية تحتوي وصفًا لهذه البنية. التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash‎ في الصنف Struct‎ في توثيق روبي الرسمي.

يرسل التابع kill إشارة محدَّدة إلى عملية ذات مُعرِّف معطى أو إلى جميع العمليات التي معرِّف المجموعة التي تملكه مساويًا إلى معرِّف المجموعة للعملية المستدعية. البنية العامة kill(signal, pid, ...) → integer المعاملات signal عدد صحيح يمثِّل رقم الإشارة أو سلسلة نصية تمثِّل اسم الإشارة بحسب POSIX (مع أو بدون السابقة SIG). إن كان عددًا صحيحًا موجبًا، إن كان عددًا سالبًا (يبدأ بإشارة الناقص)، فستُقتَل مجموعات العملية (process groups) بدلًا من العمليات. ليست جميع الإشارات مدعومة على كل المنصات. مفاتيح وقيم ...

يعيد التابع floor أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة. ينفِّذ الصنف Numeric هذه العملية عن طريق تحويل قيمة العدد المعطى إلى النوع Float ثم استدعاء التابع Float.floor. البنية العامة floor([ndigits]) → integer or float‎ المعاملات ndigits‎ عدد يمثل دقة المنازل العشري. القيمة الافتراضية هي: 0. القيمة المعادة يعاد عدد صحيح أو عشري يمثِّل أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة ndigits للمنازل العشرية فيه. انظر أيضا ...

يفتح التابع binread الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات. يتأكد التابع binread من إغلاق الملف قبل إنهاية العملية. يفتح التابع الملف في الوضع "rb:ASCII-8BIT". البنية العامة binread(name, [length [, offset]] )→ string‎ المعاملات name‎ اسم الملف المراد فتحه وجلب البيانات منه. length‎ عدد صحيح يمثل عدد البايتات المراد جلبها من الملف. القيمة الافتراضية هي قراءة وجلب البيانات بدءًا من ...

يعيد التابع undump نسخة عن السلسلة النصية التي استدعي معها مع حذف جميع المحارف المُهربة منها. البنية العامة undump → new_str القيمة المعادة تُعاد نسخة عن السلسلة النصية المعطاة مع حذف جميع المحارف المُهربة منها. أمثلة مثال على استعمال التابع undump: "\"hello \\n ''\"".undump #=> "hello \n ''" انظر أيضًا التابع dump: يُعيد نسخة عن السلسلة النصية مع استبدال المحارف الغير مطبوعة بالرمز nnn\ وتهريب المحارف الخاصة. التابع strip: يعيد نسخة عن السلسلة النصية مع حذف المسافات البيضاء من بداية ...

يُعدُّ التّابع inspect اسمًا بديلًا (alias) للتّابع to_s. البنية العامة inspect() انظر أيضا التابع to_s: يُعيد معلوماتٍ عن الليف (fiber) بشكل سلسلةٍ نصيةٍ. مصادر صفحة التابع inspect في الصنف Fiber في توثيق روبي الرسمي.

يعيد التابع phase القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو يعيد القيمة pi خلاف ذلك. البنية العامة phase → 0 or float‎ القيمة المعادة تعاد القيمة 0 إن كان العدد العشري المعطى موجبًا، أو تعاد القيمة pi خلاف ذلك. انظر أيضا التابع angle: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. التابع polar: يعيد المصفوفة [num.abs، num.arg] إذ num هو العدد المعطى. مصادر قسم التابع phase‎ في الصنف Float في توثيق روبي الرسمي. ...

يُلحق التابع prepend السلسلة النصية المُمرَّرة إليه ببداية السلسلة النصية التي استدعيت معه. البنية العامة prepend(other_str1, other_str2,...) → str المعاملات other_str1 السلسلة النصية الأولى المُراد إلحاقها ببداية السلسلة النصية المُعطاة. other_str2 السلسلة النصية الثانية المُراد إلحاقها ببداية السلسلة النصية المُعطاة. ... السلاسل النصية الأخرى المراد إلحاقها ببداية السلسلة النصية المعطاة. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد إلحاق السلاسل النصية other_str1 و other_str2 و ... ببدايتها. أمثلة مثال على استعمال التابع prepend: a = "!" a.prepend("hello ", "world") #=> "hello world!" a ...

يزيل التابع clear كل الكائنات من الطابور. البنية العامة clear() انظر أيضًا التابع new: ينشئ طابورًا ذا طول ثابت. التابع close: يغلق الطابور. مصادر قسم التابع clear‎ في الصنف SizedQueue‎ في توثيق روبي الرسمي.

يحول التابع to_f الأرقام الموجودة في بداية السلسلة النصية المعطاة إلى عدد عشري. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0.0 دون إطلاق أية استثناءات. البنية العامة to_f → float القيمة المعادة يُعاد العدد العشري المقابل للعدد الموجود في بادئة السلسلة النصية المعطاة، أو تُعاد القيمة 0.0 إذا لم تحتوي بادئة السلسلة على أي عدد. أمثلة مثال على استعمال التابع to_f: "123.45e1".to_f ...

يعيد التابع each_byte قيمة قابلة للعد (enumerator) تتكرر (iterates) على كل قيمة من النوع Byte في الملفات الموجودة في ARGV. يسمح لك هذا التابع بمعالجة الملفات المُمرَّرة من سطر الأوامر كما لو كانت ملفًا واحدًا مكونًا من سلسلة من هذه الملفات المسماة. بعد إعادة البتة (byte) الأخيرة من الملف الأول، ستُعاد البتة الأولى من الملف الثاني. يمكن استخدام التابع ARGF.filename لمعرفة اسم الملف للبتة الحالية. في حال عدم تمرير كتلة برمجية، فسيُعاد كائن من النوع enumerator. البنية العامة each_byte {|byte| block } → ARGF each_byte → ...

ينشئ التابع mkfifo ملفًا خاصًّا من النوع "أنبوبة مسماة" (FIFO ويدعى أحيانًا named pipe) باسم وأذونات محدَّدة. البنية العامة mkfifo(file_name, mode=0666) => 0 المعاملات file_name اسم الأنبوبة المسماة (FIFO) المراد إنشاؤها. mode نمط أذونات الأنبوبة المسماة المراد إنشاؤها. تُعدَّل هذه القيمة عبر القناع umask للعملية الحالية بالطريقة المعتادة وهي: أذونات الملف المُنشَأ تكون حاصل العملية mode & ~umask. القيمة المعادة تعاد القيمة 0 بعد اكتمال تنفيذ العملية. انظر أيضا التابع link: ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). ...

يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. تتضمن هذه القائمة أسماء جميع الوحدات والأصناف المحددة في النطاق العام (global scope). البنية العامة constants→ array القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. أمثلة مثال على استخدام التابع constants‎: Module.constants.first(4) # => [:ARGF, :ARGV, :ArgumentError, :Array] Module.constants.include?(:SEEK_SET) # => false class IO Module.constants.include?(:SEEK_SET) # => true end‎ انظر أيضا التابع const_set: يضبط قيمة الثابت المعطى عند الكائن المحدد، ...

يبدأ التابع exit عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. هذا الاستثناء قد يُلتقَط. البنية العامة exit(status=true) Kernel::exit(status=true) Process::exit(status=true) المعاملات status معامل اختياري يُستعمَل لإعادة حالة الشيفرة للبيئة المستدعية. القيمة true والقيمة false للحالة المعادة تشيران إلى النجاح والفشل على التوالي. تفسير القيم العددية الأخرى المعطاة يعتمد على نظام التشغيل آنذاك. القيمة الافتراضية هي: true. أمثلة مثال على استعمال التابع exit: begin exit puts "never get here" rescue SystemExit puts "rescued a SystemExit exception" end puts "after begin block" ينتج عن تنفيذ ...

يُعيد التابع inspect سلسلة نصية تصف المجرى الذي استُدعي معه. البنية العامة inspect→ string‎ القيمة المعادة تعاد سلسلة نصية تصف المجرى المعطى. انظر أيضًا التابع fcntl: يوفر آلية لإصدار أوامر منخفضة المستوى للتحكم في أو الاستعلام عن مجاري د/خالموجهة بالملفات (file-oriented I/O). التابع gets: يجلب السطر التالي من المجرى الذي استدعي معه.  مصادر قسم التابع inspect‎ في الصنف IO‎ في توثيق روبي الرسمي.

يكتب التابع print الكائن (أو الكائنات) المُمرَّرة إليه في المجرى الذي استدعي معه ثم يُعيد القيمة nil. يجب أن يكون المجرى مفتوحًا في وضعية الكتابة. سيتم تحويل الكائنات غير النصية إلى سلسلة نصية عبر استدعاء التابع to_s الخاص بها. في حال استدعاء التابع print بدون تمرير أي شيء إليه، فسيطبع محتويات المتغير ‎$_‎. إن كان فاصل حقل الإخراج (‎$,‎) مخالفا للقيمة nil، فسيُدرَج بين الكائنات. وإن كان فاصل سجل الإخراج (‎$\‎) مخالفًا للقيمة nil، فسيتم إلحاقه بنهاية المخرجات. البنية العامة print→ nil print(obj, ...

يجلب التابع getbyte البايت التالي من المجرى الذي استدعي معه. البنية العامة getbyte→ integer or nil‎ القيمة المعادة يعاد عدد صحيح بين 0 و 255 يمثِّل البايت التالي من المجرى المعطى، أو تعاد القيمة nil عن الوصول إلى نهاية المجرى. أمثلة مثال على استخدام التابع getbyte‎: f = File.new("testfile") f.getbyte #=> 84 f.getbyte #=> 104‎ انظر أيضًا التابع getc: يجلب محرفًا واحدًا من المجرى الذي استدعي معه. التابع gets: يجلب السطر التالي من المجرى الذي استدعي معه.  مصادر قسم التابع getbyte‎ ...

يأخذ التابع new سلسلة نصية تحوي شيفرات برمجية بلغة روبي، ويُصرّفها (compile) إلى كائن من النوع InstructionSequence. البنية العامة new(source[, file[, path[, line[, options]]]]) → iseq‎ اختياريًّا، يأخذ التابع new المعاملات file و path و line التي تمثل اسم الملف، والمسار المطلق، ورقم السطر الأول لشيفرة روبي الموجودة في المصدر source؛ هذه المعاملات تمثل بيانات وصفية (metadata) مُرتبطة بالكائن iseq المعاد. يُستخدَم المعامل options، الذي يمكن أن تكون قيمته true أو false أو جدول Hash، لتعديل السلوك الافتراضي لمصرف iseq روبي. لمزيد من ...

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

يتحقق التابع setgid?‎ إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. البنية العامة setgid?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع owned?‎: يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. التابع setuid?‎: يتحقق إن كان البت uid (بت معرِّف المستخدم المالك) ...

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

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

يُنفِّذ الصنف Queue طوابير الانتظار متعدِّدة المنتجين (multi-producer)، ومتعدِّدة المستهلكين (multi-consumer). إنَّه مفيدٌ بشكلٍ خاصٍّ في البرمجة المعتمدة على الخيوط (threaded programming) عندما يتحتَّم على المعلومات أن تُتبادل بأمان بين خيوطٍ (threads) متعدَّدة. يُنفِّذ الصنف Queue كل دلالات القفل المطلوبة. يُنفِّذ الصنف طوابير الانتظار التي من النوع FIFO (من يدخل أولًا يخرج أولًا). في هذا النوع، المهام التي تضاف أولًا في الطابور هي المهام التي تعاد أولًا منه. queue = Queue.new producer = Thread.new do 5.times do |i| ...

يعدل التابع reverse!‎ على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. البنية العامة reverse! → str القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها بعد عكس ترتيب المحارف فيها. أمثلة أمثلة على استعمال التابع !reverse: a="hello" a.reverse #=> "olleh" a #=> "olleh" انظر أيضًا التابع chop!‎: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع downcase!‎: يعدل على السلسلة النصية المعطاة وذلك باستبدال الحروف الكبيرة فيها بنظائرها الصغيرة. التابع reverse: يعكس ترتيب محارف السلسلة ...

ينهي التابع !exit العملية ويخرج منها مباشرةً. لن تُنفَّذ أية معالجات خروج حينذاك. البنية العامة euid → integer Process::UID.eid → integer Process::Sys.geteuid → integer المعاملات status حالة الخروج المراد إعادتها إلى النظام الأساسي. القيمة الافتراضية هي: false. أمثلة مثال على استعمال التابع !exit: Process.exit!(true) انظر أيضًا التابع abort: ينهي تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء Kernel.exit(false)‎. التابع exit: يبدأ عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. مصادر قسم التابع !exit في الصنف Process في توثيق روبي الرسمي.

يحرر التابع sleep القفل (lock)، وينام لعدد محدَّد من الثواني. يطلق الخطأ ThreadError إذا لم يكن الكائن mutex مُقفلًا من قِبَل الخيط (thread) الحالي. عندما يستأنف الخيط عمله، ستحاول تلك المهمة استعادة القفل وتطبيقه. لاحظ أن هذا التابع يمكنه إيقاظ (wakeup) الخيط دون استدعاء Thread.wakeup بشكل صريح كما يحدث، على سبيل المثال، عند تلقي إشارة. البنية العامة sleep(timeout = nil) → number‎ المعاملات timeout‎ عدد الثواني التي تحدِّد مدة نوم الخيط بعد تحرير القفل. القيمة الافتراضية هي: nil. القيمة المعادة يعاد ...

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

يعيد التابع ‎infinite?‎ قيمةً تشير إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي منتهية أو غير منتهية (infinite). البنية العامة infinite? → nil or 1 القيمة المعادة تعاد القيمة nil إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي المعطى منتهية (finite)، أو تعاد القيمة 1+ إن كانت قيمة الطويلة غير منتهية (من الطرف الموجب لمستقيم الأعداد). أمثلة أمثلة عن استخدام معامل التابع ‎infinite?‎: (1+1i).infinite? ...

يعيد التابع ord العدد الترتيبي (Integer ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) المقابل لأول محرف فى السلسلة النصية المعطاة. البنية العامة ord → integer القيمة المعادة يُعاد العدد الترتيبي المقابل لأول محرف من محارف السلسلة النصية المعطاة. أمثلة مثال على استعمال التابع ord: "a".ord #=> 97 “hello”.ord #=> 104 انظر أيضًا التابع each_codepoint: يُمرر كل عدد من الأعداد الترتيبية (Integers ordinal) ...

يعيد التابع new_seed قيمةً عشوائية تمثِّل البذرة. يستخدم هذا التابع من قبل التابع new عندما لا تُعيَّن قيمة البذرة كمعاملٍ لذلك التابع. البنية العامة new_seed → integer القيم المعادة تُعاد قيمةٌ عشوائيَّةٌ للبذرة. أمثلة مثالٌ عن استخدام التابع new_seed: Random.new_seed  #=> 115032730400174366788466674494640623225 انظر أيضًا التابع new: يُنشئ مولِّد أعدادٍ شبه عشوائيةٍ (PRNG) باستخدام قيمة محدَّدة للبذرة لضبط الحالة الأولية. التابع seed: يعيد قيمة البذرة التي استُخدمَت في إنشاء المولِّد. التابع srand: يحدِّد بذرة مولد الأعداد شبه العشوائية للنظام بتعيين Random::DEFAULT ...

يكتب التابع syswrite السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write).  لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في المجرى، وإلا ستحصل على نتائج غير متوقعة. يُطلق الاستثناء SystemCallError عند حدوث خطأ. البنية العامة syswrite(string)→ integer‎ المعاملات string‎ سلسلة نصية يراد كتابتها على المجرى. القيمة المعادة يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى. أمثلة مثال على استخدام التابع syswrite‎: f = File.new("out", "w") f.syswrite("ABCDEF") #=> 6‎ انظر أيضًا التابع sysread: ...

يتحقَّق التابع ?closed إذا كان طابور الانتظار (queue) مغلقًا. البنية العامة closed? القيم المعادة تُعاد القيمة true إذا كان طابور الانتظار مغلقًا. خلاف ذلك، تعاد القيمة false. انظر أيضًا التابع ?empty : يتحقَّق إذا كان طابور الانتظار فارغًا. التابع close : يغلق الطابور الذي استُدعي معه. التابع clear : يحذف كل الكائنات من الطابور الذي استُدعي معه. مصادر صفحة التابع ?closed في الصنف queue في توثيق روبي الرسمي.

اسم بديل للتابع new. البنية العامة compile(*args) القيمة المعادة يعاد كائنٌ جديدٌ من النوع Regexp. انظر أيضا التابع new: ينشئ تعبيرًا نمطيًّا جديدًا. مصادر قسم التابع compile‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

يوقف التابع stop تنفيذ المهمة الفرعية الحالية، ويضعها في حالة "نوم" (sleep)، ويُجدوٍل (schedules) تنفيذ مهمة فرعية أخرى. البنية العامة stop→ nil‎ القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع stop‎: a = Thread.new { print "a"; Thread.stop; print "c" } sleep 0.1 while a.status!='sleep' print "b" a.run a.join #=> "abc"‎ انظر أيضًا التابع start: يشبه التابع new بشكل أساسي إلا أنه عند اشتقاق صنف فرعي (subclassed) من Thread، فإنَّ استدعاء start في ذلك الصنف الفرعي لن يستدعي تابع الصنف الفرعي initialize. مصادر قسم التابع ...

يعيد التابع abs القيمة المطلقة للعدد الذي استُدعي معه. البنية العامة abs → integer‎ القيمة المعادة تعاد القيمة المطلقة للعدد الذي استُدعي معه. أمثلة مثال على استخدام التابع abs‎: (-12345).abs #=> 12345 -12345.abs #=> 12345 12345.abs #=> 12345 انظر أيضا المعامل -: يعيد ناتج عملية الطرح بين عددين. المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: يعيد ناتج عملية الجمع بين عددين، صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية. التابع sqrt: ...

يقتطع التابع slice!‎ عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice!‎ العناصر المحذوفة، أو nil إن كان index خارج النطاق. البنية العامة slice!(index) → obj or nil slice!(start, length) → new_ary or nil slice!(range) → new_ary or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر ...

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

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

ينشئ التابع to_h جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. البنية العامة to_hash → hash to_h → hash القيمة المعادة يعاد كائن من النوع Hash يحوي نسخةً من متغيرات البيئة. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_h في الصنف ENV في توثيق روبي الرسمي.

يقطِّع التابع slice_after عناصر الكائن القابل للتعداد إلى أجزاء تحدَّد نهايتها عبر نمطٍ محدِّدٍ أو كتلةٍ معطاةٍ ثم يعيد مُعدِّد لكل جزء من الأجزاء الناتجة. البنية العامة slice_after(pattern) → an_enumerator slice_after { |elt| bool } → an_enumerator إن كان النمط مطابقًا للعنصر (أي يعيد pattern === elt القيمة true) أو أعادت الكتلة القيمة true للعنصر المُمرَّر إليها، فسيُعدُّ العنصر نهايةً لجزء. يُستدعَى المعامل === والكتلة block من أول عنصر وحتى آخر عنصر من عناصر الكائن القابل للتعداد المعطى. يُنتِج المُعدِّد المعاد العناصر ...

يشبه التابع lchmod التابع chmod باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير أذونات الوصلة نفسها وليس الملف الذي تشير إليه). هذا التابع غير متاح في أغلب الأحيان. البنية العامة lchmod(mode_int, file_name, ...) → integer المعاملات mode_int نمط الأذونات الجديدة المراد تعيينها إلى الملفات المحدَّدة. file_name اسم الملف المراد تغيير أذوناته. ... أسماء الملفات الأخرى المراد تغيير أذوناتها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي غُيِّرت أذوناتها. انظر أيضا التابع chmod: يغيِّر بتات الأذونات لملف أو عدة ملفات ...

يعيد التابع ‎polar عددًا عقديًا وفق الشكل القطبي (polar form). الشكل القطبي للعدد العقدي هو: z= r(cosθ + i.sinθ)‎. البنية العامة polar(abs[, arg]) → complex المعاملات abs يمثّل طويلة (r) العدد العقدي. arg يمثِّل زاوية (θ) العدد العقدي. القيمة المعادة يعيد التابع ‎polar عددًا عقديًا وفق الشكل القطبي إذ يكون abs طويلة العدد العقدي و arg زاويته. أمثلة أمثلة عن استخدام التابع polar لإنشاء عدد عقدي انطلاقًا من الشكل القطبي: Complex.polar(3, 0) ...

يعيد التابع raised_exception قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. البنية العامة ‎raised_exception() القيمة المعادة تعاد قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. انظر أيضًا التابع path: يعيد مسار الملف الجاري تنفيذه. مصادر قسم التابع raised_exception‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

يعيد التابع default القيمة الافتراضية للمفتاح المُمرَّر إليه؛ أي يعيد القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. البنية العامة default(key=nil) → obj المعاملات key المفتاح الذي يراد معرفة قيمته الافتراضية. القيمة المعادة تعاد القيمة الافتراضية للمفتاح key وهي القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. أمثلة مثال على استعمال التابع default: h = Hash.new ...

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

ينفذ التابع foreach الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى. إن كان آخر معامل مُمرَّر إلى التابع هو جدول Hash، فسيتم فتح الوسيط المسمى (keyword argument). في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة foreach(name, sep=$/ [, getline_args, open_args]) {|line| block } → nil foreach(name, limit [, getline_args, open_args]) {|line| block }→ nil foreach(name, sep, limit [, getline_args, open_args]) {|line| block } → nil foreach(...) → an_enumerator‎ المعاملات name‎ اسم الملف ...

يعيد التابع reopen ربط المجرى الذي استُدعي معه مع مجرى آخر جديد أو موجود مسبقًا. قد يؤدي هذا إلى تغيير الصنف الفعلي لهذا المجرى ديناميكيًا. البنية العامة reopen(other_IO)→ ios reopen(path, mode_str)→ ios‎ المعاملات other_IO‎ كائن من النوع IO يمثِّل مجرى موجود مسبقًا يراد ربطه بالمجرى المعطى. path‎ مسار يشير إلى مجرى جديد لفتحه من أجل ربطه بالمجرى المعطى. mode_str‎ سلسلة نصية تمثل وضعية الفتح. اطلع على صفحة التابع new للمزيد حول أوضاع الفتح. القيمة المعادة يعاد المجرى المعطى بعد إعادة ربطه بالمجرى ...

الألياف (Fibers) هي حقولٌ أساسيّةٌ (primitives) تُستخدم في تنفيذ تعدّد المهام التشاركي (cooperative concurrency) للمهام الخفيفة (light weight) أي التي تستهلك جزءًا صغيرًا من الذاكرة. تعني أساسيًّا إنشاء كتل شيفرات يمكن إيقافها مؤقتًا واستئنافها، كما هو الحال مع الخيوط (threads). الفرق الأساسي في الألياف أنه لا يمكن إيقافها مؤقّتًا من قبل مهام أخرى تنفذ من قبل النظام (Preemption) وأن الجدولة (scheduling) يجب أن تتمَّ من قبل المبرمج وليس من قبل الآلة الافتراضية (virtual machine). على عكس نماذج تعدد المهام التشاركية ...

يُعيد التابع tv_sec القيمة المقابلة للتوقيت التي تمثل عدد الثواني التي مرت منذ توقيت يونيكس. البنية العامة tv_sec → int‎ القيمة المعادة يعاد عدد الثواني التي مرت منذ توقيت يونيكس. أمثلة مثال على استخدام التابع tv_sec‎: t = Time.now "%10.5f" % t.to_f #=> "1270968656.89607" t.to_i #=> 1270968656‎ انظر أيضًا التابع tv_nsec: يُعيد عدد النانوثواني المقابلة للتوقيت المعطى التي مرت منذ توقيت يونيكس. التابع tv_usec: يُعيد المقابلة للتوقيت التي تمثل عدد ...

ينشئ التابع chunk_while مُعدِّدًا لكل جزء من العناصر المجمَّعة سويةً. تُعرَّف بداية الأجزاء (chunks) عبر الكتلة المعطاة. البنية العامة chunk_while {|elt_before, elt_after| bool } → an_enumerator يفصل هذا التابع كل جزء باستعمال العناصر المتجاورة، التي هي elt_before و elt_after، في المُعدِّد المستقبل. يفصل هذا التابع الأجزاء بين elt_before و elt_after حيث تعيد الكتلة القيمة false. تُستدعَى الكتلة مع طول المُعدِّد المستقبل مطروحًا منه الواحد. ينتج عن المُعدِّد الناتج العناصر المجمَّعة كمصفوفة. لذلك، يمكن استدعاء التابع each بالشكل التالي: enum.chunk_while { |elt_before, elt_after| bool ...

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

ينشئ التابع new جدول Hash جديد فارغ ثم يعيده. إذا أجريت بعد ذلك محاولة للوصول إلى مفتاح غير موجود وغير مرتبط بقيمة، فستعاد قيمة تعتمد على كيفية استدعاء التابع new لإنشاء الجدول Hash هذا. البنية العامة new → new_hash new(obj) → new_hash new {|hash, key| block } → new_hash في الشكل الأول من التابع new، تعيد أية محاولة للوصول إلى مفتاحٍ القيمة nil. إذا أعطي المعامل obj في الشكل الثاني، فستُستخدم قيمته وحدها كقيمة افتراضية لكافة القيم. أمَّا إذا حُدِدت كتلة كما فيا الشكل ...

يعيد التابع upto القيم المتعاقبة، ابتداءًا من السلسلة النصية str المُعطاة، وانتهاءًا بالسلسلة المُمرَّرة إليه، ثم تُمرَّر كل قيمة بدورها إلى الكتلة المعطاة. تُستخدَم طريقة التابع succ من أجل توليد القيم المتعاقبة. تُعاد القيمة الأخيرة مع مجموعة القيم المتعاقبة إذا كان المعامل الاختياري الأخير محذوفًا، أو كانت قيمته تساوي false، وتُحذف إذا كانت قيمة المعامل تساوي true. إذا كانت السلسلة النصية المعطاة والسلسلة النصية المُمرَّرة إلى التابع عبارة فقط عن حروف عددية مُرمزة بترميز ascii؛ فإن التابع بعتبرها أعدادًا عشريةً، ...

الشكل الأول للتابع attr (انظر فقرة البنية العامة) مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ attr_accessor(name)‎، ولكنه أصبح مهملًا الآن. الشكل الأخير يكافئ attr_reader(name)‎، لكنه أصبح مهملًا أيضًا. البنية العامة attr(name, ...) → nil attr(name, true) → nil attr(name, false) → nil‎ المعاملات name‎ اسم الميزة. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه الوحدة. التابع attr_writer: ينشئ تابع وصول (accessor method) للسماح بتعيين قيمة للخاصية symbol.id2name. مصادر قسم التابع attr‎ في الصنف Module‎ في توثيق روبي ...

يتحقق التابع real?‎ إن كان العدد الذي استُدعي معه عددًا حقيقيًّا (أي ليس من النوع Complex). البنية العامة real? → true or false‎ القيمة المعادة تعاد القيمة true إن كان العدد المعطى عددًا حقيقيًّا. انظر أيضا التابع real: يعيد الكائن نفسه (self). مصادر قسم التابع real?‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يعيد التابع grapheme_clusters مصفوفة من الوحدات الكتابية (grapheme clusters) الموجودة في السلسلة النصية التي استدعيت معه. هذا التابع هو اختزال للاستدعاء str.each_grapheme_cluster.to_a. إن أعطيت كتلة - وهو الشكل المهمل من التابع-، فسيعمل التابع مثل التابع each_grapheme_cluster تمامًا. البنية العامة grapheme_clusters → an_array القيمة المعادة تعاد مصفوفة من الوحدات الكتابية في السلسلة النصية المعطاة. انظر أيضًا التابع each_grapheme_cluster: يمرِّر كل وحدة كتابية (grapheme) إلى الكتلة المعطاة ثم يعيد سلسلة نصية بالناتج الذي تعيده. مصادر قسم التابع ‎grapheme_clusters في الصنف String في توثيق ...

يكتب التابع fdatasync مباشرةً جميع البيانات المخزنة في مجرى د/خ على القرص. إذا لم يكن نظام التشغيل يدعم الدالة fdatasync(2)‎، فسيُستدعَى التابع fsync بدلًا منه (مما قد يطلق الاستثناء NotImplementedError). البنية العامة fdatasync→ 0 or nil‎ القيمة المعادة تعاد القيمة صفر عند انتهاء عملية الكتابة أو القيمة nil إن لم يكن هنالك أية بيانات لكتابتها. انظر أيضًا التابع fsync: يكتب مباشرةً جميع البيانات المخزنة في المجرى الذي استدعي معه على القرص. التابع flush: ينقل أي بيانات مخزَّنة في المجرى الذي استدعي معه إلى ...

يعيد التابع ldexp ناتج التعبير fraction * (2 ** exponent)‎. البنية العامة ldexp(fraction, exponent) → float‎ المعاملات fraction‎ عدد يمثل الجزء العشري من التعبير الأسّي. exponent‎ عدد يمثل الأس. القيمة المعادة يعاد عدد عشري يمثِّل ناتج التعبير fraction * (2 ** exponent)‎. أمثلة مثال على استخدام التابع ldexp‎: fraction, exponent = Math.frexp(1234) Math.ldexp(fraction, exponent) #=> 1234.0‎ انظر أيضا التابع hypot: يحسب القيمة sqrt (x ** 2 + y ** 2)‎، التي تمثل قيمة وتر المثلث قائم الزاوية (hypotenuse of a right-angled triangle) ...

يتحقق التابع nobits?‎ إن كانت قيم كل البتات الناتجة عن العملية & بين العددين المعطيين تخالف الواحد. البنية العامة nobits?(mask) → true or false‎ المعاملات mask‎ عدد صحيح. القيمة المعادة تعاد القيمة true إن كانت قيم كل البتات الناتجة عن العملية int & mask تخالف الواحد. انظر أيضا التابع anybits?‎: يتحقق إن كانت قيمة أي بت من البتات الناتجة عن العملية & بين العددين المعطيين تساوي واحد.  التابع allbits?‎: يتحقق إن كانت قيم كل بتات ناتج تطبيق العملية & على العدد الصحيح المعطى مع ...

يُبدِّل التابع replace محتويات الكائن المُمرَّر إليه مكان محتويات الكائن Hash الذي استدعي معه. البنية العامة replace(other_hash) → hsh المعاملات other_hash كائن من النوع Hash يراد تبديل محتوياته مكان محتويات الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash المعطى بعد تبديل محتوياته مكان محتويات الكائن other_hash. أمثلة مثال على استعمال التابع replace: h = { "a" => 100, "b" => 200 } h.replace({ "c" => 300, "d" => 400 }) #=> {"c"=>300, "d"=>400} انظر أيضًا التابع merge: يدمج كائنين من ...

يُعيد التابع wday عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي استدعي معه. البنية العامة wday → integer‎ القيمة المعادة يعاد عددٌ صحيحٌ بين 0 و 6 يمثل رقم اليوم في الأسبوع للتوقيت المعطى، إذ 0 يمثِّل يوم الأحد. أمثلة مثال على استخدام التابع wday‎: t = Time.now #=> 2007-11-20 02:35:35 -0600 t.wday #=> 2 t.sunday? #=> false t.monday? #=> false t.tuesday? ...

يتحقق التابع eql?‎ من تساوي كائنين من النوع matchdata، إذ يعيد القيمة true إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة. البنية العامة eql?(mtch2)→ true or false‎ المعاملات mtch2‎ الطرف الثاني في عملية الموازنة. القيمة المعادة تعاد القيمة true إذا كان الكائنان المتطابقان الموازنة بينهما متساويين، وإلا فستُعاد القيمة false. انظر أيضا المعامل==: يتحقق من تطابق كائنان من النوع matchdata إذا كانت السلاسل النصية المستهدفة منهما، والأنماط ومواضع المُطابقة متماثلة. مصادر قسم التابع eql?‎ في الصنف MatchData‎ في توثيق روبي ...

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

يعيد التابع pid مُعرَّف العملية الحالية. هذا التابع غير متاح على جميع المنصات. البنية العامة pid → integer القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف العملية الحالية. أمثلة مثال على استعمال التابع pid: Process.pid #=> 27415 انظر أيضًا التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع ppid: يعيد معرِّف العملية الأب للعملية الحالية. التابع setpgid: يضبط مُعرِّف المجموعة المالكة لعملية محدَّدة أو العملية الحالية. مصادر قسم التابع pid في الصنف Process في توثيق روبي الرسمي.

يعيد التابع ‎denominator قاسم (denominator) العدد العقدي، أي القاسم المشترك الأصغر (LCM، اختصارٌ للعبارة lowest common multiple) للجزأين الحقيقي والتخيلي. البنية العامة denominator → integer القيمة المعادة يعاد قاسم العدد العقدي، أي المضاعف المشترك الأصغر للجزأين الحقيقي والتخيلي. أمثلة أمثلة عن استخدام معامل التابع ‎denominator: # 1 2 3+4i <- numerator # - + -i -> ---- # 2 ...

يتحقق التابع eql?‎ من أن مصفوفتين تتضمنان نفس العناصر، وذلك بحسب التابع Object.eql?‎. البنية العامة eql?(other) → true or false القيم المعادة يعيد القيمة true إن كانت المصفوفتان تتضمنان نفس العناصر ، وإلا فستعيد القيمة false. انظر أيضًا المعامل <=>: يعيد عددًا صحيحًا (‎-1 أو 0 أو ‎+1) إذا كانت المصفوفة الأصلية أصغر من أو تساوي أو أكبر من المصفوفة الأخرى المعطاة على التوالي المعامل ==: يتحقق  من تساوي مصفوفتين مع بعضهما بعضًا. تكون مصفوفتان متساويتين إن حوت كلاهما نفس عدد العناصر، وكان كل ...

يعيد التابع receiver المتلقي (receiver) المقترن بالاستثناء KeyError. البنية العامة receiver → object‎ القيمة المعادة يعاد المستقبل (receiver) المقترن بالاستثناء KeyError. انظر أيضا التابع key: يعيد المفتاح الذي تسبب في رمي الاستثناء KeyError. مصادر قسم التابع receiver‎ في الصنف KeyError‎ في توثيق روبي الرسمي.

يُعيد التابع defined_class صنف أو وحدة التابع المُستدعى. class C; def foo; end; end trace = TracePoint.new(:call) do |tp| p tp.defined_class #=> C end.enable do C.new.foo end إذا تم تعريف التابع بواسطة وحدة، فستعاد تلك الوحدة. module M; def foo; end; end class C; include M; end; trace = TracePoint.new(:call) do |tp| p tp.defined_class #=> M end.enable do C.new.foo end ملحوظة: يُعيد التابع defined_class صنفًا مفردًا (singleton class). وسيط الكتلة السادس في التابع Kernel.set_trace_func يُمرَّر الصنف الأصليً (original class) للكائن عبر الصنف المفرد. هذا أحد الفوارق ...

يمنع التابع freeze إجراء المزيد من التعديلات على الوحدة. البنية العامة freeze → mod‎ القيمة المعادة يعاد الكائن المعطى نفسه. انظر أيضا التابع extended: يكافئ التابع included إلا أنه يُستخدم مع الوحدات الموسعة (extended modules). التابع include: يستدعي التابع Module.append_features على كل المعاملات الممررة بترتيب عكسي. مصادر قسم التابع freeze‎ في الصنف Module‎ في توثيق روبي الرسمي.

يُستخلص التابع hour من التوقيت رقم الساعة لليوم. البنية العامة hour → integer‎ القيمة المعادة يعاد عددٌ صحيحٌ بين 0 و 23 يمثِّل رقم الساعة لليوم من التاريخ المعطى. أمثلة مثال على استخدام التابع hour‎: t = Time.now #=> 2007-11-19 08:26:20 -0600 t.hour #=> 8‎ انظر أيضًا التابع yday: يُعيد عددًا صحيحًا يمثل يومًا من السنة الحالية. التابع sec: يستخلص من التوقيت رقم الثانية في الدقيقة. التابع year: يستخلص من التوقيت السنة (بما في ذلك ...

يُمثِّل الصنف EncodingError الصِّنفَ القاعديَّ (base class) لجميعِ أخطاء التّرميز (الصنف Encoding). مصادر صفحة الصنف EncodingError في توثيق روبي الرسمي.

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

يعيد التابع basename آخر مكوِّن من مسار اسم الملف المعطى. البنية العامة basename(file_name [, suffix] ) → base_name المعاملات file_name مسار الملف المراد اسخراج آخر مكون منه. يمكن أن يكون الفاصل المستعمل في فصل أجزاء هذا المسار هو File::SEPARATOR و File::ALT_SEPARATOR كلاهما عندما لا تكون قيمة الفاصل File::ALT_SEPARATOR هي nil. suffix معامل اختياري يحدد لاحقة الملف المراد إزالتها من الاسم الأساسي المستخرج من المسار. إن كانت قيمة هذا المعامل هي *.، فستُزال أية لاحقة تتبع الملف. القيمة المعادة يعاد الاسم الأساسي ...

يُنشئ التابع enum_for نسخةً من الصنف Enumerator الذي يجري عملية عدٍّ (enumerate) وتكرار عبر استدعاء التابع المُمرَّر إليها مع كائنٍ محدَّد، وتمرير وسائط إن أعطيت. إذا مُرِّرت كتلة (block) إلى التابع، فستُستخدم لحساب حجم نسخة الصنف Enumerator دون الحاجة إلى تكرارها (ألقِ نظرة على التابع Enumerator.size). البنية العامة enum_for(method = :each, *args) → enum enum_for(method = :each, *args){|*args| block} → enum المعاملات method التابع الذي ستُطبَّق عليه العملية. القيمة الافتراضية لهذا المعامل هي: each:. args* الوسائط المراد تمريرها إلى التابع. args| ...

يكتب التابع warn رسالة التحذير المُمرَّرة إليه في المجرى ‎$stderr، متبوعة بسطر جديد إذا لم تنته الرسالة بسطر جديد. تستدعي روبي هذا التابع لكافة التحذيرات. البنية العامة warn(msg) → nil‎ المعاملات msg‎ رسالة التحذير المراد إظهارها في مجر الخطأ القياسي. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضًا الوحدة Warning. مصادر قسم التابع warn‎ في الصنف Warning‎ في توثيق روبي الرسمي.

يعيد التابع length عدد عناصر المصفوفة التي استُدعيت معه. البنية العامة length → int القيم المعادة يعاد عدد صحيح يمثل عدد عناصر المصفوفة المعطاة. أمثلة أمثلة على استخدام التابع length: [ 1, 2, 3, 4, 5 ].length #=> 5 [].length #=> 0 انظر أيضًا التابع count: يعيد عدد عناصر المصفوفة التي استُدعيت معه أو عدد العناصر المتساوية مع قيمة معينة ...

يعيد التابع next الكائن التالي في المُعدِّد الذي استدعي معه، ويحرك موضع المؤشر الداخلي للأمام خطوة واحدة. عند وصول المؤشر إلى النهاية، يُطلَق الاستثناء StopIteration. البنية العامة next → object القيمة المعادة يعاد الكائن التالي في المُعدِّد المعطى. أمثلة مثال على استعمال التابع next: a = [1,2,3] e = a.to_enum p e.next #=> 1 p e.next #=> 2 p e.next #=> 3 p e.next #=> StopIteration انتبه إلى أنَّ السلسلة التعدادية المعادة عبر next لا تؤثر على التوابع التعدادية الغير ...

البنية العامة to_proc() انظر أيضا التابع to_a: يحول الكائن Hash الذي استدعي معه إلى مصفوفة متشعبة من المصفوفات [ key, value ]. التابع to_h: يعيد الكائن Hash المعطى نفسه. إذا استُدعي على صنف فرعي من Hash، فستحوِّل المستقبل إلى كائن من النوع Hash. التابع to_s: يعيد محتوى الكائن Hash الذي استدعي معه في سلسلة نصية. مصادر قسم التابع to_proc في الصنف Hash في توثيق روبي الرسمي.

يحذف التابع delete ملفًا محدَّدًا. يرمي هذا التابع استثناءً عند حصول أي خطأ. لمَّا كان التنفيذ الضمني لهذا التابع يعتمد على استدعاء النظام للدالة unlink(2)‎، فسيعتمد نوع الخطأ المرمي على أنواع الأخطاء الخاصة بها (اطلع على صفحة الدليل man لهذه الدالة لمزيد من التفاصيل) التي تأخذ شكلًا محدَّدًا مثل Errno::ENOENT. البنية العامة delete(file_name, ...) → integer المعاملات file_name اسم الملف المراد حذفه. ... أسماء الملفات الأخرى المراد حذفها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي أعطيت والتي يراد حذفها. انظر ...

يعدُّ التابع size اسمًا بديلًا للتابع length . البنية العامة size() انظر أيضًا التابع length : يعيد طول الطابور الذي استُدعي معه. التابع num_waiting : يعيد عدد الخيوط (threads) المنتظرة في الطابور الذي استُدعي معه. التابع pop : يجلب بياناتٍ من الطابور الذي استُدعي معه. مصادر صفحة التابع size في الصنف queue في توثيق روبي الرسمي.

يعيد التابع angle القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. البنية العامة angle → 0 or float‎ القيمة المعادة تعاد القيمة 0 إن كان العدد المعطى موجبًا، أو تعاد القيمة pi خلاف ذلك. انظر أيضا التابع abs2: يعيد مربع العدد الذي استُدعي معه. التابع arg: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك.. مصادر قسم التابع angle‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يحول التابع to_s العدد الجذري الذي استدعي معه إلى سلسلة نصية. البنية العامة to_s → string‎ القيمة المعادة تعاد قيمة العدد الجذري المعطى على هيئة سلسلة نصية. أمثلة مثال على استخدام التابع to_s‎: Rational(2).to_s #=> "2/1" Rational(-8, 6).to_s #=> "-4/3" Rational('1/2').to_s #=> "1/2"‎ انظر أيضا التابع to_r: يعيد العدد الجذري نفسه. التابع to_i: يُعيد القيمة مُقتطعة على هيئة عدد صحيح. التابع to_f: يحول العدد الجذري الذي استدعي معه إلى عدد عشري. مصادر قسم التابع to_s‎ في الصنف ...

يتحقق التابع empty?‎ إذا كان الكائن Hash الذي استدعي معه فارغًا أي لا يحتوي على أية أزواج. البنية العامة empty? → true or false القيمة المعادة تعاد القيمة true إذا الكائن Hash المعطى فارغًا أي لا يحتوي على أية أزواج. أمثلة مثال على استعمال التابع empty?‎: {}.empty? #=> true انظر أيضا التابع any?‎: يمرر كل زوج من مفتاح/قيمة من أزواج الكائن Hash المعطى إلى كتلة معينة ثم يعيد القيمة true إن أعادت الكتلة قيمة غير القيمة false أو nil. التابع eql?‎: يتحقق إذا كان كائنان من ...

يقتطع التابع each_line السلسلة النصية التي استدعيت معه إلى أجزاء (كل جزء يمثِّل سطرًا افتراضيًّا) مفصولة بفاصل محدَّد ثم يمرِّر كل منها على حدة إلى الكتلة المعطاة. البنية العامة each_line(separator=$/ [, getline_args]) {|substr| block } → str each_line(separator=$/ [, getline_args]) → an_enumerator المعاملات separator الفاصل المستعمل في تقطيع السلسلة النصية المعطاة إلى أجزاء. القيمة الافتراضية هي: /$ (فاصل سطر جديد). إن أعطي فاصل معدوم الطول (zero-length)، فستُقتطَع السلسلة النصية إلى فقرات محدَّدة عبر عدة محارف سطر جديد متتالية. getline_args اطلع على ...

يضبط التابع utime وقتي الوصول والتعديل لملف أو عدة ملفات محدَّدة. إن كان الملف المعطى وصلةً رمزيةً، فسيُنفَّذ هذا التابع على الملف الذي تشير إليه هذه الوصلة وليس على الوصلة نفسها. إن أردت سلوكًا معاكسًا لهذا، فاستعمل التابع lutime. البنية العامة utime(atime, mtime, file_name,...) → integer المعاملات atime وقت الوصول المراد تعيينه للملف أو الملفات المعطاة. mtime وقت التغيير المراد تعيينه للملف أو الملفات المعطاة file_name اسم الملف المراد تطبيق العملية عليه. ... أسماء الملفات الأخرى المراد تطبيق العملية عليها. القيمة المعادة يعاد عدد صحيح يمثِّل ...

يحول التابع to_i العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد صحيح ذي أساس محدَّد. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0 دون إطلاق أية استثناءات، بشرط أن يكون الأساس المراد تمثيل العدد به صحيحًا. البنية العامة to_i(base=10) → integer المعاملات base عدد صحيح يمثِّل الأساس الذي يُعاد وفقه العدد الموجود في بادئة السلسلة النصية المعطاة. تتراوح قيمة هذا المعامل ...

يبحث التابع rpartition عن تطابق نص أو نمط محدد بدءًا من نهاية السلسلة النصية ثم يعيد، إذا عثر التابع على تطابق، مصفوفةً من الجزء الذي يسبقه، والجزء المطابق، والجزء الذي يليه على التوالي. إذا لم يعثر التابع على تطابق، فإنَّه يعيد مصفوفة من سلسلتين فارغتين والسلسلة النصية المعطاة بعدهما على التوالي. البنية العامة rpartition(sep) → [head, sep, tail] rpartition(regexp) → [head, match, tail] المعاملات sep السلسلة النصية المُراد البحث عن تطابق لها ضمن السلسلة النصية المُعطاة. regexp التعبير النمطي المراد البحث ...

يتحقق التابع readable?‎ إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. اطلع على توثيق الدالة eaccess(3)‎. البنية العامة readable?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع owned?‎: يتحقق إن كان ملفٌ ما موجودًا ...

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

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

ينقل التابع flush أي بيانات مخزَّنة في المجرى الذي استدعي معه إلى نظام التشغيل (لاحظ أن هذا لا يشمل إلا التخزين المؤقت الداخلي لروبي؛ وقد يقوم نظام التشغيل بتخزين البيانات فيه أيضًا). البنية العامة flush → ios‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ العملية عليه. أمثلة مثال على استخدام التابع flush‎: $stdout.print "no newline" $stdout.flush‎ الناتج: no newline انظر أيضًا التابع fileno: يُعيد عددًا صحيحًا يمثل واصف الملف الرقمي للمجرى الذي استدعي معه. التابع fsync: يكتب مباشرةً جميع البيانات المخزنة في المجرى الذي استدعي ...

يعدُّ untrust تابعًا مهملًا (Deprecated method) وهو مكافئٌ تمامًا للتابع taint. البنية العامة untrust → obj القيم المعادة يُعاد الكائن المعطى بعد تعليمه ككائن فاسد (tainted). انظر أيضًا التابع taint: يصم الكائن الذي استدعي معه بأنه كائنٌ فاسد. التابع ?tainted: يتحقَّق إذا كان التابع فاسدًا. التابع trust: يعدُّ تابعًا مهملًا وهو مكافئٌ تمامًا للتابع untaint. التابع untaint: يُلغي علامة الحالة الفاسدة من الكائن الذي استدعي معه. التابع ?untrusted: يعتبر تابعًا غير منصوحٍ به وهو مكافئٌ للتابع ?tainted. مصادر صفحة التابع ...

يستدعي التابع include التابع append_features على كل المعاملات المُمرَّرة بترتيب عكسي. البنية العامة include(module, ...) → self‎ المعاملات module‎ يمثل الوحدة التي سيُستدعَى التابع append_features عليها. ... يمثل الوحدات الأخرى التي سيُستدعَى التابع append_features عليها بترتيب عكسي. القيمة المعادة يعاد الكائن المعطى. انظر أيضا التابع include?‎: يتحقق إن كانت الوحدة المعطاة مُضمّنة في الوحدة التي استُدعي معها أو في أحد أسلافها (ancestors). التابع included: يُستدعى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع included_modules: يعيد قائمة بالوحدات المضمنة في ...

يعيد التابع keys مصفوفة جديدة تحوي مفاتيح الكائن Hash الذي استدعي معه. البنية العامة keys → array القيمة المعادة تعاد مصفوفة جديدة تحوي مفاتيح الكائن Hash المعطى. أمثلة مثال على استعمال التابع keys: h = { "a" => 100, "b" => 200, "c" => 300, "d" => 400 } h.keys #=> ["a", "b", "c", "d"] انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. التابع key: يعيد المفتاح المقابل لقيمة معيَّنة في الكائن Hash الذي ...