نتائج البحث

يعيد التابع stat كائنًا من النوع Hash يحوي عدادات مُخصصة (implementation-dependent counters) داخل الآلة الافتراضية (VM). يتضمن الكائن Hash معلومات حول تسلسلات ذاكرة التخزين المؤقت (cache serials) الخاصة بالتوابع والثوابت مثل: { :global_method_state=>251, :global_constant_state=>481, :class_serial=>9029 }‎ تقديم (implementation) محتويات الكائن Hash مخصوصة، ويمكن أن تتغير مع مرور الوقت. لا يُتوقّع أن يعمل هذا التابع إلا على على C Ruby. البنية العامة stat → Hash stat(hsh) → hsh stat(Symbol) → Numeric‎ القيمة المعادة يعاد كائن من النوع Hash يحوي عدادات مُخصصة داخل ...

يغيِّر التابع chmod بتات الأذونات للملف الذي استدعي معه. إذا كان الملف وصلةً رمزيَّةً، فيتبع التابع هذه الوصلة ويطبق العملية على الملف الذي تشير إليه. تعتمد التأثيرات الفعلية لاستدعاء هذا التابع على المنصة المستعملة (راجع شرح بتات الأذونات في بداية شرح الصنف File). في الأنظمة الشبيهة بيونكس، اطلع على الدالة chmod(2)‎ لمزيد من التفاصيل. البنية العامة chmod(mode_int) → 0 المعاملات mode_int نمط الأذونات الجديدة المراد تعيينها إلى الملفات المحدَّدة. القيمة المعادة تعاد القيمة 0 بعد اتمام العملية. أمثلة مثال على استعمال ...

يشبه التابع next!‎ التابع next تمامًا باستثناء أنه يعدل على السلسلة النصية التي تُستدعَى معه. البنية العامة next! → str القيمة المعادة تعاد السلسلة النصية المعطاة نفسها بعد زيادتها عبر حساب السلسلة النصية اللاحقة لها. انظر أيضًا التابع chop!‎: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع next: يعيد السلسلة النصية اللاحقة للسلسلة النصية التي استدعي معها. التابع reverse!‎: يعدل على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. مصادر قسم التابع next!‎‎ في الصنف String في توثيق روبي ...

يُعيد التابع bytes سلسلةً نصيةً ثنائيةً عشوائية بحجم محدَّدٍ من البايتات. البنية العامة bytes(size) → a_string المعاملات size حجم السلسلة النصية المراد توليدها. القيم المعادة تُعاد سلسلةٌ نصيةٌ ثنائيةٌ عشوائية بحجم قيمة المعامل size. أمثلة مثالٌ عن استخدام التابع bytes: random_string = Random.new.bytes(10) # => "\xD7:R\xAB?\x83\xCE\xFAkO" random_string.size # => 10 انظر أيضًا التابع urandom : يعيد سلسلةً نصيةً (string) باستخدام ميزاتٍ توفرها المنصة. التابع ...

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

يقرأ التابع read_nonblock عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى ARGF في وضع عدم الحجز (non-blocking mode). البنية العامة read_nonblock(maxlen[, options]) → string read_nonblock(maxlen, outbuf[, options]) → outbuf المعاملات maxlen عدد البايتات الأعظمي المراد قراءته من المجرى ARGF. options خيارات إضافية. outbuf سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى ARGF. القيم المعادة تعاد سلسلة نصية تمثل البيانات المقروءة من المجرى ARGF، أو يعاد الوسيط outbuf (إن أعطي) بعد تخزين البيانات المقروءة فيه. انظر أيضًا التابع read: يقرأ ...

يتحقق التابع wednesday?‎ إن كان التوقيت يمثل يوم الأربعاء. البنية العامة wednesday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم الأربعاء؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع wednesday?‎: t = Time.local(1993, 2, 24) #=> 1993-02-24 00:00:00 -0600 p t.wednesday? #=> true‎ انظر أيضًا التابع tuesday?‎: يتحقق إن كان التوقيت يمثل ...

يغلق التابع close_write طرف الكتابة الخاص بمجرى د/خ مزدوج (duplex)؛ أي تلك المجاري التي تحتوي على مجريي قراءة وكتابة، مثل الأنابيب (pipes). سيُطلق الاستثناء IOError إن لم يكن المجرى مزدوجًا. أصبحت روبي تتجاهل استدعاء هذا التابع على مجاري د/خ المغلقة منذ الإصدار 2.3. البنية العامة close_write→ nil‎ القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. أمثلة مثال على استخدام التابع close_write‎: f = IO.popen("/bin/sh","r+") f.close_write f.print "nowhere"‎ ناتج تنفيذ هذه الشيفرة هو: prog.rb:3:in `write': not opened for writing (IOError) from prog.rb:3:in `print' from prog.rb:3‎ ...

يتحقق التابع zero?‎ إن كانت قيمة العدد الذي استُدعي معه تساوي الصفر. البنية العامة zero? → true or false‎ القيمة المعادة تعاد القيمة true إن كانت قيمة العدد المعطى تساوي الصفر. خلا ذلك، تعاد القيمة false. انظر أيضا التابع integer?‎: يتحقق إن كان العدد الذي استُدعي معه من النوع Integer. التابع negative?‎: يتحقق إن كان العدد الذي استُدعي معه عددًا سالبًا. التابع positive?‎: يتحقق إن كان العدد الذي استُدعي معه عددًا موجبًا. التابع real?‎: يتحقق إن كان العدد الذي استُدعي مهه عددًا حقيقيًّا (أي ليس ...

يعيد التابع has_value?‎ إذا كانت قيمةٌ معيَّنةٌ موجودةً في الكائن Hash المعطى ومرتبطة بمفتاح. البنية العامة has_value?(value) → true or false المعاملات value القيمة المراد التحقق من وجودها. القيمة المعادة تعاد القيمة true إذا كانت القيمة value المُعطاة موجودةً ومرتبطة بمفتاح ما في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_value?‎: h = { "a" => 100, "b" => 200 } h.value?(100) #=> true h.value?(999) #=> false انظر أيضا التابع has_key?‎: يتحقق إذا كان مفتاحٌ معيَّن موجودًا في ...

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

يضبط التابع gid عند استدعائه بالشكل gid= integer مُعرِّف المجموعة المالكة للعملية الحالية إلى القيمة integer. البنية العامة gid= integer → integer القيم المعادة يعاد العدد الصحيح integer بعد تعيينه إلى مُعرِّف المجموعة المالكة للعملية الحالية. انظر أيضًا التابع egid=‎: يضبط عندما يستدعى بالشكل egid = integer المُعرِّف الفعَّال للمجموعة المالكة لهذه العملية إلى القيمة integer. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. مصادر قسم التابع gid في الصنف Process في توثيق روبي الرسمي.

يعيد التابع transform_keys كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن Hash الذي استدعي معه. لا يُغيّر هذا التابع القيم المرتبطة بالمفاتيح. إذا لم تُعطَ أية كتلة، فسيُعاد كائن من النوع enumerator بدلًا من ذلك. البنية العامة transform_keys {|key| block } → new_hash transform_keys → an_enumerator القيمة المعادة يعاد كائن جديد من النوع Hash مع ناتج تنفيذ الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح الكائن Hash المعطى، أو يعاد كائن من النوع ...

يقرأ التابع read المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. عند الوصول إلى نهاية المجلد، يعيد التابع القيمة nil. البنية العامة read → string or nil القيم المعادة تُعاد سلسلة نصية تمثل المدخلة التالية في المجلد المعطى، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى. أمثلة مثال عن استخدام التابع read على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") d.read #=> "." d.read #=> ".." d.read ...

يعيد التابع grep مصفوفة تحوي كل عنصر مطابق لنمط محدَّد من عناصر الكائن القابل للتعداد الذي استدعي معه. إن أعطيت كتلة، فسيُمرَّر كل عنصر مطابق للنمط إليها ثم تعاد مصفوفة تحوي النتائج المقابلة التي تعيدها هذه الكتلة للعناصر المطابقة. البنية العامة grep(pattern) → array grep(pattern) { |obj| block } → array المعاملات pattern النمط المراد مطابقته لكل عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد مصفوفة تحوي كل عنصر مطابق للنمط pattern من عناصر الكائن القابل للتعداد المعطى، أو القيم التي ...

يحول التابع to_r قيمة التوقيت المعطى إلى عدد جذري يمثل عدد الثواني التي مرت منذ توقيت يونكس. هذا التابع هو أحد التوابع التي تستعمل للحصول على قيمة دقيقة تمثل عدد النانوثواني التي مرت منذ توقيت يونيكس. يمكنك استخدام هذا التابع لتحويل التوقيت إلى "توقيت حقبة أخرى". البنية العامة to_r → a_rational‎ القيمة المعادة تعاد قيمة التوقيت كعدد جذري يمثل عدد الثواني التي مرت منذ توقيت يونيكس. أمثلة مثال على استخدام التابع to_r‎: t = Time.now p t.to_r ...

يستدعي التابع yield الكتلة المرتبطة بالمتغير الذي استعمل معه مُعيِّنًا معاملات الكتلة إلى القيم المعطاة ضمنه باستخدام شيءٍ مشابهٍ لدلالات استدعاء التابع. يُعيد المعامل قيمة آخر تعبيرٍ قُيِّم في الكتلة. a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } } a_proc.call(9, 1, 2, 3) #=> [9, 18, 27] a_proc[9, 1, 2, 3] #=> [9, 18, 27] a_proc.(9, 1, 2, 3) #=> [9, 18, 27] a_proc.yield(9, 1, ...

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

البنية العامة add_stress_to_class(*args) انظر أيضا التابع remove_stress_to_class. التابع enable: يفعِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمالmalloc()‎. مصادر قسم التابع add_stress_to_class‎ في الصنف GC في توثيق روبي الرسمي.

يستبدل التابع succ!‎ السلسلة النصية التي استدعيت معه بالسلسلة التي تليها؛ وتُحسَب هذه السلسلة بزيادة حروف السلسلة المُعطاة بدءًا من أول حرف أبجدي رقمي (alphanumeric) في أقصى اليمين، أو أي محرف آخر فى حال عدم وجود حروف أبجدية رقمية في السلسلة. زيادة رقم ينتج عنه رقم آخر، وزيادة حرف ينتج عنه حرف آخر؛ أما الحروف الغير الأبجدية أو رقمية، فإن الزيادة تتم حسب تسلسل ترتيب مجموعة الحروف الأساسية. في حال أدت زيادة الحرف إلى حصول حمل، فإن التابع يزيد الحرف ...

يعطي التابع pass إلى مُجدوِل المهام الفرعية (thread scheduler) تلميحًا لتمرير التنفيذ إلى مهمة فرعية أخرى. مسألة تبديل المهمة الفرعية قيد التشغيل من عدمها تعتمد على نظام التشغيل والمعالج المستخدمين. البنية العامة pass→ nil‎ القيمة المعادة تعاد القيمة nil. انظر أيضًا التابع new: ينشئ مهمة فرعية جديدة لتنفيذ الكتلة المعطاة. مصادر قسم التابع pass‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يعيد تابع النسخة disasm سلسلة التعليمات المعطاة على هيئة سلسلة نصية قابلة للقراءة. البنية العامة disasm → str القيمة المعادة تعاد سلسلة نصية تحوي سلسلة التعليمات بشكل قابل للقراءة. أمثلة مثال على استخدام التابع disasm‎: puts RubyVM::InstructionSequence.compile('1 + 2').disasm الناتج سيكون: == disasm: <RubyVM::InstructionSequence:<compiled>@<compiled>>========== 0000 trace 1 ...

يعيد التابع pre_match الجزء الذي يسبق المطابقة (match) الحالية من السلسلة النصية الأصلية. يكافئ هذا التابع المتغير الخاص `$. البنية العامة pre_match→ str‎ القيمة المعادة يعاد الجزء الذي يسبق المطابقة (match) الحالية من السلسلة النصية الأصلية. أمثلة مثال على استخدام التابع pre_match‎: m = /(.)(.)(\d+)(\d)/.match("THX1138.") m.pre_match #=> "T"‎ انظر أيضا التابع post_match: يعيد الجزء الذي يلي المطابقة (match) الحالية من السلسلة النصية الأصلية. مصادر قسم التابع pre_match‎ في الصنف MatchData‎ في توثيق روبي الرسمي.

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

يعيد التابع lcm‎ أصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعطى. النتيجة دائمًا موجبة، كما يعيد التعبيران ‎0.lcm(x)‎ و x.lcm(0)‎. القيمة 0.  البنية العامة lcm(other_int) → integer‎ المعاملات other_int‎ عدد صحيح. القيمة المعادة يعيد التابع lcm‎ أصغر مضاعف مشترك للعدد الذي استُدعي معه والعدد المٌعطى other_int‎. أمثلة مثال على استخدام التابع lcm‎: 36.lcm(60) #=> 180 2.lcm(2) ...

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

يعيد التابع children‎ مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط الاختياري encoding الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه. البنية العامة children( dirname ) → array children( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المُحدد المراد معرفة محتواه. encoding ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات. القيمة المعادة تُعاد مصفوفة تحوي جميع ...

يعيد التابع squeeze نسخة عن السلسلة النصية التي استدعي معها مع استبدال المحارف المكررة على التوالي بمحرف واحد لكل منها. يمكن تحديد المحارف المراد إزالة تكرارها دون غيرها عبر تمريرها إلى التابع. البنية العامة squeeze([other_str]*) → new_str المعاملات other_str تحدد السلسلة other_str مجموعة المحارف المُراد إزالة تكرارها من نسخة السلسلة النصية المُعطاة. عند استعمال الرمز ^ في بداية السلسلة other_str، فإن التابع يشمل جميع المحارف عدا محارف تلك السلسلة. الصيغة c1-c2 تعني جميع المحارف الواقعة في المجال بين c1 و ...

يتحقق التابع ‎finite?‎ مما إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي الذي استُدعي معه منتهية (finite). البنية العامة finite? → true or false القيمة المعادة تعاد القيمة true إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي المعطى منتهية (finite)، وإلا فستُعاد القيمة false. أمثلة أمثلة عن استخدام معامل التابع ‎finite?‎: puts Complex(3.0, -4.0).finite? ; # true انظر أيضًا التابع ‎infinite?‎: يتحقق ما إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي منتهية أو غير ...

يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية. البنية العامة max → obj max { |a, b| block } → obj max(n) → array max(n) { |a, b| block } → array المعاملات ...

يتحقَّق التابع ?is_a إن كان الصنف المُمرَّر إليه هو نفسه صنف الكائن الذي استدعي معه، أو إن كان هذا الصنف أحد الأصناف العليا (superclasses) للكائن المعطى أو الوحدات المُضمَّنة في هذا الكائن. البنية العامة is_a?(class) → true or false المعاملات class الصنف المراد التحقق منه. القيم المعادة تُعاد القيمة true إذا كان الصنف class هو نفسه صنف الكائن المعطى، أو أنه أحد الأصناف العليا أو الوحدات المُضمَّنة في الكائن المعطى؛ خلاف ذلك، تُعاد القيمة false. أمثلة مثالٌ عن استخدام التابع ...

يستبدل التابع !tr مجموعة محارف محدَّدة في السلسلة النصية المُعطاة بمحارف مقابلة لها. البنية العامة tr!(from_str, to_str) → str or nil يستبدل التابع !tr مجموعة حروف السلسلة  from_str في السلسلة النصية المُعطاة بالمحارف المقابلة لها في السلسلة to_str. إذا كانت السلسلة to_str أقصر من السلسلة from_str، فسيكرر الحرف الأخير فيها حتى تصبحان متساويتين من أجل الحفاظ على التنسيق. يمكن أن تحتوي كلا السلسلتين from_str و to_str على الصيغة c1-c2، والتي تُستعمَل للإشارة إلى مجال محدد من الحروف. يشير الرمز ^ فى ...

يعيد التابع to_r الصفر كعدد جذري (rational). البنية العامة to_r → (0/1)‎ القيمة المعادة يعاد الصفر كعدد جذري. انظر أيضا التابع to_i: يعيد دائما الصفر. التابع to_s: يعيد سلسلة نصية فارغة دائمًا. مصادر قسم التابع to_r‎ في الصنف NilClass‎ في توثيق روبي الرسمي.

يقرأ التابع read عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه عندما يُستدعى التابع read في نهاية الملف، فسيعيد إما nil أو ""، بناءً على الطول المُمرَّر إليه، مثلا، ستعيد التعبيرات read و read(nil)‎ و read(0)‎ القيمة ""، فيما سيعيد التعبير read( positive_integer )‎ القيمة nil. لاحظ أنَّ هذا التابع يتصرف بطريقة مشابهة للدالة fread()‎ في لغة C. وهذا يعني أنَّه سيحاول إجراء استدعاءات النظام read(2)‎ لقراءة البيانات بالطول المحدَّد (أو حتى يصادف محرف نهاية الملف EOF). يستمر هذا السلوك ...

يشبه التابع lstat التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size ...

يزيل التابع remove_const تعريف ثابت محدَّد، ويعيد القيمة السابقة له. إذا كان هذا الثابت يشير إلى وحدة، فلن يُغيَّر اسم الوحدة، وهو ما قد يكون مصدر إرباك. البنية العامة remove_const(sym)→ obj‎ المعاملات sym‎ رمز يمثل الثابت المراد إزالته. القيمة المعادة يعاد كائن يمثِّل القيمة السابقة للثابت ذي الاسم sym بعد حذفه. انظر أيضا التابع remove_class_variable: يزيل تعريف متغير محدَّد من صنفٍ ثم يعيد قيمة ذلك الثابت. التابع remove_method: يزيل تابعًا ذا اسم محدَّد من الصنف الحالي. مصادر قسم التابع remove_const‎ في الصنف Module‎ ...

يعيد التّابع locale_chaemap اسم مخطّط توزيع الأحرف (charmap) للمحلية (locale) الحالية. البنية العامة locale_charmap → string القيم المعادة تعاد سلسلة نصية تمثل اسم مخطّط توزيع الأحرف (charmap) للمحلية الحالية، أو تعاد القيمة nil العدمية  إذا لم توجد معلومات موافقة. أمثلة بعض الأمثلة عن استخدام التابع locale_charmap‎‎: Debian GNU/Linux LANG=C Encoding.locale_charmap #=> "ANSI_X3.4-1968" LANG=ja_JP.EUC-JP Encoding.locale_charmap #=> "EUC-JP" SunOS 5 LANG=C Encoding.locale_charmap #=> "646" LANG=ja ...

يعيد التابع numerator البسط للعدد الجذري الذي استدعي معه. البنية العامة numerator → integer‎ القيمة المعادة يعاد البسط (numerator) للعدد الجذري المعطى. أمثلة مثال على استخدام التابع numerator‎: Rational(7).numerator #=> 7 Rational(7, 1).numerator #=> 7 Rational(9, -4).numerator #=> -9 Rational(-2, -10).numerator #=> 1‎ انظر أيضا التابع denominator‎: يعيد المقام للعدد الجذري الذي استدعي معه. مصادر قسم التابع numerator‎ في الصنف Rational‎ في توثيق روبي الرسمي.

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

يتحقق التابع zero?‎ إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. ...

يعيد التابع autoload?‎ اسم الملف الذي سيُحمل إن كان المعامل المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. البنية العامة autoload?(name)→ String or nil‎ القيمة المعادة تعاد سلسلة نصية تمثِّل اسم الملف الذي سيُحمل إن كان الوسيط المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع autoload?‎: module A end A.autoload(:B, "b") A.autoload?(:B) #=> "b"‎ انظر أيضا التابع autoload: يُُسجل اسم الملف ...

يتحقق التابع tuesday?‎ إن كان التوقيت يمثل يوم الثلاثاء. البنية العامة tuesday? → true or false‎ القيمة المعادة تُعاد القيمة true إن كان التوقيت يمثل يوم الثلاثاء؛ خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع tuesday?‎: t = Time.local(1991, 2, 19) #=> 1991-02-19 00:00:00 -0600 p t.tuesday? #=> true‎ انظر أيضًا التابع wednesday?‎: يتحقق إن كان ...

يحول التابع to_r العدد الموجود في بادئة السلسلة النصية المعطاة إلى عدد جذري. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. يمكن الفصل بين سلاسل الأرقام باستعمال الشرطة السفلية (underscore). إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0/1 دون إطلاق أية استثناءات. استعمال التابع مع سلسلة نصية (مثل ‎“0.3”.to_r) يعيد نتيجة مختلفة عن استعماله مع عدد عشري (مثل ‎0.3.to_r). يكافئ الشكل الأول القيمة "3/10" ولكن الأخير لا يكافئ هذه القيمة. ...

ينشئ التابع mktime توقيتًا جديدًا بشكل مشابه للتابع gm باستثناء أنَّه يفسر القيم في إطار المنطقة الزمنية المحلية. البنية العامة mktime(year) → time mktime(year, month) → time mktime(year, month, day) → time mktime(year, month, day, hour) → time mktime(year, month, day, hour, min) → time mktime(year, month, day, hour, min, sec_with_frac) → time mktime(year, month, day, hour, min, sec, usec_with_frac) → time mktime(sec, min, hour, day, month, year, dummy, dummy, isdst, dummy) → time المعاملات year‎ عدد يمثِّل السنة. month‎ عدد بين 1 و 12 يمثِّل الشهر، أو ...

يتحقق التابع compare_by_identity?‎ إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. البنية العامة compare_by_identity? → true or false القيمة المعادة تعاد القيمة true إذا كان الكائن Hash الذي استدعي معه سيقارن مفاتيحه بواسطة مُعرِّفاتهم. خلا ذلك، تعاد القيمة false. انظر أيضا التابع compare_by_identity: يجعل الكائن Hash يقارن مفاتيحه بواسطة مُعرِّفاتها، أي أنَّها سوف تُعدُّ نفس الكائنات على أنَّها نفس المفاتيح. مصادر قسم التابع compare_by_identity?‎ في الصنف Hash في توثيق روبي الرسمي.

يفعِّل التابع enable جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. البنية العامة enable → true or false القيمة المعادة تعاد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع enable: GC.disable #=> false GC.enable #=> true GC.enable #=> false انظر أيضا التابع disable: يعطِّل جمع البيانات المهملة، ويعيد القيمة true إذا كان جمع البيانات المهملة مُعطَّلًا مسبقًا. مصادر قسم التابع ...

يعيد التابع conj الكائن الذي استُدعي معه (الكائن self). البنية العامة conj → self conjugate → self‎ القيمة المعادة يعاد الكائن المعطى نفسه (الكائن self). انظر أيضا التابع coerce: إن كان العدد المُمرَّر إليه من نفس نوع العدد الذي استُدعي معه، فسيعيد مصفوفة تحوي هذين العددين. خلاف ذلك، سيحول هذين العددين إلى النوع Float ويعيدهما في مصفوفة. التابع conjugate: يعيد الكائن self. مصادر قسم التابع conj‎ في الصنف Numeric‎ في توثيق روبي الرسمي.

يُنشئ التابع ()new نسخةً جديدةً من الصنف Queue. البنية العامة new() القيم المعادة تُعاد نسخةٌ من الصنف Queue. انظر أيضًا التابع clear : يحذف كل الكائنات من الطابور الذي استُدعي معه. التابع close : يغلق الطابور الذي استُدعي معه. التابع length : يعيد طول الطابور الذي استُدعي معه. مصادر صفحة التابع new في الصنف queue في توثيق روبي الرسمي.

يحول التابع signame رقم الإشارة إلى اسم الاسم المقابل لها. البنية العامة signame(signo) → string or nil‎ المعاملات signo‎ رقم الإشارة المراد معرفة اسمها. القيمة المعادة يعيد التابع signame سلسلة نصية تمثل اسم الإشارة، أو تعاد القيمة nil إن لم يكن المعامل signo رقم إشارة صالح. أمثلة مثال على استخدام التابع signame‎: Signal.trap("INT") { |signo| puts Signal.signame(signo) } Process.kill("INT", 0)‎ ناتج تنفيذ الشيفرة هو: INT انظر أيضًا التابع list: يعيد قائمة بأسماء الإشارة المعيَّنة لأرقام الإشارة الأصلية المقابلة لها. التابع trap: يربط معالجًا بإشارة ...

يستدعي التابع each_value الكتلة المعطاة مرةً واحدةً لكل مفتاح من مفاتيح أزواج الكائن Hash الذي استدعي معه بعد تمرير قيمة كل زوج إليها. البنية العامة each_value {| value | block } → hsh each_value → an_enumerator القيمة المعادة يعاد ناتج تنفيذ الكتلة block على كل زوج من أزواج الكائن Hash المعطى بعد تمرير قيمة كل زوج إليها. إذا لم تُعطَ كتلة، يُعاد كائن من النوع enumerator بدلًا من ذلك.   أمثلة مثال على استعمال التابع each_value: h = { "a" => 100, ...

يعيد التابع rewind مؤشر المجرى الذي استُدعي معه إلى موضع بداية الإدخال؛ هذا يؤدي إلى تعيين رقم السطر lineno إلى القيمة صفر. لاحظ أنَّه لا يمكن استخدام هذا التابع مع المجاري من مثل الأنابيب (pipes) والطرفيات tty، والمقابس (sockets). البنية العامة rewind → 0‎ القيمة المعادة تعاد القيمة صفر بعد تنفيذ العملية. أمثلة مثال على استخدام التابع rewind‎: f = File.new("testfile") f.readline #=> "This is line one\n" f.rewind #=> 0 f.lineno #=> 0 f.readline ...

يتحقق التابع executable_real?‎ إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. اطلع أيضًا على توثيق الدالة access(3)‎. البنية العامة executable_real?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. خلا ذلك، تعاد القيمة false.   انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن ...

يُعيد التابع tv_nsec عدد النانوثواني المقابلة للتوقيت المعطى التي مرت منذ توقيت يونيكس. لاحظ أنه تختلف الأرقام الدنيا المعادة من التابع to_f والتابع subsec لأن الأعداد العشرية المضاعفة ذات المعيار IEEE 754 ليست دقيقة بما يكفي لتمثيل عدد النانوثواني التي مرت منذ حقبة يونيكس. يُعيد التابع nsec قيمة أكثر دقة. البنية العامة tv_nsec → int‎ القيمة المعادة يعاد عدد صحيح يمثِّل عدد النانوثواني المقابلة للتوقيت المعطى التي مرت منذ حقبة يونيكس. أمثلة مثال على استخدام التابع tv_nsec‎: t = Time.now ...

يعيّن التابع lineno عند استدعاءه بالشكل lineno = integer رقم السطر الحالي يدويًا إلى القيمة integer. لن يُحدّث المتغير ‎$.‎ إلا عند القراءة التالية. البنية العامة lineno = integer → integer‎ القيمة المعادة يعاد العدد الصحيح integer بعد تعيينه إلى رقم السطر الحالي. أمثلة مثال على استخدام التابع lineno=‎: f = File.new("testfile") f.gets #=> "This is line one\n" $. ...

يُعيد التابع binding الرَّبط (binding) الموافق للكائن Proc الذي استدعي معه. لاحظ أنَّ التابع Kernel.eval يقبل إما كائنًا من النوع Proc أو النوع Binding على أنَّه معامله الثّاني. البنية العامة binding → binding القيم المعادة يُعاد كائنٌ من النوع Binding. أمثلة مثالٌ عن استخدام التابع binding: def fred(param) proc {} end b = fred(99) eval("param", b.binding) #=> 99 انظر أيضًا التابع arity: يُعيد عدد الوسائط الإلزاميَّة في الكائن proc الذي استدعي معه. التابع curry: يُعيد كتلة proc مقسَّمة. التابع to_s: ...

يمرر التابع select قيم كل أعضاء البنية إلى الكتلة المعطاة ويعيد مصفوفة تحتوي قيم الأعضاء التي أعادت الكتلة معها القيمة true. هذا التابع يكافئ التابع Enumerable.select. البنية العامة select {|obj| block } → array select → enumerator‎ القيمة المعادة تعاد مصفوفة تحوي أعضاء البنية التي أعيدت القيمة true معها بعد تمريرها إلى الكتلة block المعطاة. يعاد كائن من النوع enumerator إن لم تعطَ الكتلة block. أمثلة مثال على استخدام التابع select‎: Lots = Struct.new(:a, :b, :c, :d, :e, :f) l = ...

يعيد التابع succ‎ العدد التالي للعدد الذي استُدعي معه. أي int+1. البنية العامة succ → integer‎ القيمة المعادة يعاد العدد الموالي للعدد الذي استُدعي معه. أمثلة مثال على استخدام التابع succ‎: 1.next #=> 2 (-1).next #=> 0 1.succ #=> 2 (-1).succ #=> 0 ‎ انظر أيضا التابع next: يعيد العدد الموالي للعدد الذي استُدعي معه. التابع pred: يعيد العدد السابق على العدد الذي استُدعي معه. مصادر قسم التابع succ‎ في ...

يحسب التابع asin معكوس الجيب (arc sine) للعدد المعطى. يعيد عددًا من المجال ‎-PI/2..PI/2. مجال التعريف: ‎‎‎‎[-1 ، 1]‎. المجال المقابل: [‎-PI / 2، PI / 2]. البنية العامة asin(x) → Float‎ المعاملات x‎ العدد الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد عدد عشري يمثِّل قيمة معكوس الجيب (arc sine) للعدد x المعطى. أمثلة مثال على استخدام التابع asin‎: Math.asin(1) == Math::PI/2 #=> true‎ انظر أيضا التابع acosh: يحسب معكوس جيب التمام القطعي. التابع asinh: يحسب معكوس الجيب القطعي (inverse hyperbolic sine). ...

يعدُّ التابع append اسمًا بديلًا للتابع push. انظر أيضًا التابع push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. مصادر قسم التابع append في الصنف Array في توثيق روبي الرسمي.

يحذف التابع drop_while العناصر الأولى المحقِّقة لشرط معيِّن من المُعدِّد المعطى ثم يعيد مصفوفة تحوي العناصر المتبقية. البنية العامة drop_while { |obj| block } → array drop_while → an_enumerator القيمة المعادة تعاد مصفوفة تحوي جميع عناصر المُعدِّد المعطى باستثناء العناصر الأولى التي لا تعاد معها القيمة nil أو false عند تمريرها إلى الكتلة. أمثلة مثال على استعمال التابع drop_while: a = [1, 2, 3, 4, 5, 0] a.drop_while { |i| i < 3 } #=> [3, 4, 5, 0] انظر أيضًا التابع ...

يعيد التابع remainder‎ باقي عملية قسمة العدد الذي استدعي معه على العدد الذي مُرِّر إليه. استدعاء التابع بالشكل x.remainder(y)‎ يكافئ x-y*(x/y).truncate. البنية العامة remainder(numeric) → real‎ المعاملات numeric عدد صحيح يمثل الطرف الثاني للعملية. القيمة المعادة يعاد باقي عملية قسمة العدد int على العدد numeric. أمثلة مثال على استخدام التابع remainder‎: 5.remainder(3) #=> 2 -5.remainder(3) #=> -2 5.remainder(-3) #=> 2 -5.remainder(-3) #=> -2 5.remainder(1.5) #=> 0.5 ‎ انظر أيضا التابع div: يعيد ...

يزيل التابع remove_class_variable تعريف متغير محدَّد من صنفٍ ثم يعيد قيمة ذلك الثابت. البنية العامة remove_class_variable(sym) → obj‎ المعاملات sym‎ رمز يمثِّل المتغير المراد إزالته من الصنف. القيمة المعادة يعاد كائن يمثِّل قيمة الثابت الذي حُذف. أمثلة مثال على استخدام التابع remove_class_variable‎: class Dummy @@var = 99 puts @@var remove_class_variable(:@@var) p(defined? @@var) end‎ ناتج تنفيذ المثال السابق هو: 99 nil انظر أيضا التابع remove_const: يزيل تعريف ثابت محدَّد، ويعيد القيمة السابقة له.  التابع remove_method: يزيل تابعًا ذا اسم محدَّد من الصنف الحالي. ...

يستخلص التابع day من التوقيت رقم اليوم من الشهر (1..n). البنية العامة day → integer‎ القيمة المعادة يعاد عدد صحيح يمثل رقم اليوم من الشهر (1..n) المستخلص من التوقيت المعطى. أمثلة مثال على استخدام التابع day‎: t = Time.now #=> 2007-11-19 08:27:03 -0600 t.day #=> 19 t.mday #=> 19‎ انظر أيضًا التابع yday: يُعيد عددًا صحيحًا يمثل يومًا من السنة 1..366. التابع sec: يستخلص من ...

يتحقق التابع positive?‎ إن كان العدد العشري الذي استُدعي معه عددًا موجبًا. البنية العامة positive? → true or false‎ القيمة المعادة تعاد القيمة true إن كان العدد العشري المعطى عددًا موجبًا. انظر أيضا التابع ?finite: يتحقق إذا كان العدد العشري الذي استدعي معه عددًا عشريًّا صالحًا وفقًا لمعيار IEEE؛ أي أنه ليس عددٌ لا نهائي ويعيد التابع ‎nan?‎ القيمة false معه. التابع nan?‎: يتحقق إذا كان العدد العشري الذي استدعي معه عددًا عشريًّا غير صالح وفقًا لمعيارIEEE. التابع negative?‎: يتحقق إن كان العدد الذي استُدعي ...

يعيد التابع ‎phase الجزء الزاوي (الزاوية θ) للشكل القطبي من العدد العقدي الذي استُدعي معه. البنية العامة phase → float القيمة المعادة يعاد عدد عشري يمثِّل الجزء الزاوي (الزاوية θ) للشكل القطبي من العدد العقدي المعطى أمثلة أمثلة عن استخدام التابع ‎phase: Complex.polar(3, Math::PI/2).phase #=> 1.5707963267948966 انظر أيضًا التابع ‎magnitude: يعيد الجزء المطلق (الطويلة r) للشكل القطبي من العدد العقدي.  التابع ‎numerator: يعيد بسط العدد العقدي الكسري.  التابع ‎real: يعيد الجزء الحقيقي للعدد العقدي.  التابع imag: يعيد الجزء التخيلي للعدد ...

يضبط التابع =max قيمة الحد الأقصى لحجم الطابور إلى القيمة المُمرَّرة إليه. البنية العامة max=(number)‎ المعاملات number‎ عدد يمثل الحد الأقصى لحجم الطابور. انظر أيضًا التابع max: يعيد الحد الأقصى لحجم الطابور. مصادر قسم التابع max=‎ في الصنف SizedQueue‎ في توثيق روبي الرسمي.

يجلب التابع pop بياناتٍ من الطابور الذي استُدعي معه. إذا كان طابور الانتظار فارغًا، يُعلَّق الخيط (thread) الذي استدعى التابع حتى تضاف بيانات إلى هذا الطابور. إذا مُرِّرت القيمة true إلى التابع، فلن يُعلَّق الخيط، وسيُرمى الاستثناء ThreadError آنذاك. البنية العامة pop(non_blocock=false) المعاملات non_block قيمة منطقية تحدِّد إن كان يراد تعليق عمل الخيط إن كان الطابور فارغًا أم لا. القيمة الافتراضية له هي: false. القيم المعادة تُعاد البيانات المجلوبة من الطابور المعطى. انظر أيضًا التابع push : يضيف الكائن المُمرَّر إليه ...

يضبط التابع const_set قيمة ثابت محدَّد إلى قيمة الكائن المعطى ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابت جديد ويسند إلى تلك القيمة. البنية العامة const_set(sym, obj) → obj const_set(str, obj) → obj‎ المعاملات sym‎ رمز يمثل الثابت. إذا لم يكن المعامل sym اسم ثابت صالح، فسيُطلق الخطأ NameError مع التحذير "wrong constant name". obj‎ الكائن المراد ضبط قيمته إلى الثابت. str‎ سلسلة نصية تمثل الثابتة. إذا لم يكن المعامل str‎ اسم ثابت صالح، فسيُطلق ...

يتحقق التابع owned?‎ إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. البنية العامة owned?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير ...

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

يعيد التابع each_line قيمة قابلة للعد (enumerator) تتكرر (iterates) عبر كل سطر (الذي يفصل بالفاصلة الممرَّرة) من كل ملف من الملفات الموجودة في ARGV. في حال تمرير كتلة برمجية للتابع each_line، فسيُمرّر كل سطر بدوره إلى تلك الكتلة، وإلا فستعاد قيمة قابلة للعد (enumerator). يسمح لك هذا التابع بمعالجة الملفات المُمرَّرة من سطر الأوامر كما لو كانت ملفًا واحدًا مكونًا من سلسلة من هذه الملفات المسماة. بعد إعادة السطر الأخير من الملف الأول، سيُعاد السطر الأول من الملف الثاني. يمكن ...

يُعدُّ التابع to_proc جزءًا من البروتوكول المستخدم في تحويل الكائنات إلى كائناتٍ من الصنف Proc. إن استدعي التابع مع نسخة من الصنف Proc، فسيعيد هذه النسخة نفسها ببساطة. البنية العامة to_proc → proc القيم المعادة يُعاد ناتج تحويل الكائن المعطى إلى كائنٍ من الصنف Proc. انظر أيضًا التابع hash: يحسب قيمة التجزئة الموافقة لجسم الكتلة proc التي استدعيت معه ثمَّ يعيدها. التابع ?lambda: يتحقَّق إذا كانت معالجة الوسائط صارمةً في الكائن Proc. المعامل ===: يستدعي الكتلة بتمرير الكائن الواقع على ...

يعيد التابع coerce‎ مصفوفة تضم القيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، وذلك عبر تحويل numeric إلى Bignum. سيُطلق الخطأ TypeError في حال لم يكن numeric المعطى من النوع Fixnum أو Bignum. البنية العامة coerce(numeric) → array‎ القيمة المعادة تعاد مصفوفة تضم قيمتين numeric و big ممثلتين على شكل كائن من الصنف Bignum، عبر تحويل numeric إلى Bignum. أمثلة مثال على استخدام التابع coerce‎: (0x3FFFFFFFFFFFFFFF+1).coerce(42) #=> [42, 4611686018427387904] ‎ انظر أيضا التابع chr: يعيد سلسلة نصية تحتوي على ...

يعيد التابع select‎ نسخة من البيئة (environment) تضم المدخلات التي حقَّقت شرطًا معيَّنًا. في حال عدم تمرير أي كتلة برمجية إلى التابع، فسيعيد كائنًا من النوع enumerator. البنية العامة select { |name, value| } → Hash select → Enumerator القيمة المعادة يُعاد كائن من النوع Hash يحوي نسخة من البيئة تضم المدخلات (entries) التي أعيدت القيمة true معها عند تمريرها إلى الكتلة البرمجية. وفي حال عدم تمرير أية كتلة برمجية، فسيُعاد كائن من النوع enumerator. انظر أيضًا التابع inspect: يعيد محتوى البيئة (environment) ...

يتحقّق التّابع ?to_tty فيما إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية tty. البنية العامة to_tty? → true or false القيم المعادة تُعاد القيمة true إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية tty، أو تُعاد القيمة false خلاف ذلك. انظر أيضا التابع to_s: يُعيد رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة). التابع full_message: يُعيد سلسلةً نصيةً منسّقةً من الاستثناء. مصادر صفحة التابع ?to_tty في الصنف Exception في توثيق روبي الرسمي.

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

يعدل التابع downcase!‎ على السلسلة النصية المعطاة وذلك باستبدال الحروف الكبيرة فيها بنظائرها الصغيرة. استبدال الحروف بحروف أخرى يعتمد على تحديد الخيارات المُمرَّرة إلى التابع وعلى ترميز السلسلة النصية المعطاة. البنية العامة downcase! → str or nil downcase!([options]) → str or nil المعاملات options الخيارات التي تتحكم في الترميز وعملية التحويل. انتقل إلى صفحة التابع downcase للاطلاع على شرح الخيارات الأربعة - ascii:، و turkic:، و lithuanian:، و fold: - التي يمكن استعمالها مع هذا المعامل. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد استبدال الحروف الكبيرة فيها بنظائرها ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يعيد التابع ‎real?‎ القيمة false دائمًا مع العدد العقدي. البنية العامة real? → false القيمة المعادة تعاد القيمة false دومًا. أمثلة أمثلة عن استخدام التابع ‎real?‎: Complex(1.0/3, 0).real?‎ #=> false Complex(1, 0.0).real?‎ # false Complex(1, 2).real?‎ # false انظر أيضًا التابع ‎finite?‎: يتحقق فيما إذا كانت القيمة المطلقة (الطويلة r) للشكل القطبي للعدد العقدي الذي استُدعي معه منتهية (finite).  التابع ‎infinite?‎: يعيد قيمة بحسب ما إذا كانت القيمة المطلقة (الطويلة r) للشكل القطبي للعدد العقدي منتهية أو غير ...

يُدخل التابع tap الكائن المعطى إلى الكتلة (block)، ثم يعيده. الهدف الأساسي من هذا التابع هو "التداخل في" سلسلة التوابع، بهدف تنفيذ عملياتٍ على النتائج الوسطية التي تنتج خلال تنفيذ السلسلة. البنية العامة tap {|x| block } → obj المعاملات x الكائن المراد إدخاله إلى الكتلة. block الكتلة المراد تنفيذها على الكائن. القيم المعادة يُعاد الكائن نفسه. أمثلة مثالٌ عن استخدام التابع tap: (1..10) ...

يُعيد التابع inspect سلسلة نصية تمثل التوقيت الذي استدعي معه. هذا التابع مكافئ لاستدعاء التابع strftime مع سلسلة التنسيق المناسبة. البنية العامة inspect → string‎ القيمة المعادة تعاد سلسلة نصية تمثل التوقيت المعطى. أمثلة مثال على استخدام التابع inspect: t = Time.now t.to_s => "2012-11-10 18:16:12 +0100" t.strftime "%Y-%m-%d %H:%M:%S %z" => "2012-11-10 ...

يتحقق التابع none?‎ من خلو كائن قابل للتعداد من أي عنصر محقِّق للكتلة المعطاة (لا تعيد مع أي عنصر القيمة true) أو مطابق للنمط محدَّد. البنية العامة none? [{ |obj| block }] → true or false none?(pattern) → true or false المعاملات pattern نمط يراد التحقق من عدم مطابقته لأي عنصر من عناصر الكائن القابل للتعداد المعطى. القيمة المعادة تعاد القيمة true إن لم تعيد الكتلة block القيمة true لجميع عناصر الكائن القابل للتعداد بعد تمرير كل واحد منها إليها، أو لم يتطابق ...

يحدِّد التابع srand بذرة مولد الأعداد شبه العشوائية (pseudo-random number generator) للنظام، بتعيين Random::DEFAULT، إلى القيمة المُمرَّرة إليه. يعيد التابع بعد استدعائه قيمة البذرة السابقة. في حال عدم أية قيمة إلى التابع srand، فسيبذُر المولد باستخدام مصدر للعشوائية (entropy) يوفره نظام التشغيل إن كان متاحًا (‎/dev/urandom على أنظمة Unix أو مُوفِّر خوارزمية التشفير [RSA] على نظام Windows)؛ تدمج هذه البذرة بين الوقت، ومعرف العملية (pid)، ورقم التسلسل لتوليدها من أجل أن تكون العشوائية كافية. يمكن استخدام srand لضمان تكرار تسلسلات ...

يُعيد التابع encoding كائنًا من النوع Encoding، والذي يمثل ترميز الكائن الذي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنٌ من النوع Encoding يمثِّل الترميز المستعمل. انظر أيضًا التابع casefold?‎: يعيد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). مصادر قسم التابع encoding‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

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

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

يحول التابع match?‎ النمط المُمرَّر إليه إلى تعبير نمطي (إن لم يكن كذلك) ثم يتحقق من مطابقته من السلسلة النصية التي استدعي معها دون تحديث قيمة المتغير ~$ والمتغيرات الأخرى المماثلة. البنية العامة match?(pattern) → true or false match?(pattern, pos) → true or false المعاملات pattern التعبير النمطي المراد مطابقته للسلسلة النصية المعطاة. إن يكن تعبيرًا نمطيًّا، فسيُحوَّل النمط المعطى إلى تعبير نمطي. pos إن أعطي هذا المعامل الاختياري، فسيُحدِّد موضع بدء عملية المطابقة في السلسلة النصية المعطاة. القيمة المعادة تعاد القيمة ...

يضبط التّابع set_backtrace معلومات المصفوفة backtrace الخاصة بكائن الاستثناء. مصفوفة التتبع العكسي (backtrace) يجب أن تتكون من عدة سلاسل نصية أو سلسلة نصية واحدة بالتنسيق الموصوف في التابع backtrace. البنية العامة set_backtrace(backtrace) → array المعاملات backtrace المحتوى الجديد لمصفوفة التتبع العكسي الذي يراد تعيينه. القيم المعادة تُعاد مصفوفة backtrace جديدة بعد ضبط محتواها إلى backtrace. انظر أيضا التابع backtrace: يُعيد أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء. التابع backtrace_locations: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء. مصادر صفحة التابع set_backtrace في ...

ينشئ التابع new الصنف Errno المناسب لرمز خطإٍ نظامي معروف إن كان رقم الخطأ المُمرَّر إليه يطابق رمز هذا خطأ، وإلا فسينشئ كائنًا عامًا من النوع SystemCallError. رقم الخطأ سيكون متاح لاحقًا عبر التابع errno. البنية العامة new(msg, errno) → system_call_error_subclass‎ المعاملات msg‎ رسالة الخطأ. errno‎ رقم الخطأ. القيمة المعادة يعاد كائنٌ جديد من النوع SystemCallError أو صنف متفرع منه. انظر أيضا التابع ===: يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ ...

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

يشبه التابع open التابع new تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن File) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة. البنية العامة open(filename, mode="r" [, opt]) → file open(filename [, mode [, perm]] [, opt]) → file open(filename, mode="r" [, opt]) {|file| block } → obj open(filename [, mode [, perm]] [, opt]) {|file| block } → obj عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. اطلع على صفحة التابع new ...

يقتطع التابع truncate الملف الذي استدعي معه إلى حجمٍ محدَّدٍ. يجب أن يكون هذا الملف مفتوحًا في وضع الكتابة. هذا التابع غير متوافر على جميع المنصات. البنية العامة truncate(integer) → 0 المعاملات integer عدد صحيح يمثِّل حجم الملف المراد اقتطاعه إليه. القيمة المعادة تعاد القيمة 0 عند اكتمال العملية. أمثلة مثال على استعمال التابع truncate: f = File.new("out", "w") f.syswrite("1234567890") #=> 10 f.truncate(5) #=> 0 f.close() ...

يعيد التابع pred‎ العدد السابق على العدد الذي استُدعي معه. أي يعيد القيمة int-1. البنية العامة pred → integer‎ القيمة المعادة يعاد العدد السابق على العدد الذي استُدعي معه. أمثلة مثال على استخدام التابع pred‎: 1.pred #=> 0 (-1).pred #=> -2 ‎ انظر أيضا التابع next: يعيد العدد الموالي للعدد الذي استُدعي معه. مصادر قسم التابع pred‎ في الصنف Integer‎ في توثيق روبي الرسمي.

يستخلص التابع year من التوقيت الذي استُدعي معه قيمة السنة (بما في ذلك القرن). البنية العامة year → integer‎ القيمة المعادة يعاد عدد صحيح يمثل السنة. أمثلة مثال على استخدام التابع year‎: t = Time.now #=> 2007-11-19 08:27:51 -0600 t.year #=> 2007‎ انظر أيضًا التابع wday: يُعيد عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي استدعي معه. التابع yday: يُعيد عددًا صحيحًا يمثل يومًا من السنة الحالية للتوقيت الذي استدعي معه. التابع sec: يستخلص ...

يُعيد التّابع full_message سلسلةً نصيةً منسّقةً من الاستثناء. تُنسّق السلسلة النصية المعادة بنفس التنسيق التي تستعمله روبي عند طبع الاستثناءات uncaught على مجرى الخطأ القياسي (stderr). البنية العامة full_message(highlight: bool, order: [:top or :bottom]) → string المعاملات highlight قيمة منطقية؛ إن كانت true، فسيُرسل معالج الخطأ الافتراضي رسالةً إلى الطرفية tty. القيمة الافتراضية لهذا المعامل تعتمد على ‎$stderr وعلى القيمة التي يعيدها التابع tty?‎ في وقت الاستدعاء. order يحدد كيفية ترتيب الناتج المعاد ويكون إما top: أو bottom:، وتوضع رسالة ...

يتحقق التابع locked?‎ إن كان هذا القفل مُطبَّق حاليًا من قبل خيط (thread) ما. البنية العامة locked? → true or false‎ القيمة المعادة تعاد القيمة true إن كان هذا القفل مُطبَّق حاليًا من قبل خيط (thread) ما، وإلا فستعاد القيمة false. انظر أيضا التابع lock: يحاول مسك القفل (grab the lock)، وينتظر إذا لم يكن متاحًا. التابع owned?‎: يتحقق إن كان هذا القفل مُطبَّق حاليًا من قبل الخيط (thread) الحالي. مصادر قسم التابع locked?‎ في الصنف Mutex‎ في توثيق روبي الرسمي.

يزيل التابع clear جميع الأزواج قيمة-مفتاح من الكائن Hash الذي استدعي معه. البنية العامة clear → hsh القيمة المعادة يعاد الكائن Hash المعطة نفسه بعد إزالة جميع الأزواج قيمة-مفتاح منه. أمثلة مثال على استعمال التابع clear: h = { "a" => 100, "b" => 200 } #=> {"a"=>100, "b"=>200} h.clear #=> {} انظر أيضا التابع compact!‎: ...

يعيد التابع values_at مصفوفةً تحتوي على القيم المرتبطة بمفاتيح محدَّدة من الكائن Hash الذي استدعي معه. البنية العامة values_at(key, ...) → array المعاملات key المفتاح المراد جلب القيمة المرتبطة به. ... المفاتيح الأخرى المراد جلب القيم المرتبطة بها. القيمة المعادة تعاد مصفوفةً تحتوي على القيم المرتبطة بالمفاتيح key و ... من الكائن Hash المعطى. أمثلة مثال على استعمال التابع values_at: h = { "cat" => "feline", "dog" => "canine", "cow" => "bovine" } h.values_at("cow", "cat") #=> ["bovine", "feline"] انظر أيضا التابع ...

يجلب التابع each_pair‎ الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة. في حال عدم تمرير كتلة برمجية إلى التابع، فسيُعيد كائنًا من النوع Enumerator. البنية العامة each_pair { |name, value| } → Hash each_pair → Enumerator القيمة المعادة يعاد كائن من النوع Hash بعد تمرير الزوج اسم/قيمة لكل متغير من متغيرات البيئة إلى الكتلة المعطاة على حدة، أو يعاد كائن من النوع Enumerator في حال عدم تمرير أي كتلة برمجية. انظر أيضًا التابع each‎: يجلب أسماء ...

يعيد التابع external_encoding الترميز الخارجي (external encoding) للملفات المقروءة من ARGF على شكل كائن من النوع Encoding. الترميز الخارجي هو الترميز الذي كُتِب به النص وخُزِّن في الملف. إن وازنَّا هذا التابع مع التابع ARGF.internal_encoding، نجد أنَّ الأخير يعيد الترميز المستخدم لتمثيل هذا النص ضمن روبي. لضبط الترميز الخارجي، استخدم التابع ARGF.set_encoding. البنية العامة external_encoding → encoding القيم المعادة يعاد كائن من النوع Encoding يمثِّل الترميز الخارجي المستعمل في كتابة محتوى الملف المقروء من المجرى ARGF. أمثلة مثال على ...