نتائج البحث

يجلب التابع getbyte بايتًا واحدًا (8 بتّات) من المجرى ARGF. البنية العامة getbyte → Integer or nil القيم المعادة يعاد عدد صحيح يترواح بين 0 إلى 255 يمثِّل بايتًا واحدًا قُرِأ من المجرى ARGF، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى. أمثلة مثالٌ على استخدام التابع getbyte: $ echo "foo" > file $ ruby argf.rb file ARGF.getbyte #=> 102 ARGF.getbyte #=> 111 ARGF.getbyte #=> 111 ARGF.getbyte #=> 10 ARGF.getbyte #=> nil انظر أيضًا التابع getc: يجلب المحرف التالي من المجرى ARGF. التابع gets: يجلب ...

يقرأ التابع readbyte البايت التالي من المجرى ARGF ثمَّ يعيده على شكل عدد صحيح (Integer). يطلق التابع الخطأ EOFError بعد قراءة البايت الأخير من الملف الأخير. البنية العامة readbyte → Integer القيم المعادة يعاد عدد صحيح يمثل قيمة البايت الذي قُرِأ من المجرى ARGF. أمثلة أمثلة لاستخدام التابع readbyte: $ echo "foo" > file $ ruby argf.rb file ARGF.readbyte #=> 102 ARGF.readbyte #=> 111 ARGF.readbyte #=> 111 ARGF.readbyte #=> 10 ARGF.readbyte #=> end of file reached (EOFError) انظر أيضًا التابع getbyte: ...

ينتظر التابع wait خروج العملية الابن ثم يعيد مُعرِّفها ويضبط ?$ إلى قيمة الكائن Process::Status الذي يحوي معلومات حول تلك العملية. العملية التي ينتظرها التابع wait يعتمد على مُعرِّف العملية pid المُمرَّر إليه. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. هذا التابع غير متاح على جميع المنصات. البنية العامة wait() → integer click to toggle source wait(pid=-1, flags=0) → integer waitpid(pid=-1, flags=0) → integer المعاملات pid مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية: ...

يُمرر التابع each_codepoint كل عدد من الأعداد الترتيبية (Integers ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) المقابلة لكل محرف من محارف السلسلة النصية المعطاة إلى الكتلة المرتبطة به ثم يعيد الناتج الذي تعيده هذه الكتلة. إذا كان ترميز السلسلة غير الترميزات التالية: UTF-8، أو (UTF-16(BE|LE، أو (UTF-32(BE|LE، فإن القيم تُؤخذ مباشرةً من الترميز الثنائي لكل محرف. في حال عدم وجود كتلة، فسيعيد التابع كائنًا من النوع enumerator. البنية العامة each_codepoint {|integer| block } ...

يبدِّل التابع switch بين معرِّفي المجموعة الفعَّال والحقيقي للعمليَّة الحاليَّة. إذا مُرِّرت كتلةٌ إلى التابع، فسيعاد تبديل معرِّف المجموعة إلى ما كان عليه بعد أن تُنفَّذ هذه الكتلة. البنية العامة Process::GID.switch → integer Process::GID.switch {|| block} → object المعاملات || المعاملات المُمرَّرة للكتلة block. block الكتلة المراد تنفيذها. القيم المعادة يُعاد عددٌ صحيحٌ (integer) يمثِّل معرِّف المجموعة الفعال الجديد إذا استُدعي التابع من دون تمرير الكتلة block؛ خلاف ذلك، تُعاد قيمة الكتلة block المُعطاة. انظر أيضًا التابع re_exchange: يُبدِّل معرِّفي المجموعة ...

يبدِّل التابع switch بين معرِّفي المجموعة الفعَّال والحقيقي للعمليَّة الحاليَّة. إذا مُرِّرت كتلةٌ إلى التابع، فسيعاد تبديل معرِّف المجموعة إلى ما كان عليه بعد أن تُنفَّذ هذه الكتلة. البنية العامة Process::GID.switch → integer Process::GID.switch {|| block} → object المعاملات || المعاملات المُمرَّرة للكتلة block. block الكتلة المراد تنفيذها. القيم المعادة يُعاد عددٌ صحيحٌ (integer) يمثِّل معرِّف المجموعة الفعال الجديد إذا استُدعي التابع من دون تمرير الكتلة block؛ خلاف ذلك، تُعاد قيمة الكتلة block المُعطاة. انظر أيضًا التابع re_exchange: يُبدِّل معرِّفي المجموعة ...

تستعمل الوحدة Process للتعامل والتحكم بجميع العمليات في روبي. الثوابت CLOCK_BOOTTIME اطلع على توثيق التابع clock_gettime. CLOCK_BOOTTIME_ALARM اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_COARSE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_FAST اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_PRECISE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW_APPROX اطلع على توثيق التابع clock_gettime. CLOCK_PROCESS_CPUTIME_ID اطلع على توثيق التابع clock_gettime. CLOCK_PROF اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME_ALARM اطلع على توثيق ...

يبحث التابع index عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه. في حال عدم العثور على أي تطابق، فسيعيد التابع القيمة nil. يمكن تحديد موضع بدء البحث في السلسلة النصية المعطاة عبر تمرير فهرس المحرف الذي يراد بدء البحث عنه. البنية العامة index(substring [, offset]) → integer or nil index(regexp [, offset]) → integer or nil المعاملات substring السلسلة المُراد البحث عنها ضمن السلسلة النصية المُعطاة. regexp التعبير النمطي المُراد البحث ...

يحرِّك التابع seek مؤشر المجرى الذي استدعي معه إلى موضع محدَّد. البنية العامة seek(amount, whence=IO::SEEK_SET) → 0‎ المعاملات amount‎ عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل whence‎) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل whence‎. whence‎ راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار amount. القيم التي يمكن استعمالها مع هذا المعامل موضحة بالجدول التالي: المعامل whence شرح ‎:CUR أو IO::SEEK_CUR يحرَّك المؤشر بمقدار amount + موضع ...

ينشئ التابع fork عملية فرعية. إن أعطيت كتلةٌ، فستُنفَّذ هذه الكتلة في العملية الفرعية ثم تُنهَى العملية الفرعية مع حالة خروج تساوي إلى الصفر. خلاف ذلك، يعيد استدعاء التابع fork قيمتين، الأولى يعيدها في العملية الأب وهي مُعرِّف العملية الأبن، والثانية في العملية الابن وهي القيمة nil. تستطيع العملية الابن الخروج باستعمال التابع !Kernel.exit لتجنب تنفيذ أي دالة خروج مرتبطة عبر التابع at_exit. يجب أن تستعمل العملية الأب التابع Process.wait لجمع حالات الإنهاء (termination statuses) لعملياتهم الأبناء أو أن تستعمل Process.detach ...

يبدِّل التابع switch بين معرِّفي المستخدم الفعَّال والحقيقي للعمليَّة الحاليَّة. إذا مُرِّرت كتلةٌ إلى التابع، فسيعاد تبديل معرِّف المستخدم إلى ما كان عليه بعد أن تُنفَّذ هذه الكتلة. البنية العامة Process::UID.switch → integer Process::UID.switch {|| block} → object المعاملات || المعاملات المُمرَّرة للكتلة block. block الكتلة المراد تنفيذها. القيم المعادة يُعاد عددٌ صحيحٌ (integer) يمثِّل معرِّف المستخدم الفعال الجديد إذا استُدعي التابع من دون تمرير الكتلة block؛ خلاف ذلك، تُعاد قيمة الكتلة block المُعطاة. انظر أيضًا التابع re_exchange: يُبدِّل معرِّفي المستخدم ...

يبدِّل التابع switch بين معرِّفي المستخدم الفعَّال والحقيقي للعمليَّة الحاليَّة. إذا مُرِّرت كتلةٌ إلى التابع، فسيعاد تبديل معرِّف المستخدم إلى ما كان عليه بعد أن تُنفَّذ هذه الكتلة. البنية العامة Process::UID.switch → integer Process::UID.switch {|| block} → object المعاملات || المعاملات المُمرَّرة للكتلة block. block الكتلة المراد تنفيذها. القيم المعادة يُعاد عددٌ صحيحٌ (integer) يمثِّل معرِّف المستخدم الفعال الجديد إذا استُدعي التابع من دون تمرير الكتلة block؛ خلاف ذلك، تُعاد قيمة الكتلة block المُعطاة. انظر أيضًا التابع re_exchange: يُبدِّل معرِّفي المستخدم ...

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

يُعيد التابع to_i بِتَّات حالة العمليَّة stat على شكل عددٍ صحيح. البحث في وجلب معلوماتٍ من هذه البِتَّات يعتمد على المنصَّة. البنية العامة to_i → integer to_int → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل بِتَّات حالة العمليَّة stat. أمثلة مثالٌ عن استخدام التابع to_i: fork { exit 0xab } #=> 26566 Process.wait #=> 26566 sprintf('%04x', $?.to_i) #=> "ab00" ...

يُعيد التابع to_i بِتَّات حالة العمليَّة stat على شكل عددٍ صحيح. البحث في وجلب معلوماتٍ من هذه البِتَّات يعتمد على المنصَّة. البنية العامة to_i → integer to_int → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل بِتَّات حالة العمليَّة stat. أمثلة مثالٌ عن استخدام التابع to_i: fork { exit 0xab } #=> 26566 Process.wait #=> 26566 sprintf('%04x', $?.to_i) #=> "ab00" ...

يعيد التابع Rational ناتج العملية x/y إن مُرر عددين إليه أو عدد جذري (Rational) إن مُرِّر معامل وحيد فقط. قواعد الصياغة النصية: string form = extra spaces , rational , extra spaces ; rational = [ sign ] , unsigned rational ; unsigned rational = numerator | numerator , "/" , denominator ; numerator = integer part | fractional part | integer part , fractional part ; denominator = digits ; integer part = digits ; fractional part = "." , digits , [ ( "e" ...

يضبط التابع grant_privilege معرِّف المجموعة الفعال (effective group ID) و مُعرِّف المجموعة المحفوظ، إذا أمكن، للعمليَّة إلى المجموعة المعطاة. يُعيد التابع معرِّف المجموعة الفعال الجديد بعد ضبطه. هذا التابع غير متاحٍ على جميع المنصَّات. البنية العامة Process::GID.grant_privilege(group) → integer Process::GID.eid = group → integer المعاملات group المجموعة المراد ضبط معرِّفها الفعال. القيم المعادة يُعاد معرِّف المجموعة الفعال الجديد بعد تعيينه. أمثلة مثالٌ عن استخدام التابع grant_privilege: [Process.gid, Process.egid] #=> [0, 0] Process::GID.grant_privilege(31) ...

يضبط التابع grant_privilege معرِّف المستخدم الفعال (effective user ID) و مُعرِّف المستخدم المحفوظ، إذا أمكن، للعمليَّة إلى المستخدم المعطى. يُعيد التابع معرِّف المستخدم الفعال الجديد بعد ضبطه. هذا التابع غير متاحٍ على جميع المنصَّات. البنية العامة Process::UID.grant_privilege(user) → integer Process::UID.eid= user → integer المعاملات user المستخدم المراد ضبط معرِّفه الفعال. القيم المعادة يُعاد معرِّف المستخدم الفعال الجديد بعد تعيينه. أمثلة مثالٌ عن استخدام التابع grant_privilege: [Process.uid, Process.euid] #=> [0, 0] Process::UID.grant_privilege(31) ...

يضبط التابع grant_privilege معرِّف المجموعة الفعال (effective group ID) و مُعرِّف المجموعة المحفوظ، إذا أمكن، للعمليَّة إلى المجموعة المعطاة. يُعيد التابع معرِّف المجموعة الفعال الجديد بعد ضبطه. هذا التابع غير متاحٍ على جميع المنصَّات. البنية العامة Process::GID.grant_privilege(group) → integer Process::GID.eid = group → integer المعاملات group المجموعة المراد ضبط معرِّفها الفعال. القيم المعادة يُعاد معرِّف المجموعة الفعال الجديد بعد تعيينه. أمثلة مثالٌ عن استخدام التابع grant_privilege: [Process.gid, Process.egid] #=> [0, 0] Process::GID.grant_privilege(31) ...

يضبط التابع grant_privilege معرِّف المستخدم الفعال (effective user ID) و مُعرِّف المستخدم المحفوظ، إذا أمكن، للعمليَّة إلى المستخدم المعطى. يُعيد التابع معرِّف المستخدم الفعال الجديد بعد ضبطه. هذا التابع غير متاحٍ على جميع المنصَّات. البنية العامة Process::UID.grant_privilege(user) → integer Process::UID.eid= user → integer المعاملات user المستخدم المراد ضبط معرِّفه الفعال. القيم المعادة يُعاد معرِّف المستخدم الفعال الجديد بعد تعيينه. أمثلة مثالٌ عن استخدام التابع grant_privilege: [Process.uid, Process.euid] #=> [0, 0] Process::UID.grant_privilege(31) ...

يعيد التابع size حجم الملف المحدَّد. البنية العامة size(file_name) → integer المعاملات file_name اسم الملف المراد معرفة حجمه. القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف file_name. انظر أيضًا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف FileTest في توثيق روبي الرسمي.

يعيد التابع size حجم الملف المحدَّد. البنية العامة size(file_name) → integer المعاملات file_name اسم الملف المراد معرفة حجمه. القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف file_name. انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

يُنشئ التّابع new:: كائنًا جديدًا من الصنف Encoding::Converter. التّرميز المصدر والتّرميز الوجهة يجب أن يكونا إما سلسلةً نصّيةً أو كائنًا من الصّنف Encoding. يقبل التّابع new:: اختياريًّا أن يمرر إليه خيارٌ من النوع hash أو integer. عندما يكون من النوع hash، فمن الممكن أن يحتوي على ‎:invalid => nil وغيرها. وعندما يكون من النوع integer، فإنه يجب أن يكون منطقيًّا (logical)، أو أحد الثوابت المعرَّفة مثل Encoding::Converter::INVALID_REPLACE وغيرها. تكون بنية الخيار الممرر إلى التابع عندما يكون من النوع hash بالشكل: ...

يحول التابع Float الوسيط المعطى إلى عدد عشري (Float). البنية العامة Float(p1) القيمة المعادة يعيد التابع Float عددا عشريا (Float). أمثلة مثال على استخدام التابع Float: Float(1239); #=> 1239.0 Float("12.39"); #=> 12.39 Float(25/6); #=> 4.0 انظر أيضًا التابع Integer: يحول الوسيط المعطى إلى عدد صحيح (Integer). مصادر قسم التابع Float في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع size حجم الملف الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف المعطى. أمثلة مثال على استعمال التابع size: File.new("testfile").size #=> 66 انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

ينقل التابع pos عند استدعائه بالشكل pos = position المؤشِّر إلى المكان position (المعطى بالبايت) في المجرى ARGF. البنية العامة pos = position → Integer القيمة المعادة يعاد عددٌ صحيحٌ (integer) يمثِّل الموضع position الذي انتقل إليه الموشِّر في المجرى ARGF. أمثلة مثالٌ على استخدام التعبير pos = position: ARGF.pos = 17 ARGF.gets #=> "This is line two\n" انظر أيضًا التابع pos: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى ARGF. التابع fileno: يعيد عددًا صحيحًا يمثل واصف ...

يعيد التابع malloc_allocated_size حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. ويتوفر هذا التابع فقط إذا بُنيت روبي مع CALC_EXACT_MALLOC_SIZE. البنية العامة malloc_allocated_size → Integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. انظر أيضا التابع malloc_allocations: يعيد عدد عمليات الحجز التي أجريت باستعمال malloc()‎. مصادر قسم التابع malloc_allocated_size‎ في الصنف GC في توثيق روبي الرسمي.

يعيد التابع malloc_allocations عدد عمليات الحجز التي أجريت باستعمال malloc()‎. ويتوفر هذا التابع فقط إذا بُنيت روبي مع CALC_EXACT_MALLOC_SIZE. البنية العامة malloc_allocations → Integer القيمة المعادة يعاد عدد صحيح يمثِّل عمليات الحجز التي أجريت باستعمال malloc()‎. انظر أيضا التابع malloc_allocated_size: يعيد حجم الذاكرة التي حُجزَت من قِبَل malloc()‎. مصادر قسم التابع malloc_allocations‎ في الصنف GC في توثيق روبي الرسمي.

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

ينشئ التابع at توقيتًا جديدًا انطلاقًا من معلومات الوقت المٌمرَّرة إليه. البنية العامة at(time) → time at(seconds_with_frac) → time at(seconds, microseconds_with_frac) → time at(seconds, milliseconds, :millisecond) → time at(seconds, microseconds, :usec) → time at(seconds, microseconds, :microsecond) → time at(seconds, nanoseconds, :nsec) → time at(seconds, nanoseconds, :nanosecond) → time‎ ينشئ التابع at توقيتًا جديدًا انطلاقًا من الوقت time المعطى، أو عدد الثواني مع الأجزاء seconds_with_frac، أو عدد الثواني seconds والأجزاء microseconds_with_frac التي مرت منذ بدء توقيت يونيكس. تتيح ميزة عدم قابلية النقل (non-portable) أن يكون الموضع (offset) سالبًا في بعض الأنظمة. ...

يعيد التابع stress الحالة الحالية لوضع الضغط الذي يخص جامع البيات المهملة GC. البنية العامة stress → integer, true or false القيمة المعادة تعاد الحالة الحالية لوضع الضغط الذي يخص جامع البيات المهملة GC. انظر أيضا التابع stress: يحدِّث عند استدعائه بالشكل stress = flag وضع الضغط الذي يخص جامع البيانات المهملة GC. مصادر قسم التابع stress‎ في الصنف GC في توثيق روبي الرسمي.

يحسب التابع hash الشيفرة hash للكائن Hash المستدعى معها. الكائنان Hash اللذان لهما نفس المحتوى يكون لهما نفس الشيفرة hash (وسيقارن بينهما باستخدام eql?‎). البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash للكائن Hash المعطى. انظر أيضا التابع Object.hash: يحسب الشيفرة hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Hash في توثيق روبي الرسمي.

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

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

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

يستدعي to_int التابع to_i الخاص بالصنف الفرعي (child class) لتحويل العدد الذي استُدعي معه إلى عدد صحيح. البنية العامة to_int → integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل ناتج تحول العدد المعطى إليه. أمثلة مثال على استخدام التابع to_int‎: 1.0.class #=> Float 1.0.to_int.class #=> Integer 1.0.to_i.class #=> Integer‎ انظر أيضا التابع to_c: يحول العدد الذي استُدعي معه إلى عدد عقدي. مصادر قسم التابع to_int‎ في الصنف ...

يعيد التابع hash القيمة Hash للمصفوفة التي استُدعيت معه. إن كان لمصفوفتين نفس المحتوى، فسيكون لهما نفس قيمة Hash (وسيوازن بينهما باستخدام eql?‎). البنية العامة hash → integer القيم المعادة يعاد عدد صحيح يمثل القيمة Hash للمصفوفة المعطاة. أمثلة مثالٌ على استخدام التابع hash: a = [ "a", "b", "c" ] a.hash # 2564204468492460516 انظر أيضًا التابع Object.hash: يعيد شيفرة Hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Array في توثيق روبي الرسمي.

يعيد التابع numerator‎ البسط للعد الكسري الذي استدعي معه. البنية العامة numerator → integer القيمة المعادة يعاد عدد عشري يمثِّل البسط للعدد الكسري المعطى. تعتمد النتيجة المعادة على المنصة المستعملة. أمثلة مثال على استعمال التابع numerator‎: n = 0.3.numerator #=> 5404319552844595 d = 0.3.denominator #=> 18014398509481984 n.fdiv(d) #=> 0.3 انظر أيضا التابع denominator: يعيد المقام (denominator) للعدد الكسري الذي استدعي معه. مصادر قسم التابع numerator‎ في الصنف Float ...

يعيد التابع Complex ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. قواعد الصياغة النصية هي: string form = extra spaces , complex , extra spaces ; complex = real part | [ sign ] , imaginary part | real part , sign , imaginary part | rational , "@" , rational ; real part = rational ; imaginary part = imaginary unit | ...

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

يعيد التابع hash القيمة hash (قيمة عددية مختصرة) بناءً على طول، ومحتوى، وترميز السلسلة النصية التي استدعي معها. البنية العامة hash → integer القيمة المعادة يعاد عدد صحيح يمثِّل القيمة hash المحسوبة للسلسلة النصية المعطاة (يؤخذ الطول والمحتوى والترميز بالحسبان). انظر أيضًا التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. التابع codepoints: يُعيد نقاط الترميز المقابلة لمحارف السلسلة النصية في مصفوفة. مصادر قسم التابع hash‎ في الصنف String في توثيق روبي الرسمي.

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

يعيد التابع size عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل عدد الأزواج القيمة-المفتاح الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع size: h = { "d" => 100, "a" => 200, "v" => 300, "e" => 400 } h.length #=> 4 h.delete("a") #=> 200 h.length #=> 3 انظر أيضا التابع length: يعيد ...

يؤسس التابع setsid العملية الحالية على أنَّها جلسة جديدة وقائدة جديدة للمجموعة المالكة للعملية دون التحكم بالطرفية tty. هذا التابع غير متاح على جميع المنصات. البنية العامة setsid → integer القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف الجلسة الحالية. أمثلة مثال على استعمال التابع setsid: Process.setsid #=> 27422 انظر أيضًا التابع getsid: يعيد مُعرِّف الجلسة (session ID) للعملية الحالية أو عملية محدَّدة. التابع setrlimit: يضبط قيد المورد (resource limit) للعملية.  مصادر قسم التابع setsid في الصنف Process في توثيق روبي ...

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

يعيد التابع ‎__id__‎‎ (يدعى أيضًا object_id) مُعرِّفا عدديًا للكائن الذي استُدعي معه. سيُعاد نفس المعرِّف في كل مرة يُستدعى فيها التابع object_id مع الكائن نفسه، ولن يتشارك أي كائنين نشطين نفس المعرِّف. ملاحظة: يعاد استخدام بعض كائنات الأصناف المٌضمّنة (builtin classes) وذلك لتحسين الأداء. هذا هو الحال بالنسبة للقيم المباشرة (immediate values) والسلاسل النصية الحرفية المجمدة (frozen string literals). لا تُمرَّر القيم المباشرة بالمرجع (reference) ولكنَّها تُمرَّر بالقيمة، مثل nil، و true، و false، و Fixnums، و Symbols، و Floats. ...

يعيد التابع source_location اسم الملف المصدر لروبي ورقم السطر الذي يحتوي هذا التابع الحر، أو يعيد nil إن لم يُعرّف هذا التابع في روبي (أي أنه أصلي). البنية العامة source_location → [String, Integer]‎ القيمة المعادة تعاد مصفوفة من عنصرين تحوي اسم الملف المصدر لروبي ورقم السطر الذي يحتوي التابع الحر المعطى، أو تعاد القيمة nil إن لم يُعرّف هذا التابع في روبي. انظر أيضًا التابع parameters: يعيد معلومات عن معاملات التابع الحر الذي استُدعي معه. التابع super_method: يعيد كائنا من النوع Method ...

يعيد التابع to_i‎ العدد الصحيح الذي استُدعي معه دون تغيير. هذا التابع يشبه to_int. البنية العامة to_i → integer to_int → integer‎ القيمة المعادة يعاد العدد الصحيح المعطى دون تغيير. انظر أيضا التابع to_s: يحول العدد الصحيح الذي استدعي معه إلى سلسلة نصية ممثلًا بأساس محدَّد.  التابع to_int: يعيد العدد الذي استُدعي معه دون تغيير. التابع to_r: يحول العدد الذي استُدعي معه إلى عدد جذري (rational). التابع to_f: يحول العدد الصحيح الذي استُدعي معه إلى عدد عشري. مصادر قسم ...

يعيد التابع source_location اسم الملف المصدر لروبي ورقم السطر الذي يحتوي للتابع Method الذي استدعي معه، أو يعيد القيمة nil إن لم يُعرّف هذا التابع في روبي (أي أنه أصلي). البنية العامة source_location → [String, Integer]‎ القيمة المعادة يعاد اسم الملف المصدر لروبي ورقم السطر الذي يحتوي للتابع Method المعطى، أو تعاد القيمة nil إن لم يُعرّف هذا التابع في روبي. انظر أيضا التابع receiver: يعيد المستقبل المتلقي (bound receiver) لكائن Method. التابع super_method: يعيد كائنًا من النوع Method للصنف الأب (superclass)، ...

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

يتحقق التابع size?‎ إن كان ملفٌ ما غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size?(file_name) → Integer or nil المعاملات file_name اسم الملف المراد التحقق من حجمه. القيمة المعادة تعاد القيمة nil إن كان الملف file_name غير موجود أو كان معدوم الحجم. خلا ذلك، يعاد عدد صحيح يمثِّل حجم ذلك الملف. انظر أيضا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع exist?‎: يتحقق إن كان ملفٌ ما ...

يعيد التابع tell الموضع الحالي في المجلد الذي استٌدعي معه. انظر أيضًا التابع seek. البنية العامة tell → integer القيمة المعادة يعيد التابع tell الموضع الحالي في المجلد المعطى. أمثلة مثال عن استخدام التابع tell على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") d.tell #=> 0 d.read #=> "." d.tell #=> 12 انظر أيضًا التابع pos‎: يحدِّد عند استدعائه بالشكل pos = integer‎ موضع المؤشر الحالي في المجلد.  التابع seek: يذهب إلى موضع ...

يتحقق التابع size?‎ إن كان ملفٌ ما غير موجود أو معدوم الحجم. إن كان الملف موجودًا وله حجم ما، فسيعيد التابع حجم هذا الملف. البنية العامة size?(file_name) → Integer or nil المعاملات file_name اسم الملف المراد التحقق من حجمه. القيمة المعادة تعاد القيمة nil إن كان الملف file_name غير موجود أو كان معدوم الحجم. خلا ذلك، يعاد عدد صحيح يمثِّل حجم ذلك الملف. انظر أيضًا التابع file?‎: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع exist?‎: يتحقق إن كان ملفٌ ما موجودًا. التابع size: يعيد حجم الملف ...

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

يعيد التابع class صنف الكائن المعطى. يجب أن يُستدعى هذا التابع دائمًا مع مستقبل (receiver) صريح، إذ أنَّ class هي كلمةٌ محجوزةٌ في روبي. البنية العامة class → class القيم المعادة يعاد صنف الكائن المعطى المراد معرفة صنفه. أمثلة مثالٌ عن استخدام التابع class: 1.class #=> Integer self.class #=> Object انظر أيضًا التابع clone: يُنتج نسخةً سطحيةً من الكائن المعطى. التابع dup: ينتج نسخةً سطحية من الكائن. التابع tap: يُدخل الكائن المعطى إلى الكتلة ...

يعيد التابع bytesize طول السلسلة النصية التي استدعيت معه بالبايت. البنية العامة bytesize → integer القيمة المعادة يعاد عدد صحيح يمثل طول السلسلة النصية المُستدعاة بالبايت. أمثلة مثال على استخدام التابع bytesize: "\x80\u3042".bytesize #=> 4 "hello".bytesize #=> 5 انظر أيضًا التابع bytes: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. التابع byteslice: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. التابع ...

يعيد التابع pos موضع المؤشر الحالي في المجلد الذي استٌدعي معه. البنية العامة pos → integer القيمة المعادة يعاد عدد صحيح يشير إلى الموضع الحالي في المجلد المعطى. أمثلة مثال عن استخدام التابع pos على المجلد testdir الذي يحوي ملفين عاديين (config.h و main.rb)، والمجلد الأب (..)، والمجلد نفسه (.): d = Dir.new("testdir") d.tell #=> 0 d.read #=> "." d.tell #=> 12 انظر أيضًا التعبير pos =‎: التعبير pos =‎ هو مرادف للتابع seek. بيد أنّه يعيد معامل الموضع (position parameter). التابع seek: يذهب إلى موضع محدد ...

يعيد التابع div‎ ناتج عملية قسمة العدد الذي استدعي معه على العدد الذي مُرِّر إليه. البنية العامة div(numeric) → integer المعاملات numeric عدد صحيح يمثل الطرف الثاني للعملية. القيمة المعادة يعاد عدد صحيح يمثل ناتج عملية قسمة العدد int المعطى على العدد numeric. أمثلة مثال على استخدام المعامل div‎: 25.div(4) #=> 6 20.div(7) #=> 2 انظر أيضا المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: يعيد ناتج عملية الجمع بين عددين. ...

يعيد التابع ppid معرِّف العملية الأب للعملية الحالية. هذا التابع غير متوافر على جميع المنصات. البنية العامة ppid → integer القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف العملية الأب للعملية الحالية. ملاحظة: القيمة المعادة على أنظمة Win32/64 غير جديرة بالثقة. أمثلة مثال على استعمال التابع ppid: puts "I am #{Process.pid}" Process.fork { puts "Dad is #{Process.ppid}" } ناتج تنفيذ هذا المثال هو: I am 27417 Dad is 27417 انظر أيضًا التابع getsid: يعيد مُعرِّف الجلسة (session ID) للعملية الحالية أو عملية محدَّدة. التابع pid: ...

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

يعيد التابع length عدد الأزواج قيمة-مفتاح الموجودة في الكائن Hash الذي استدعي معه. البنية العامة length → integer القيمة المعادة تعاد عدد صحيح يمثِّل عدد الأزواج قيمة-مفتاح الموجودة في الكائن Hash المعطى. أمثلة مثال على استعمال التابع length: h = { "d" => 100, "a" => 200, "v" => 300, "e" => 400 } h.length #=> 4 h.delete("a") #=> 200 h.length #=> 3 انظر أيضا التابع keys: يعيد ...

الصنف Numeric هو الصنف الذي يجب أن ترثه كل الأصناف العددية عالية المستوى. يسمح الصنف Numeric بتمثيل (instantiation) الكائنات المحجوزة في الكومة (heap-allocated objects). تُنفَّذ الأصناف العددية الأساسية الأخرى، مثل Integer، كأصناف آنيَّة، أي أنّ كل عدد صحيح هو كائن غير قابل للتغيير (immutable)، والذي يُمرَّر دائمًا بقيمته. اطلع على المثال التالي: a = 1 1.object_id == a.object_id #=> true لا يمكن أن يكون هناك إلا نسخة (instance) واحدة فقط من العدد الصحيح 1. تضمن روبي بهذا منع إنشاء نسخ ...

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

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

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

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

يعيد التابع getpgid مُعرِّف المجموعة المالكة لعملية محدَّدة. هذا التابع غير متوافر على جميع المنصات. البنية العامة getpgid(pid) → integer المعاملات pid مُعرِّف العملية المراد معرفة مُعرِّف المجموعة المالكة لها. القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف المجموعة المالكة للعملة ذات المُعرِّف pid. أمثلة مثال على استعمال التابع getpgid: Process.getpgid(Process.ppid()) #=> 25527 انظر أيضًا التابع egid: يعيد مُعرِّف المجموعة الفعال (effective group ID) المالكة لهذه العملية. التابع getpgrp: يعيد مُعرِّف المجموعة المالكة للعملية الحالية. التابع gid: يعيد المُعرِّف الحقيقي ...

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

يُعيد التابع singleton_class صنف الكائن المُنفرد (singleton class) للكائن الذي استدعي معه. يُنشئ هذا التابع صنفًا منفردًا جديدًا إذا كان هذا الكائن لا يملك واحدًا. البنية العامة singleton_class → class القيم المعادة إذا كان الكائن المعطى هو nil، أو true، أو false، فسيُعاد الصنف NilClass، أو TrueClass، أو FalseClass على التوالي. إذا كان الكائن عددًا صحيحًا (integer)، أو عشريًا (Float)، أو رمزًا (Symbol)، فسيُرمَى الاستثناء TypeError. أمثلة مثالٌ عن استخدام التابع singleton_class: Object.new.singleton_class #=> #<Class:#<Object:0xb7ce1e24>> String.singleton_class ...

يتعامل التابع oct مع بادئة السلسلة النصية المعطاة كسلسلة من الأرقام الثمانية (والتي قد تبدأ بإشارة الرقم الاختيارية)، ومن ثم يُعيد الرقم المُقابل لها. يعيد التابع الرقم 0 إذا فشلت عملية التحويل. البنية العامة oct → integer القيمة المعادة يُعاد الرقم المقابل لبادئة السلسلة النصية المعطاة باعتبارها سلسلة من الأرقام الثمانية. أمثلة مثال على استعمال التابع oct: "123".oct #=> 83 "-377".oct #=> -255 "bad".oct #=> ...

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

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

يعيد التابع sum المجموع التحقُّقي (checksum) ذي الحجم n بت لحروف السلسلة النصية التي استدعيت معه؛ هذا المجموع عبارة عن مجموع القيم الثنائية لكل بايت من بايتات السلسلة وفق المقياس: 1 - n**2، حيث يمكن تغيير قيمة n التي تأخذ افتراضيًا القيمة 16. البنية العامة sum(n=16) → integer المعاملات n عدد صحيح يمثل قيمة n في المقياس 1- 2**n المستعمل في حساب المجموع التحقُّقي، ويأخذ افتراضيًا القيمة 16. القيمة المعادة يُعاد المجموع التحقُّقي لمحارف السلسلة النصية المعطاة. انظر أيضًا التابع ...

يكتب التابع write السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا. البنية العامة write(string) → integer القيم المعادة يعاد عدد صحيح يمثل عدد البايتات التي كتبت على المجرى ARGF. انظر أيضًا التابع to_write_io:يعيد نسخةً من الصنف IO مرتبطةً بالمجرى ARGF للكتابة عليها في حال كان الوضع inplace مفعَّلًا. التابع read: يقرأ عددًا محددًا من البايتات من المجرى ARGF. التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF. التابع puts: يكتب الكائن أو ...

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

يحول التابع to_i‎ العدد العشري الذي استُدعي معه إلى عدد صحيح. هذا التابع مماثل للتابع to_int. البنية العامة to_i → integer القيمة المعادة يعاد العدد الصحيح الذي يمثِّل ناتج تحويل العدد العشري المعطى. أمثلة مثال على استعمال التابع to_i‎: 1.2.to_i #=> 1 (-1.2).to_i #=> -1 يُلاحظ أن الدقة المحدودة للعمليات الحسابية التي تجرى على الأعداد العشرية قد تؤدي إلى نتائج مُدهشة: (0.3 / 0.1).to_i #=> 2 (!) انظر أيضا التابع to_s: ...

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

يعيد التابع seed قيمة البذرة التي استُخدمَت في إنشاء المولِّد. قد يُستعمَل هذا التابع لإنشاء مولِّدٍ آخر بنفس الحالة في وقتٍ لاحق، مسببًا بذلك توليد نفس السلسلة من الأعداد. البنية العامة seed → integer القيم المعادة يُعاد عددٌ صحيحٌ يمثِّل قيمة البذرة التي استخدمت في إنشاء المولِّد. أمثلة مثالٌ عن استخدام التابع seed: prng1 = Random.new(1234) prng1.seed #=> 1234 prng1.rand(100) #=> 47 prng2 = Random.new(prng1.seed) prng2.rand(100) #=> 47 انظر أيضًا التابع new: يُنشئ مولِّد أعدادٍ شبه ...

يمنع التابع freeze إجراء تعديلاتٍ إضافيةٍ على الكائن الذي استدعي معه. سيُرمَى الخطأ RuntimeError عند محاولة إجراء أي تعديلٍ مع هذا الكائن بعد استدعاء التابع freeze معه. ليس هناك أيُّ طريقةٍ لتحرير الكائن من حالة التجميد (frozen) بعد تطبيقها. انتبه إلى أن الأصناف التالية تكون في حالة تجميد دائمة وهي: Integer، و Float، و Symbol. البنية العامة freeze → obj القيم المعادة يُعاد الكائن المعطى نفسه بعد تجميده. أمثلة مثالٌ عن استخدام التابع freeze: a = [ "a", "b", "c" ...

يتعامل التابع hex مع بادئة السلسلة النصية كسلسلة من الأرقام الست عشرية (والتي قد تبدأ بإشارة الرقم أو بالإشارة 0x) ثم يُعيد الرقم المُقابل لها. يعيد التابع العدد 0 عند وجود أي خطأ. البنية العامة hex → integer القيمة المعادة يُعاد الرقم المقابل لبادئة السلسلة النصية المعطاة باعتبارها سلسلة من الأرقام الست عشرية، أو يعاد العدد 0 عند حصول أي خطأ. أمثلة مثال على استعمال التابع hex: "0x0a".hex #=> 10 "-1234".hex #=> -4660 "0".hex ...

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

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

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

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

يعيد التابع blocks عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. البنية العامة blocks → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل عدد كتل نظام الملفات المحجوزة للملف المعطى، أو تعاد القيمة nil إن لم يكن نظام التشغيل يدعم هذه الميزة. أمثلة مثال على استعمال التابع blocks: File.stat("testfile").blocks #=> 2 انظر أيضا التابع birthtime: يعيد وقت إنشاء الملف الذي استدعي معه. التابع blksize: يعيد حجم كتلة نظام الملفات الأساسي. مصادر قسم التابع blocks في الصنف File::Stat ...

يعيد التابع blksize حجم كتلة نظام الملفات الأساسي. البنية العامة blksize → integer or nil القيمة المعادة يعاد عدد صحيح يمثِّل حجم كتلة نظام الملفات الأساسي، أو تعاد القيمة nil إن لم تكن منصة التشغيل تدعم توريد هذه المعلومات. أمثلة مثال على استعمال التابع blksize: File.stat("testfile").blksize #=> 4096 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى الملف الذي استدعي معه. التابع blocks: يعيد عدد كتل نظام الملفات المحجوزة للملف الذي استدعي معه. مصادر قسم التابع blksize في الصنف ...

يعيد المعامل ‎=~‎ ناتج التعبير sym.to_s =~ obj. البنية العامة sym =~ obj→ integer or nil‎ القيمة المعادة يعاد ناتج التعبير sym.to_s =~ obj. انظر أيضًا المعامل ==: يتحقق من تساوي رمزين أي إن كان هذان الرمزان هما نفس الرمز. المعامل []: يعيد ناتج التعبير sym.to_s[]‎. مصادر قسم المعامل =~‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

ينشئ التابع fork عملية فرعية (subprocess). في حال تمرير كتلة، فستُنفّذ تلك الكتلة في العملية الفرعية، كما أن قيمة حالة الخروج عند الانتهاء ستساوي الصفر. خلا ذلك، سيعيد التابع fork مرتين؛ مرةً في العملية الأب (parent process)، حيث يعيد معرف العملية (pid) الفرعية، ومرة في العملية الفرعية، حيث يعيد nil. يمكن للعملية الفرعية الخروج باستخدام exit!‎ لتجنب تشغيل دوال التابع at_exit. يجب أن تستخدم العملية الأب التابع Process.wait لتجميع حالات إنهاء عملياتها الفرعية، أو تستخدم Process.detach لتسجيل إهمال تلك الحالات؛ خلاف ...

يستخلص التابع mon من التوقيت الذي استدعي معه رقم الشهر من السنة. البنية العامة mon→ integer month → integer‎ القيمة المعادة يعاد عدد صحيح بين 0 و 12 يمثل رقم الشهر من السنة للتوقيت المعطى. أمثلة مثال على استخدام التابع mon‎: t = Time.now #=> 2007-11-19 08:27:30 -0600 t.mon #=> 11 t.month #=> 11‎ انظر أيضًا التابع wday: يُعيد عددًا صحيحًا يمثل رقم اليوم في الأسبوع للتوقيت الذي ...

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

يستدعي التابع each_byte الكتلة المعطاة على كل بايت (0..255) في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_byte {|byte| block } → ios each_byte→ an_enumerator‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل بايت من بايتاته، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة. أمثلة مثال على استخدام التابع ...

يُمرر التابع each_char كل محرف من محارف السلسلة النصية التي استدعي معها إلى الكتلة المُعطاة. في حال عدم وجود كتلة، فسيعيد التابع كائنًا من النوع enumerator . البنية العامة each_char {|cstr| block } → str each_char → an_enumerator القيمة المعادة تعاد السلسلة النصية التي تعيدها الكتلة block المعطاة بعد تمرير كل محرف من محارف السلسلة النصية المعطاة إليها، أو يُعاد كائن من النوع enumerator في حال عدم وجود كتلة. أمثلة مثال على استخدام التابع each_char: "hello".each_char {|c| print c, ' ' } ناتج ...

تعدُّ كائنات الاستثناءات في روبي أصنافًا فرعيةً (subclasses) من الصنف Exception. على أي حال، تُبلِّغ أنظمة التشغيل عادةً عن الأخطاء باستخدام أعدادٍ صحيحةٍ مبسّطةٍ (plain integers). تُنشَأ الوحدة Errno ديناميكيًّا لتنظيم تفاصيل هذه الأخطاء الناتجة عن أنظمة التّشغيل وإرسالها إلى أصناف روبي، مع توليد صنف فرعي من الصنف SystemCallError خاص بكل رقم خطأٍ. عند إنشاء الصّنف الفرعي في الوحدة Errno، ستبدأ تسميته بالاسم ::Errno. تعتمد أسماء الأصناف ::Errno تعتمد على البيئة التي تعمل فيها روبي. ففي منصة يونكس أو ويندوز ...

يستدعي التابع each_char الكتلة المعطاة على كل محرف في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_char {|c| block } → ios each_char→ an_enumerator‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل محرف من محارفه، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة.  أمثلة مثال على استخدام التابع each_char‎: ...

يعيد التابع size حجم الملف الذي يشير إليه الكائن File::Stat المعطى. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف الذي يشير إليه الكائن File::Stat المعطى بالبايت. أمثلة مثال على استعمال التابع size: File.stat("testfile").size #=> 66 انظر أيضًا التابع size?‎: يتحقق إن كان الملف الذي يشير إليه الكائن File::Stat المعطى غير موجود أو معدوم الحجم. التابع zero?‎: يتحقق إن الملف الذي يشير إليه الكائن File::Stat المعطى ما موجودًا وخاويًا (صفر الحجم). مصادر قسم التابع size ...

يعيد التابع floor‎ أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة (precision) تساوي العدد المعطى (القيمة الابتدائية هي 0).  البنية العامة floor([ndigits]) → integer or float‎ المعاملات ndigits‎ عدد يحدد الدقة. إذا كانت الدقة سالبة، فإنّ القيمة المعادة ستكون عددًا صحيحًا مع ndigits.abs صفر إضافي على الأقل. القيمة المعادة يعيد التابع floor‎ أكبر عدد من الأعداد الأصغر من أو يساوي قيمة العدد الذي استُدعي معه وبدقة تساوي ndigits رقم عشري.  إذا كانت الدقة سالبة، ...

يمرِّر التابع each_grapheme_cluster كل وحدة كتابية (grapheme) إلى الكتلة المعطاة ثم يعيد سلسلة نصية بالناتج الذي تعيده. إن لم تُعطَ أية كتلة، فسيُعاد كائنٌ من النوع Enumerator. بخلاف التابع each_char، هذا التابع يكرِّر العملية على كل الوحدات الكتابية (grapheme clusters) المُعرَّفة في ترميز اليونيكود Annex #29 القياسي. البنية العامة each_grapheme_cluster {|cstr| block } → str each_grapheme_cluster → an_enumerator القيمة المعادة يعاد الناتج الذي تعيده الكتلة block بعد تمرير كل وحدة كتابية من السلسلة النصية المعطاة إليها، أو يعاد كائن من النوع ...

يشبه التابع lchown التابع chown باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير المالك والمجموعة المالكة للوصلة نفسها وليس للملف الذي تشير إليه). هذا التابع غير متاح في أغلب الأحيان. البنية العامة lchown(owner_int, group_int, file_name,..) → integer المعاملات owner_int معرِّف المستخدم الذي سيصبح المالك الجديد للملف أو الملفات المحدَّدة. إن كانت قيمة هذا المعامل nil أو 1-، فسيُتجاهَل. group_int معرّف المجموعة المالكة التي ستصبح المجموعة المالكة الجديدة للملف أو الملفات المحدَّدة. إن كانت قيمة هذا المعامل nil أو 1-، فسيُتجاهَل. file_name اسم الملف المراد تغيير المالك ...

يقرأ التابع read عددًا محددًا من البايتات من المجرى ARGF. البنية العامة read([length [, outbuf]]) → string, outbuf, or nil يعالج هذا التابع جميع الملفات الممرَّرة في سطر الأوامر وكأنَّها ملفٌ واحدٌ، لذلك يعيد جميع محتويات هذا الملف الزائف (pseudo file) عند استدعائه دون تمرير أي وسائط. إذا كانت قيمة الوسيط length عددًا صحيحًا موجبًا، فسيحاول التابع read قراءة عددٍ من البايتات يساوي length دون إجراء أي تحويل (الوضع الثنائي [binary mode]). في حال كان length عددًا صحيحًا (integer)، تكون السلسلة ...

يعيد التابع dev عددًا صحيحًا يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat الذي استدعي معه. البنية العامة dev → integer القيمة المعادة يعاد عدد صحيح يمثِّل الجهاز الذي يتواجد فيه الكائن File::Stat المعطى. أمثلة مثال على استعمال التابع dev: File.stat("testfile").dev #=> 774 انظر أيضًا التابع dev_major: يعيد عددًا صحيحًا يمثِّل الجزء الكبير (major part) من dev، أو يعيد القيمة nil. التابع dev_minor: يعيد عددًا صحيحًا يمثِّل الجزء الصغير (minor part) من dev، أو يعيد القيمة nil. التابع rdev: يعيد ...