نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
التابع Numeric.eql? في روبي
يتحقق التابع eql? إن كان العدد الذي استُدعي معه والعدد المُمرَّر إليه من نفس النوع ومتساويين. يعمل هذا التابع بشكل مخالف للمعامل == الذي يحول نوع العددين قبل إجراء الموزانة بينهما. البنية العامة eql?(numeric) → true or false
المعاملات numeric عدد يراد التحقق من تساويه نوعًا وقيمةً مع العدد المعطى. القيمة المعادة تُعاد القيمة true إن كان العدد المعطى والعدد numeric من نفس النوع ومتساويين. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع eql?: 1 == 1.0 ...
التابع Complex.to_i في روبي
يحول التابع to_i العدد العقدي الذي استدعي معه إلى عدد صحيح إن كان ذلك ممكنًا (ينبغي أن يساوي الجزء التخيلي القيمة 0 تمامًا، وإلا فسيُطلَق الخطأ RangeError). البنية العامة to_i → integer
القيمة المعادة يعاد عدد صحيح يمثِّل ناتج تحويل العدد العقدي المعطى إن كان ذلك ممكنًا، أو سيُرمَى الخطأ RangeError إن لم يكن ذلك ممكنًا. أمثلة أمثلة عن استخدام التابع to_i: Complex(1, 0).to_i #=> 1
Complex(1, 0.0).to_i # RangeError
Complex(1, 2).to_i # RangeError
انظر ...
التابع Marshal.load في روبي
يعيد التابع load نتيجة تحويل البيانات المُسلسلة (serialized) في المصدر إلى كائن روبي (ربما مع كائنات ثانوية [subordinate objects] مرتبطة به). قد يكون المصدر إمَّا كائنًا من الصنف IO، أو كائنًا يستجيب إلى التابع to_str. في حال تمرير المعامل الثاني، فسيتم تمرير كل كائن من الكائنات إليه أثناء فك تسلسلها (deserialisation). تنبيه: لا تمرّر أبدًا إلى التابع load بيانات غير موثوقة (بما في ذلك المدخلات التي يرسلها المستخدم). البنية العامة load( source [, proc] ) → obj
المعاملات source إمَّا كائنٌ من ...
التابع String.valid_encoding? في روبي
يتحقق التابع ?valid_encoding إذا كانت سلسلة نصية مُرمّزة بشكل صحيح. البنية العامة valid_encoding? → true or false
القيمة المعادة تُعاد القيمة true إذا كانت السلسلة النصية المعطاة مُرمّزة بشكل صحيح، أو تُعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال التابع valid_encoding?: "\xc2\xa1".force_encoding("UTF-8").valid_encoding? #=> true
"\xc2".force_encoding("UTF-8").valid_encoding? #=> false
"\x80".force_encoding("UTF-8").valid_encoding? #=> false
انظر أيضًا التابع ascii_only?: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع empty?: يتحقق إذا ...
التابع Enumerable.inject في روبي
يجمع التابع inject جميع عناصر الكائن القابل للتعداد الذي استدعي معه عبر تطبيق عملية ثنائية تُحدَّد بوساطة كتلة أو رمز يسمي تابعًا أو معاملًا. التابعان inject و reduce هما وجهين لعملة واحدة؛ أي كل منها اسم بديل للآخر. البنية العامة inject(initial, sym) → obj
inject(sym) → obj
inject(initial) { |memo, obj| block } → obj
inject { |memo, obj| block } → obj
إن حُدَّدَت كتلة مع هذا التابع، فسيُمرَّر لكل عنصر من عناصر الكائن القابل للتعداد المعطى قيمة تراكمية (memo) والعنصر نفسه. إن حُدَّدَ رمز ...
التابع Thread.priority في روبي
يُعيد التابع priority أولوية المهمة الفرعية التي استدعيت معه. تورث القيمة الافتراضية من المهمة الفرعية الحالية المسؤولة عن إنشاء المهمة الفرعية الجديدة، أو تكون القيمة صفر للمهمة الفرعية الرئيسية الابتدائية (initial main thread)؛ سيتم تشغيل المهام الفرعية ذات الأولوية العالية بشكل أكثر تكرارًا من مثيلاتها ذات الأولوية المنخفضة (ولكنها ستُشغّل على أي حال). هذا مجرد تلميح يستعمله مُجدوِل المهام الفرعية (thread scheduler) في روبي. مع ذلك، قد يتم تجاهله في بعض أنظمة التشغيل. البنية العامة priority→ integer
القيمة المعادة يعاد عدد ...
التابع Array.reject في روبي
يعيد التابع reject مصفوفة جديدة تحتوي جميع عناصر المصفوفة التي استُدعيت معها والتي لم تحقق شرطًا محددًا. يُحافَظ على ترتيب العناصر المرفوضة المعادة بنفس ترتيبها كما كانت في المصفوفة الأصلية. إن لم تُمرَّر أية كتلة إلى التابع reject، فسيعيد كائنًا من النوع Enumerator. البنية العامة reject {|item| block } → new_ary
reject → Enumerator
القيم المعادة تعاد مصفوفة جديد تحوي جميع عناصر المصفوفة المعطاة التي لم تعاد معها القيمة true عند تطبيق الكتلة block عليها، أو يعاد كائن من النوع ...
التابع IO.codepoints في روبي
يعدُّ التابع codepoints اسمًا بديلًا مهملًا للتابع each_codepoint. البنية العامة codepoints()
انظر أيضًا التابع each_codepoint: ينفذ الكتلة المعطاة على رموز اليونيكود الخاصة بمحارف المجرى. مصادر قسم التابع codepoints في الصنف IO في توثيق روبي الرسمي.
التابع IO.fileno في روبي
يُعيد التابع fileno عددًا صحيحًا يمثل واصف الملف الرقمي (numeric file descriptor) للمجرى الذي استدعي معه. البنية العامة fileno → integer
to_i→ integer
القيمة المعادة يعاد عددٌ صحيحٌ يمثل واصف الملف الرقمي للمجرى المعطى. أمثلة مثال على استخدام التابع fileno: $stdin.fileno #=> 0
$stdout.fileno #=> 1
انظر أيضًا التابع fdatasync: يكتب مباشرةً جميع البيانات المخزنة في مجرى د/خ على القرص. مصادر قسم التابع fileno في الصنف IO في توثيق روبي الرسمي.
التابع Enumerable.max_by في روبي
يعيد التابع max_by العنصر الذي تعيد الكتلة المعطاة أكبر قيمة مقابلة له بعد تمرير عناصر الكائن القابل للتعداد إليها كلٌّ على حدة. إن لم تعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة max_by {|obj| block } → obj
max_by → an_enumerator
max_by(n) {|obj| block } → obj
max_by(n) → an_enumerator
المعاملات n إن أعطي هذا المعامل، فسيُعاد أكبر n عنصر في مصفوفة. تُرتَّب العناصر آنذاك في المصفوفة بشكل تنازلي بناءً على القيمة المقابلة التي تعيدها الكتلة. القيمة المعادة يعاد العنصر الذي تعيد ...
التابع MatchData.captures في روبي
يعيد التابع captures مصفوفة الأجزاء المُطابقة (array of captures)؛ يكافئ mtch.to_a[1..-1]. البنية العامة captures→ array
القيمة المعادة تعاد مصفوفة الأجزاء المُطابقة. أمثلة مثال على استخدام التابع captures: f1,f2,f3,f4 = /(.)(.)(\d+)(\d)/.match("THX1138.").captures
f1 #=> "H"
f2 #=> "X"
f3 #=> "113"
f4 #=> "8"
انظر أيضا التابع begin: يعيد موضع (offset) بداية العنصر n من مصفوفة التطابق في السلسلة النصية. التابع end: يعيد موضع (offset) الحرف الذي يلي نهاية العنصر n من مصفوفة التطابق في السلسلة النصية. مصادر ...
التابع ARGF.skip في روبي
يتخطى التابع skip الملف الحالي إلى الملف التالي ويجعله هو الملفَّ الحالي في المجرى ARGF. وفي حال لم يكن هنالك أية ملفات متبقية، فلن يكون لهذا التابع أي تأثير. البنية العامة skip → ARGF
القيم المعادة يعاد المجرى ARGF. أمثلة مثال على استخدام التابع skip: $ ruby argf.rb foo bar
ARGF.filename #=> "foo"
ARGF.skip
ARGF.filename #=> "bar"
انظر أيضًا التابع close: يغلق الملف الحالي ويتخطاه إلى الملف التالي في ARGV. التابع eof?: يتحقق إذا بلغ الملف الحالي نهايته في ARGF. التابع ...
الصنف NilClass في روبي
الصنف NilClass هو صنفٌ للكائن nil المُفرد. توابع النسخ العامة (Public Instance Methods) & يجري المعامل & العملية And المنطقية على الكائن المعطى والقيمة nil أو false. === يتحقق المعامل === من تساوي كائنين مع بعضهما بعضًا. ^ يجري المعامل ^ العملية XOR المنطقية على الكائن المعطى والقيمة nil أو false. | يجري المعامل | العملية OR المنطقية على الكائن المعطى والقيمة nil أو false. inspect يعيد دائمًا السلسلة النصية "nil". nil? يتحقق إن كان الكائن الذي استدعي معه هو الكائن nil. rationalize يعيد الصفر كعدد جذري (rational). to_a يعيد دائمًا مصفوفة فارغة. to_c يحول الصفر إلى عدد عقدي. to_f يعيد ...
التابع File.directory? في روبي
يتحقق التابع directory? إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false
المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?: File.directory?(".")
انظر أيضا التابع zero?: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?: يتحقق إن كان ...
الصنف SyntaxError في روبي
يطلق الاستثناء SyntaxError عند اكتشاف خطأ في صياغة الشيفرة البرمجية لروبي. eval("1+1=2")
سيًطلق الاستثناء SyntaxError بالشكل التالي: SyntaxError: (eval):1: syntax error, unexpected '=', expecting $end
توابع الصنف العامة new ينشئ استثناءً جديدًا من النوع SyntaxError. مصادر صفحة الصنف SyntaxError في توثيق روبي الرسمي.
التابع String.lstrip! في روبي
يحذف التابع lstrip! المسافة البيضاء في بادئة السلسلة النصية المعطاة. يُقصد بالمسافة البيضاء أي من المحارف التالية: القيمة العدمية (null)، أو مسافة الجدولة الأفقية (horizontal tab)، أو مسافة الجدولة العمودية (vertical tab)، أو محرف الانتقال إلى سطر جديد (line feed)، أو محرف الانتقال إلى صفحة جديدة (form feed)، أو محرف العودة إلى بداية السطر (carriage return)، أو المسافة الفارغة (space). البنية العامة lstrip! → self or nil
القيمة المعادة تُعاد السلسلة النصية المعطاة بعد حذف المسافة البيضاء من بادئتها، أو ...
التابع String.lstrip في روبي
يعيد التابع lstrip نسخة عن السلسلة النصية مع حذف المسافة البيضاء في بادئة السلسلة. يُقصد بالمسافة البيضاء أي من المحارف التالية: القيمة العدمية (null)، أو مسافة الجدولة الأفقية (horizontal tab)، أو مسافة الجدولة العمودية (vertical tab)، أو محرف الانتقال إلى سطر جديد (line feed)، أو محرف الانتقال إلى صفحة جديدة (form feed)، أو محرف العودة إلى بداية السطر (carriage return)، أو المسافة الفارغة (space). البنية العامة lstrip → new_str
القيمة المعادة تُعاد نسخة عن السلسلة النصية المعطاة مع حذف المسافة ...
التابع IO.write_nonblock في روبي
يكتب التابع write_nonblock السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام استدعاء النظام write(2) بعد تعيين قيمة الراية O_NONBLOCK الخاصة بواصف الملف (file descriptor) الأساسي. يستدعي التابع write_nonblock استدعاء النظام write(2). ويتسبب في كافة الأخطاء التي يتسبب فيها استدعاء النظام write(2)، مثل Errno::EWOULDBLOCK و Errno::EINTR وغيرهما. قد تكون النتيجة أصغر من طول السلسلة النصية (أي أن الكتابة جزئية). لذا يجب أن يعالج المستدعي هذه الأخطاء، إضافة إلى مسألة الكتابة الجزئية. إن كان الاستثناء يساوي Errno::EWOULDBLOCK أو Errno::EAGAIN، فسيتم توسيعه ...
التابع Complex.real في روبي
يعيد التابع real الجزء الحقيقي (real part) للعدد العقدي الذي استدعي معه. البنية العامة real → real
القيمة المعادة يعاد عدد حقيقي يمثِّل الجزء الحقيقي (real part) للعدد العقدي. أمثلة أمثلة عن استخدام معامل التابع real: Complex(7).real #=> 7
Complex(9, -4).real #=> 9
انظر أيضًا التابع image: يعيد الجزء التخيلي للعدد العقدي. مصادر قسم التابع real في الصنف Complex في توثيق روبي الرسمي.
التابع SignalException.new في روبي
ينشئ التابع new كائنًا جديدًا من النوع SignalException. البنية العامة new(sig_name) → signal_exception
new(sig_number [, name])→ signal_exception
المعاملات sig_name اسم الإشارة. يجب أن يكون هذا المعامل اسم إشارة معروف. sig_number رقم الإشارة. name اسم الإشارة. القيمة المعادة يعاد كائنٌ جديدٌ من النوع SignalException. انظر أيضًا التابع signo: يعيد رقم إشارة. مصادر قسم التابع new في الصنف SignalException في توثيق روبي الرسمي.
التابع IO.read في روبي
يقرأ التابع read ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج. البنية العامة read(name, [length [, offset]] [, opt] )→ string
المعاملات name اسم الملف المراد القراءة منه. إن كان name يبدأ بمحرف الأنبوب ("|")، فستُنشَأ عملية فرعية (subprocess) بطريقة مشابهة للتابع Kernel.open، ثم ستعاد مُخرجاتها. length عدد صحيح يمثل عدد البايتات المراد قراءتها من الملف. القيمة الافتراضية لهذا المعامل هي القراءة حتى نهاية الملف. offset عدد صحيح يمثل إزاحة موضع المؤشر في الملف إلى المكان الذي يراد بدء القراءة ...
التابع Array.slice في روبي
يجلب التابع slice عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة -1 فهرس العنصر الأخير. ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة slice(index) → obj or nil
slice(start, length) → new_ary or nil
slice(range) → new_ary or nil
المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. ...
التابع Complex.rationalize في روبي
يعيد التابع rationalize القيمة الجذرية (rational) المقابلة للعدد العقدي (ينبغي أن يكون الجزء التخيلي معدومًا). البنية العامة rationalize([eps]) → rational
المعاملات eps يمثل هامش التقريب. إذ يحقق (c-|eps| <= result <= c+|eps|)، حيث c يمثل العدد العقدي، و resultيمثل القيمة المعادة. القيمة المعادة يعيد التابع rationalize القيمة الجذرية (rational ) المقابلة للعدد العقدي. والذي هو عدد جذري. أمثلة أمثلة عن استخدام معامل التابع rationalize: Complex(1.0/3, 0).rationalize #=> (1/3)
Complex(1, 0.0).rationalize # RangeError
Complex(1, 2).rationalize ...
التابع IO.gets في روبي
يجلب التابع gets السطر التالي من المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة وإلا سيُطلَق الاستثناء IOError. إن كان المجرى يحتوي على حروف متعددة البايتات، فستعيد gets(1) الحرف بالكامل. البنية العامة gets(sep=$/ [, getline_args]) → string or nil
gets(limit [, getline_args])→ string or nil
gets(sep, limit [, getline_args]) → string or nil
المعاملات sep المحرف الفاصل بين الأسطر. القيمة الافتراضية هي: /$. إن كانت قيمته nil، فستُقرَأ آنذاك جميع محتويات المجرى (أي سيمثِّل نهاية المجرى). limit عدد ...
التابع ARGF.to_i في روبي
يعيد التابع to_i عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. إن لم يكن هنالك ملف، فسيُطلَق الخطأ ArgumentError. البنية العامة to_i → integer
القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف الرقمي (numeric file descriptor) للملف الحالي. أمثلة مثال على استخدام التابع to_i: ARGF.to_i #=> 3
انظر أيضًا التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. التابع lineno: يجلب رقم السطر الحالي للمجرى ARGF ككُل. التابع ...
التابع Numeric.to_int في روبي
يستدعي 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 في الصنف ...
التابع String.strip في روبي
يعيد التابع strip نسخة عن السلسلة النصية مع حذف المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معها. يُقصد بالمسافة البيضاء أي من المحارف التالية: القيمة العدمية (null)، أو مسافة الجدولة الأفقية (horizontal tab)، أو مسافة الجدولة العمودية (vertical tab)، أو محرف الانتقال إلى سطر جديد (line feed)، أو محرف الانتقال إلى صفحة جديدة (form feed)، أو محرف العودة إلى بداية السطر (carriage return)، أو المسافة الفارغة (space). البنية العامة strip → new_str
القيمة المعادة تُعاد نسخة عن السلسلة ...
التابع Enumerator.size في روبي
يعيد التابع size حجم المُعدِّد الذي استدعي معه، أو يعيد القيمة nil إن لم يكن بالإمكان حساب الحجم بالنمط الكسول (lazily). البنية العامة size → int, Float::INFINITY or nil
القيمة المعادة يعاد عدد صحيح يمثِّل حجم المُعدِّد المعطى، أو تعاد القيمة Float::INFINITY للإشارة إلى الحجم اللانهائي، أو تعاد القيمة nil لم يكن بالامكان حساب الحجم بالنمط الكسول (lazily). أمثلة مثال على استعمال التابع size: (1..100).to_a.permutation(4).size # => 94109400
loop.size # => Float::INFINITY
(1..100).drop_while.size # => nil
انظر أيضًا التابع next: يعيد الكائن التالي ...
التابع Array.empty? في روبي
يتحقق التابع empty? إن كانت مصفوفةٌ فارغةً أم لا. البنية العامة empty? → true or false
القيم المعادة تعاد القيمة true المنطقية إن كانت المصفوفة المعطاة فارغة، أو القيمة false خلا ذلك. أمثلة بعض الأمثلة على استخدام التابع empty?: [].empty? #=> true
[1, 5].empty? #=> false
انظر أيضًا التابع include?: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. التابع frozen?: يتحقق إن كانت مصفوفةٌ مُجمَّدةً ( frozen) بشكل دائم أو مؤقت ...
التابع ENV.member? في روبي
يتحقَّق التابع ?member إن كان هناك متغير بيئة ذي اسم محدَّد. البنية العامة member?(name) → true or false
المعاملات name اسم متغير البيئة المراد التحقق من وجوده. القيمة المعادة تُعاد القيمة true إن كان هناك متغير بيئة بالاسم name. خلا ذلك، تُعاد القيمة false. انظر أيضًا التابع has_key?: يتحقَّق إن كان هناك متغير بيئة باسم محدَّد. التابع ?key: يتحقَّق إن كان هنالك متغير بيئة باسم محدَّد. التابع has_value?: يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة. مصادر قسم التابع member? في ...
الصنف RangeError في روبي
يُطلق الاستثناء RangeError عندما تكون قيمة عددية معطاة خارج النطاق. [1, 2, 3].drop(1 << 100)
سيُطلق الاستثناء RangeError بعد تنفيذ هذه الشيفرة: RangeError: bignum too big to convert into `long'
مصادر صفحة الصنف RangeError في توثيق روبي الرسمي.
التابع ENV.clear في روبي
يحذف التابع clear جميع متغيرات البيئة. البنية العامة clear
انظر أيضًا التابع delete: يحذف متغير بيئة محدَّد ثم يعيد قيمة هذا المتغير. التابع delete_if: يحذف كل متغيرات البيئة التي تحقق شرطًا محدَّدًا. مصادر قسم التابع clear في الصنف ENV في توثيق روبي الرسمي.
التابع Process.abort في روبي
ينهي التابع abort تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء Kernel.exit(false). إن مُرِّرَت رسالة إلى هذا التابع، فستُكتَب على مجرى الخطأ القياسي (STDERR) قبل إنهاء العملية. البنية العامة abort
Kernel::abort([msg])
abort([msg])
المعاملات msg رسالة الخطأ المراد طباعتها على مجرى الخطأ القياسي. انظر أيضًا التابع Kernel.exit: يبدأ عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit. التابع argv0: يعيد اسم الشيفرة البرمجية التي يجري تنفيذها. التابع exit: يبدأ عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. مصادر قسم التابع abort في الصنف Process في ...
التابع Method.owner في روبي
يعيد التابع owner الصنف أو الوحدة (module) التي تُعرِّف الكائن Method الذي استُدعي معه. البنية العامة owner → class_or_module
القيمة المعادة يعاد الصنف أو الوحدة التي تُعرِّف الكائن Method المعطى. انظر أيضا التابع original_name: يعيد الاسم الأصلي للتابع الذي استُدعي معه. التابع parameters: يعيد معلومات عن وسائط التابع الذي استُدعي معه. مصادر قسم التابع owner في الصنف Method في توثيق روبي الرسمي.
التابع Process.getpriority في روبي
يجلب التابع getpriority قيمة أولوية الجدولة (scheduling priority) لعملية محدَّدة أو لمجموعة مالكة أو مستخدم مالك لعملية. كلما كانت الأولوية منخفضة، كان ذلك أنسب لجدولة. هذا التابع غير متوافر على جميع المنصات. البنية العامة getpriority(kind, integer) → integer
المعاملات kind يشير إلى نوع الكيان المراد البحث عنه. وهو أحد القيم التالية: Process::PRIO_PGRP، أو Process::PRIO_USER، أو Process::PRIO_PROCESS. integer عدد صحيح يشير إلى عملية محدَّدة، أو مُعرِّف مجموعة أو مستخدم مالك لعملية. القيمة 0 تشير إلى العملية الحالية. القيم المعادة يعاد عدد صحيح ...
التابع File.writable_real? في روبي
يعيد التابع writable_real? إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية. اطلع على توثيق الدالة access(3). البنية العامة writable_real?(file_name) → true or false
المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الحقيقي للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضا التابع owned?: يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. ...
التابع Float.abs في روبي
يعيد التابع abs القيمة المطلقة للعدد العشري الذي استُدعي معه. يملك هذا التابع اسمًا بديلًا هو magnitude. البنية العامة abs → float
القيمة المعادة تعاد القيمة المطلقة للعدد العشري المعطى. أمثلة مثال على استخدام التابع abs: (-34.56).abs #=> 34.56
-34.56.abs #=> 34.56
34.56.abs #=> 34.56
انظر أيضا التابع arg: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك.. مصادر قسم التابع abs في الصنف Float ...
التابع String.freeze() في روبي
يجمد التابع freeze السلسلة النصية التي استُدعيت معه، أي يجعلها غير قابلة للتعديل. البنية العامة freeze()
القيمة المعادة تعاد السلسلة النصية المعطاة بعد تجميدها. أمثلة مثال على استعمال التابع freeze: a=”hello ” #=> “hello ”
a<<”world” #=> “hello world”
a.freeze #=> “hello world”
a<<”Guys” #=> FrozenError (can't modify frozen String)
انظر أيضًا المعامل >>: يُلحق الكائن المُعطى بالسلسلة النصية. الصنف FrozenError. مصادر قسم التابع freeze() ...
التابع Module.nesting في روبي
يعيد التابع nesting قائمة من الوحدات المتشعبة (Modules nested) لحظة الاستدعاء. البنية العامة nesting → array
القيمة المعادة تعاد مصفوفة تحوي قائمة من الوحدات المتشعبة لحظة الاستدعاء. أمثلة مثال على استخدام التابع nesting: module M1
module M2
$a = Module.nesting
end
end
$a #=> [M1::M2, M1]
$a[0].name #=> "M1::M2"
انظر أيضا التابع constants: يعيد مصفوفة مكونة أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. التابع new: ينشئ وحدة مجهولة ...
التابع String.casecmp في روبي
يقارن التابع casecmp بين سلسلتين نصيتين دون أخذ حالة الأحرف بالحسبان. أي هذا التابع هو النسخة الغير حساسة لحالة الأحرف من المعامل <=>. حاليًا، تشمل حالة عدم الحساسية الأحرف A-Z/a-z فقط، وليس جميع محارف الترميز Unicode، وهذا يختلف عن casecmp?. البنية العامة casecmp(other_str) → -1, 0, +1, or nil
المعاملات other_str السلسلة النصية المراد مقارنتها مع السلسلة النصية المُعطاة. القيمة المعادة تُعاد القيمة 1- إذا كانت السلسلة النصية المُعطاة أصغر من السلسلة other_str، أو1+ إذا كانت أكبر منها، أو 0 ...
التابع InstructionSequence.to_binary في روبي
يُسلسل (serialize) التابع to_binary سلسلة التعليمات التي استُدعي معها على هيئة سلسلة نصية ثنائية (binary). يتم إنشاء سلسلة تعليمات بعد تحويلها باستعمال هذا التابع بواسطة التابع load_from_binary. لاحظ أن البيانات الثنائية المترجمة ليست محمولة (portable). لا يمكنك نقل هذه البيانات الثنائية إلى جهاز آخر. كما لا يمكنك استخدام البيانات الثنائية التي تم إنشاؤها بواسطة إصدار آخر من روبي. البنية العامة to_binary(extra_data = nil) → binary str
المعاملات extra_data سيتم حفظ المعامل extra_data المعطى مع البيانات الثنائية. يمكنك الوصول إلى هذه البيانات ...
التابع SizedQueue.enq في روبي
التابع enq هو اسم بديل للتابع push. البنية العامة enq(*args)
انظر أيضًا التابع push: يضيف عنصرًا إلى الطابور مصادر قسم التابع enq في الصنف SizedQueue في توثيق روبي الرسمي.
الصنف File في روبي
الصنف File هو اختصار لأي كائن ملفٍ قابل للوصول عبر البرنامج ومرتبط عن كثب بالصنف IO. يتضمن الصنف File توابع الوحدة FileTest كتوابع صنفٍ مما يسمح لك باستعمال File.exist?("foo") مثلًا. في شرح توابع الصنف File التالية، تكون بتات الأذونات (permission bits) مجموعة من البتات التي تعتمد على المنصة المستعملة والتي تشير إلى أذونات الملف. في الأنظمة الشبيهة بيونكس، تُعرض الأذونات على شكل مجموعة من ثلاثة ثمانيات (octets)؛ الأولى من أجل المالك، والثانية من أجل المجموعة المالكة، والثالثة تخص الأشخاص الآخرين. ...
التابع Time.utc في روبي
ينشئ التابع utc توقيتًا جديدًا استنادًا إلى القيم المعطاة، ويتم تفسيره وفق التوقيت العالمي الموحد UTC (GMT). يجب تحديد السنة عند استعمال هذا التابع. أما القيم الأخرى، فتساوي افتراضيًّا الحد الأدنى لقيمها (وقد تكون nil، أو قد تُحذف). سيُطلق الاستثناء ArgumentError إذا كانت أي من تلك القيم خارج النطاق. سيقبل التابع أيضًا عشر وسائط لأجل استخدامها في مخرجات التابع to_a. البنية العامة utc(year) → time
utc(year, month) → time
utc(year, month, day) → time
utc(year, month, day, hour) → time
utc(year, month, day, hour, min) ...
التابع Enumerator.feed في روبي
يضبط التابع feed القيمة المراد إعادتها عبر الاستدعاء yield التالي داخل e. إن لم تُعيَّن القيمة، فسيعيد yield القيمة nil. البنية العامة feed obj → nil
المعاملات obj قيمة الكائن المراد ضبطها لإعادتها عبر الاستدعاء yield التالي. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. أمثلة مثال على استعمال التابع feed: # ويجمِّع "yield" عناصر المصفوفة إلى Array.map يمرر
# .كمصفوفة "yield" نتائج
# يعيد العناصر المُمرَّرة وتُجمَّع "next" يظهر المثال التالي أنَّ
# كمصفوفة يمكن الحصول عليها "feed" القيم التي مُرِّرت إلى
# .StopIteration.result عبر
e ...
التابع String.scrub في روبي
يعيد التابع scrub نسخة عن السلسلة النصية التي استدعي معها مع استبدال البايتات غير الصالحة بمحرف محدَّد. إذا لم تحتوي السلسلة على بايتات غير صالحة، فإنَّ التابع يعيد السلسلة النصية نفسها. فى حال وجود كتلة، فإنَّ التابع يعيد نسخة عن السلسلة النصية مع استبدال كل بايت غير صالح بالقيم التي تعيدها الكتلة. البنية العامة scrub → new_str
scrub(repl) → new_str
scrub{|bytes|} → new_str
المعاملات repl المحرف الذي سيحل مكان كل بايت غير صالح في السلسلة النصية المعطاة. القيمة المعادة تُعاد نسخة عن ...
التابع Process.euid في روبي
يعيد التابع euid مُعرِّف المستخدم الفعال (effective user ID) المالك لهذه العملية. هذا التابع غير متاح على جميع المنصات. البنية العامة euid → integer
Process::UID.eid → integer
Process::Sys.geteuid → integer
القيم المعادة يعاد عدد صحيح يمثِّل مُعرِّف المستخدم الفعال المالك لهذه العملية. أمثلة مثال على استعمال التابع euid: Process.euid #=> 501
انظر أيضًا التابع egid: يعيد مُعرِّف المجموعة الفعال (effective group ID) المالكة لهذه العملية. التابع euid=: يضبط عندما يستدعى بالشكل euid = integer المُعرِّف الفعَّال للمستخدم المالك لهذه العملية إلى القيمة ...
التابع Hash.update في روبي
يضيف التابع update محتويات الكائن المُمرَّر إليه إلى الكائن Hash الذي استدعي معه. إذا لم تُحدَد أية كتلة، فسيُكتب فوق الأزواج ذات المفاتيح المكررة مع القيم من الكائن المُمرَّر، وإلا تُحدَّد قيمة كل مفتاح مكرَّر عن طريق استدعاء الكتلة مع المفتاح وقيمته في الكائن المستدعى وقيمته في الكائن المُمرَّر. البنية العامة update(other_hash) → hsh
update(other_hash){|key, oldval, newval| block} → hsh
المعاملات other_hash كائن من النوع Hash يراد إضافة محتواه إلى الكائن Hash المعطى. القيمة المعادة يعاد الكائن Hash المعطى نفسه بعد إضافة ...
التابع Hash.invert في روبي
يعيد التابع invert كائن جديد من النوع Hash يحوي قيم الكائن Hash الذي استدعي معه كمفاتيح ومفاتيحه كقيم فيه. البنية العامة invert → new_hash
القيمة المعادة يعاد كائن جديد من النوع Hash تكون فيه قيم الكائن Hash المعطى كمفاتيح ومفاتيحه كقيم فيه. أمثلة إذا وُجِد بالفعل مفتاح بنفس القيمة في الكائن Hash المعطى، فسيستخدم التابع invert آخر واحد مُعرَّف، وستُتجاهل القيم التي تسبقه. انظر مثلًا إلى المثال التالي: h = { "n" => 100, "m" => 100, "y" => 300, "d" ...
التابع FileTest.writable? في روبي
يتحقق التابع writable? إن كان ملفٌ ما قابلًا للكتابة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. اطلع على توثيق الدالة eaccess(3). البنية العامة writable?(file_name) → true or false
المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الفعلي للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع owned?: يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. التابع readable?: يتحقق إن كان ...
التابع ENV.shift في روبي
يحذف التابع shift متغير بيئة (اسم المتغير وقيمته) من البيئة ENV ثمَّ يعيده في مصفوفة. في حال كانت البيئة فارغة، فسيعيد التابع القيمة nil. البنية العامة shift → Array or nil
القيمة المعادة تُعاد قيمة متغير البيئة المحذوف. أو تعاد القيمة nil في حال كانت البيئة فارغة. انظر أيضًا التابع clear: يحذف جميع متغيرات البيئة. التابع delete: يحذف متغير بيئة ذي اسم محدَّد، ثم يعيد قيمته. التابع delete_if: يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا. مصادر قسم التابع shift في الصنف ENV في ...
التابع Process.groups في روبي
يجلب التابع groups مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. البنية العامة groups → array
القيم المعادة تعاد مصفوفة تحوي مُعرِّفات المجموعات الموجودة في قائمة وصول المجموعات الإضافية (supplemental group access list) للعملية الحالية. أمثلة مثال على استعمال التابع groups: Process.groups #=> [27, 6, 10, 11]
انظر أيضًا التابع getpgid: يعيد مُعرِّف المجموعة المالكة لعملية محدَّدة. التابع gid: يعيد المُعرِّف الحقيقي للمجموعة المالكة للعملية الحالية. التابع groups=: يضبط عند استدعائه بالشكل groups= ...
التابع Hash.has_key? في روبي
يتحقق التابع has_key? إذا كان مفتاحٌ معيَّن موجودًا في الكائن Hash المعطى. انتبه إلى أنَّ التابع include? والتابع member? لا يختبرا تساوي الأعضاء باستخدام المعامل == كما تفعل غيرها من التوابع المحصية (enumerables). البنية العامة has_key?(key) → true or false
المعاملات key المفتاح المراد التحقق من وجوده. القيمة المعادة تعاد القيمة true إذا كان المفتاح key موجودًا في الكائن Hash المعطى. أمثلة مثال على استعمال التابع has_key?: h = { "a" => 100, "b" => 200 }
h.has_key?("a") #=> true
h.has_key?("z") ...
التابع Time.zone في روبي
يعيد التابع zone اسم المنطقة الزمنية المستخدمة في التوقيت الذي استدعي معه. منذ روبي 1.8، تُعاد السلسلة النصية "UTC" بدلاً من "GMT" لتمثيل التوقيت العالمي الموحد UTC. البنية العامة zone → string
القيمة المعادة يعاد اسم المنطقة الزمنية المستخدمة في التوقيت المعطى. أمثلة مثال على استخدام التابع zone: t = Time.gm(2000, "jan", 1, 20, 15, 1)
t.zone #=> "UTC"
t = Time.local(2000, "jan", 1, 20, 15, 1)
t.zone #=> "CST"
انظر أيضًا التابع to_f: يحول قيمة التوقيت المعطى إلى عدد عشري يمثل ...
التابع Exception.cause في روبي
يُعيد التّابع cause الاستثناء السابق (!$) عندما يُرمَى هذا الاستثناء. هذا مفيد في الاستثناءات المغلقة والاحتفاظ بمعلومات الاستثناء الأصلية. البنية العامة cause → an_exception or nil
القيم المعادة يعاد الاستثناء الذي سبق الاستثناء المرمي، أو تعاد القيمة nil خلا ذلك. انظر أيضا التابع message: يُعيد ناتج استدعاء التّابع Exception.to_s. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه. التابع new: يُنشئ كائنًا جديدًا من النّوع Exception، ويمرِّر رسالةً اختياريًّا إليه. التابع inspect: يُعيد اسم صنف الاستثناء ورسالته. التابع backtrace: يُعيد أيَّ تتبّعٍ ...
التابع Object.clone في روبي
يُنتج التابع clone نسخةً سطحيةً (shallow copy) من الكائن المعطى. تُنسَخ متغيرات النسخة (instance variables) ولكن لا تُنسَخ الكائنات التي تشير إليها. يَنسَخ التابع clone حالة الكائن المجمدة (إلا إذا كان وسيط الكلمة المفتاحية freez: مساويًا للقيمة falsefalse) والتالفة (tainted). انظر أيضًا النقاش في صفحة التابع Object.dup. قد يمتلك هذا التابع سلوكًا محدّدًا بالصنف (class-specific). إذا كان كذلك، سيُوثَّق السلوك تحت التابع .initialize_copy من نفس الصنف. البنية العامة clone(freeze: true) → an_object
المعاملات freeze وسيطُ مسمى (keyword argument) يأخذ القيمة ...
التابع Struct.hash في روبي
يعيد التابع hash القيمة hash استنادًا إلى محتويات هذه البنية. البنية العامة hash→ integer
القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash استنادًا إلى محتويات البنية المعطاة. انظر أيضًا التابع inspect: يعيد سلسلة نصية تحتوي وصفًا لهذه البنية. التابع Object.hash: يحسب القيمة hash للكائن الذي استدعي معه. مصادر قسم التابع hash في الصنف Struct في توثيق روبي الرسمي.
التابع Process.kill في روبي
يرسل التابع kill إشارة محدَّدة إلى عملية ذات مُعرِّف معطى أو إلى جميع العمليات التي معرِّف المجموعة التي تملكه مساويًا إلى معرِّف المجموعة للعملية المستدعية. البنية العامة kill(signal, pid, ...) → integer
المعاملات signal عدد صحيح يمثِّل رقم الإشارة أو سلسلة نصية تمثِّل اسم الإشارة بحسب POSIX (مع أو بدون السابقة SIG). إن كان عددًا صحيحًا موجبًا، إن كان عددًا سالبًا (يبدأ بإشارة الناقص)، فستُقتَل مجموعات العملية (process groups) بدلًا من العمليات. ليست جميع الإشارات مدعومة على كل المنصات. مفاتيح وقيم ...
التابع Numeric.floor في روبي
يعيد التابع floor أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة محدَّدة. ينفِّذ الصنف Numeric هذه العملية عن طريق تحويل قيمة العدد المعطى إلى النوع Float ثم استدعاء التابع Float.floor. البنية العامة floor([ndigits]) → integer or float
المعاملات ndigits عدد يمثل دقة المنازل العشري. القيمة الافتراضية هي: 0. القيمة المعادة يعاد عدد صحيح أو عشري يمثِّل أكبر عدد من الأعداد الأصغر من أو تساوي العدد الذي استُدعي معه وبدقة ndigits للمنازل العشرية فيه. انظر أيضا ...
التابع IO.binread في روبي
يفتح التابع binread الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات. يتأكد التابع binread من إغلاق الملف قبل إنهاية العملية. يفتح التابع الملف في الوضع "rb:ASCII-8BIT". البنية العامة binread(name, [length [, offset]] )→ string
المعاملات name اسم الملف المراد فتحه وجلب البيانات منه. length عدد صحيح يمثل عدد البايتات المراد جلبها من الملف. القيمة الافتراضية هي قراءة وجلب البيانات بدءًا من ...
التابع String.undump في روبي
يعيد التابع undump نسخة عن السلسلة النصية التي استدعي معها مع حذف جميع المحارف المُهربة منها. البنية العامة undump → new_str
القيمة المعادة تُعاد نسخة عن السلسلة النصية المعطاة مع حذف جميع المحارف المُهربة منها. أمثلة مثال على استعمال التابع undump: "\"hello \\n ''\"".undump #=> "hello \n ''"
انظر أيضًا التابع dump: يُعيد نسخة عن السلسلة النصية مع استبدال المحارف الغير مطبوعة بالرمز nnn\ وتهريب المحارف الخاصة. التابع strip: يعيد نسخة عن السلسلة النصية مع حذف المسافات البيضاء من بداية ...
التابع Fiber.inspect في روبي
يُعدُّ التّابع inspect اسمًا بديلًا (alias) للتّابع to_s. البنية العامة inspect()
انظر أيضا التابع to_s: يُعيد معلوماتٍ عن الليف (fiber) بشكل سلسلةٍ نصيةٍ. مصادر صفحة التابع inspect في الصنف Fiber في توثيق روبي الرسمي.
التابع Float.phase في روبي
يعيد التابع phase القيمة 0 إن كان العدد العشري الذي استُدعي معه موجبًا، أو يعيد القيمة pi خلاف ذلك. البنية العامة phase → 0 or float
القيمة المعادة تعاد القيمة 0 إن كان العدد العشري المعطى موجبًا، أو تعاد القيمة pi خلاف ذلك. انظر أيضا التابع angle: يعيد القيمة 0 إن كان العدد الذي استُدعي معه موجبًا، أو القيمة pi خلاف ذلك. التابع polar: يعيد المصفوفة [num.abs، num.arg] إذ num هو العدد المعطى. مصادر قسم التابع phase في الصنف Float في توثيق روبي الرسمي. ...
التابع String.prepend في روبي
يُلحق التابع prepend السلسلة النصية المُمرَّرة إليه ببداية السلسلة النصية التي استدعيت معه. البنية العامة prepend(other_str1, other_str2,...) → str
المعاملات other_str1 السلسلة النصية الأولى المُراد إلحاقها ببداية السلسلة النصية المُعطاة. other_str2 السلسلة النصية الثانية المُراد إلحاقها ببداية السلسلة النصية المُعطاة. ... السلاسل النصية الأخرى المراد إلحاقها ببداية السلسلة النصية المعطاة. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد إلحاق السلاسل النصية other_str1 و other_str2 و ... ببدايتها. أمثلة مثال على استعمال التابع prepend: a = "!"
a.prepend("hello ", "world") #=> "hello world!"
a ...
التابع SizedQueue.clear في روبي
يزيل التابع clear كل الكائنات من الطابور. البنية العامة clear()
انظر أيضًا التابع new: ينشئ طابورًا ذا طول ثابت. التابع close: يغلق الطابور. مصادر قسم التابع clear في الصنف SizedQueue في توثيق روبي الرسمي.
التابع String.to_f في روبي
يحول التابع to_f الأرقام الموجودة في بداية السلسلة النصية المعطاة إلى عدد عشري. يتجاهل التابع المسافات البيضاء في البادئة، ويهمل جميع الحروف بعد العدد في السلسلة. إذا لم تحتوي بادئة السلسلة على أي عدد، فإن التابع يعيد القيمة 0.0 دون إطلاق أية استثناءات. البنية العامة to_f → float
القيمة المعادة يُعاد العدد العشري المقابل للعدد الموجود في بادئة السلسلة النصية المعطاة، أو تُعاد القيمة 0.0 إذا لم تحتوي بادئة السلسلة على أي عدد. أمثلة مثال على استعمال التابع to_f: "123.45e1".to_f ...
التابع ARGF.each_byte() في روبي
يعيد التابع each_byte قيمة قابلة للعد (enumerator) تتكرر (iterates) على كل قيمة من النوع Byte في الملفات الموجودة في ARGV. يسمح لك هذا التابع بمعالجة الملفات المُمرَّرة من سطر الأوامر كما لو كانت ملفًا واحدًا مكونًا من سلسلة من هذه الملفات المسماة. بعد إعادة البتة (byte) الأخيرة من الملف الأول، ستُعاد البتة الأولى من الملف الثاني. يمكن استخدام التابع ARGF.filename لمعرفة اسم الملف للبتة الحالية. في حال عدم تمرير كتلة برمجية، فسيُعاد كائن من النوع enumerator. البنية العامة each_byte {|byte| block } → ARGF
each_byte → ...
التابع File.mkfifo في روبي
ينشئ التابع mkfifo ملفًا خاصًّا من النوع "أنبوبة مسماة" (FIFO ويدعى أحيانًا named pipe) باسم وأذونات محدَّدة. البنية العامة mkfifo(file_name, mode=0666) => 0
المعاملات file_name اسم الأنبوبة المسماة (FIFO) المراد إنشاؤها. mode نمط أذونات الأنبوبة المسماة المراد إنشاؤها. تُعدَّل هذه القيمة عبر القناع umask للعملية الحالية بالطريقة المعتادة وهي: أذونات الملف المُنشَأ تكون حاصل العملية mode & ~umask. القيمة المعادة تعاد القيمة 0 بعد اكتمال تنفيذ العملية. انظر أيضا التابع link: ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). ...
التابع Module.constants في روبي
يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. تتضمن هذه القائمة أسماء جميع الوحدات والأصناف المحددة في النطاق العام (global scope). البنية العامة constants→ array
القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. أمثلة مثال على استخدام التابع constants: Module.constants.first(4)
# => [:ARGF, :ARGV, :ArgumentError, :Array]
Module.constants.include?(:SEEK_SET) # => false
class IO
Module.constants.include?(:SEEK_SET) # => true
end
انظر أيضا التابع const_set: يضبط قيمة الثابت المعطى عند الكائن المحدد، ...
التابع Process.exit في روبي
يبدأ التابع exit عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. هذا الاستثناء قد يُلتقَط. البنية العامة exit(status=true)
Kernel::exit(status=true)
Process::exit(status=true)
المعاملات status معامل اختياري يُستعمَل لإعادة حالة الشيفرة للبيئة المستدعية. القيمة true والقيمة false للحالة المعادة تشيران إلى النجاح والفشل على التوالي. تفسير القيم العددية الأخرى المعطاة يعتمد على نظام التشغيل آنذاك. القيمة الافتراضية هي: true. أمثلة مثال على استعمال التابع exit: begin
exit
puts "never get here"
rescue SystemExit
puts "rescued a SystemExit exception"
end
puts "after begin block"
ينتج عن تنفيذ ...
التابع IO.inspect في روبي
يُعيد التابع inspect سلسلة نصية تصف المجرى الذي استُدعي معه. البنية العامة inspect→ string
القيمة المعادة تعاد سلسلة نصية تصف المجرى المعطى. انظر أيضًا التابع fcntl: يوفر آلية لإصدار أوامر منخفضة المستوى للتحكم في أو الاستعلام عن مجاري د/خالموجهة بالملفات (file-oriented I/O). التابع gets: يجلب السطر التالي من المجرى الذي استدعي معه. مصادر قسم التابع inspect في الصنف IO في توثيق روبي الرسمي.
التابع IO.print في روبي
يكتب التابع print الكائن (أو الكائنات) المُمرَّرة إليه في المجرى الذي استدعي معه ثم يُعيد القيمة nil. يجب أن يكون المجرى مفتوحًا في وضعية الكتابة. سيتم تحويل الكائنات غير النصية إلى سلسلة نصية عبر استدعاء التابع to_s الخاص بها. في حال استدعاء التابع print بدون تمرير أي شيء إليه، فسيطبع محتويات المتغير $_. إن كان فاصل حقل الإخراج ($,) مخالفا للقيمة nil، فسيُدرَج بين الكائنات. وإن كان فاصل سجل الإخراج ($\) مخالفًا للقيمة nil، فسيتم إلحاقه بنهاية المخرجات. البنية العامة print→ nil
print(obj, ...
التابع IO.getbyte في روبي
يجلب التابع getbyte البايت التالي من المجرى الذي استدعي معه. البنية العامة getbyte→ integer or nil
القيمة المعادة يعاد عدد صحيح بين 0 و 255 يمثِّل البايت التالي من المجرى المعطى، أو تعاد القيمة nil عن الوصول إلى نهاية المجرى. أمثلة مثال على استخدام التابع getbyte: f = File.new("testfile")
f.getbyte #=> 84
f.getbyte #=> 104
انظر أيضًا التابع getc: يجلب محرفًا واحدًا من المجرى الذي استدعي معه. التابع gets: يجلب السطر التالي من المجرى الذي استدعي معه. مصادر قسم التابع getbyte ...
التابع InstructionSequence.new في روبي
يأخذ التابع new سلسلة نصية تحوي شيفرات برمجية بلغة روبي، ويُصرّفها (compile) إلى كائن من النوع InstructionSequence. البنية العامة new(source[, file[, path[, line[, options]]]]) → iseq
اختياريًّا، يأخذ التابع new المعاملات file و path و line التي تمثل اسم الملف، والمسار المطلق، ورقم السطر الأول لشيفرة روبي الموجودة في المصدر source؛ هذه المعاملات تمثل بيانات وصفية (metadata) مُرتبطة بالكائن iseq المعاد. يُستخدَم المعامل options، الذي يمكن أن تكون قيمته true أو false أو جدول Hash، لتعديل السلوك الافتراضي لمصرف iseq روبي. لمزيد من ...
التابع Array.reverse في روبي
يعكس التابع reverse ترتيب عناصر المصفوفة التي استُدعيت معه ويضعها في مصفوفة جديدة. البنية العامة reverse → new_ary
القيم المعادة تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة ولكن بترتيب معكوس. أمثلة أمثلة على استخدام التابع reverse: [ "a", "b", "c" ].reverse #=> ["c", "b", "a"]
[ 1 ].reverse #=> [1]
انظر أيضًا التابع reverse!:يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. التابع rotate: ...
التابع FileTest.setgid? في روبي
يتحقق التابع setgid? إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. البنية العامة setgid?(file_name) → true or false
المعاملات file_name اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان البت gid (بت معرِّف المجموعة المالكة) مضبوطًا للملف المحدَّد. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع file?: يتحقق إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. التابع owned?: يتحقق إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. التابع setuid?: يتحقق إن كان البت uid (بت معرِّف المستخدم المالك) ...
التابع File.atime في روبي
يعيد التابع atime زمن آخر وصول إلى ملفٍ محدَّدٍ، أو وقت الإنشاء للملف إن لم يتم الوصول إليه. البنية العامة atime → time
القيمة المعادة يعاد كائن من النوع Time يمثِّل زمن آخر وصول للملف file_name، أو وقت الإنشاء للملف file_name إن لم يتم الوصول إليه. أمثلة مثال على استعمال التابع atime: File.atime("testfile") #=> Wed Apr 09 08:51:48 CDT 2003
انظر أيضا التابع birthtime: يعيد وقت إنشاء ملف محدَّد. التابع ctime: يعيد وقت آخر تغيير أجري على ملف محدَّد. ...
التابع String.to_s في روبي
يعيد التابع to_s السلسلة النصية التي استدعيت معه نفسها. إذا استُعمل التابع مع صنف فرعي من الصنف String، فإنه يحوله إلى كائن من النوع String. البنية العامة to_s → str
to_str → str
القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها إن كانت من الصنف String، أو يعاد كائن من النوع String ناتج عن تحويل الصنف الفرعي المعطى. أمثلة أمثلة على استعمال التابع to_s: "hello".to_s #=> "hello"
123.to_s #=> "123"
انظر أيضًا التابع to_c: يحول السلسلة النصية التي استدعيت معه إلى عدد عقدي. ...
الصنف Queue في روبي
يُنفِّذ الصنف Queue طوابير الانتظار متعدِّدة المنتجين (multi-producer)، ومتعدِّدة المستهلكين (multi-consumer). إنَّه مفيدٌ بشكلٍ خاصٍّ في البرمجة المعتمدة على الخيوط (threaded programming) عندما يتحتَّم على المعلومات أن تُتبادل بأمان بين خيوطٍ (threads) متعدَّدة. يُنفِّذ الصنف Queue كل دلالات القفل المطلوبة. يُنفِّذ الصنف طوابير الانتظار التي من النوع FIFO (من يدخل أولًا يخرج أولًا). في هذا النوع، المهام التي تضاف أولًا في الطابور هي المهام التي تعاد أولًا منه. queue = Queue.new
producer = Thread.new do
5.times do |i|
...
التابع String.reverse! في روبي
يعدل التابع reverse! على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. البنية العامة reverse! → str
القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها بعد عكس ترتيب المحارف فيها. أمثلة أمثلة على استعمال التابع !reverse: a="hello"
a.reverse #=> "olleh"
a #=> "olleh"
انظر أيضًا التابع chop!: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع downcase!: يعدل على السلسلة النصية المعطاة وذلك باستبدال الحروف الكبيرة فيها بنظائرها الصغيرة. التابع reverse: يعكس ترتيب محارف السلسلة ...
التابع Process.exit في روبي
ينهي التابع !exit العملية ويخرج منها مباشرةً. لن تُنفَّذ أية معالجات خروج حينذاك. البنية العامة euid → integer
Process::UID.eid → integer
Process::Sys.geteuid → integer
المعاملات status حالة الخروج المراد إعادتها إلى النظام الأساسي. القيمة الافتراضية هي: false. أمثلة مثال على استعمال التابع !exit: Process.exit!(true)
انظر أيضًا التابع abort: ينهي تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء Kernel.exit(false). التابع exit: يبدأ عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. مصادر قسم التابع !exit في الصنف Process في توثيق روبي الرسمي.
التابع Mutex.sleep في روبي
يحرر التابع sleep القفل (lock)، وينام لعدد محدَّد من الثواني. يطلق الخطأ ThreadError إذا لم يكن الكائن mutex مُقفلًا من قِبَل الخيط (thread) الحالي. عندما يستأنف الخيط عمله، ستحاول تلك المهمة استعادة القفل وتطبيقه. لاحظ أن هذا التابع يمكنه إيقاظ (wakeup) الخيط دون استدعاء Thread.wakeup بشكل صريح كما يحدث، على سبيل المثال، عند تلقي إشارة. البنية العامة sleep(timeout = nil) → number
المعاملات timeout عدد الثواني التي تحدِّد مدة نوم الخيط بعد تحرير القفل. القيمة الافتراضية هي: nil. القيمة المعادة يعاد ...
التابع Module.prepend_features في روبي
يُستدعَى التابع prepend_features في الوحدة المعطاة عندما تُرفق هذه الوحدة في أخرى، وتُمرَّر إليها الوحدة المُستقبِلة (receiving module) في الوحدة التي مُمرِّرت إليه. الإعداد الافتراضي هو إحلال (overlay) ثوابت وتوابع ومتغيرات الوحدة الخاصة بهذه الوحدة في المعامل mod المُمرَّر إن لم تكن هذه الوحدة مضافةً إليه سلفًا أو إلى أحد أسلافه (ancestors). البنية العامة prepend_features(mod)→ mod
المعاملات mod كائن من النوع Module. القيمة المعادة تعاد وحدة من النوع Module. انظر أيضا التابع prepend: يستدعي التابع Module.prepend_features على كل المعاملات المعطاة بترتيب ...
التابع Complex.infinite? في روبي
يعيد التابع infinite? قيمةً تشير إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي منتهية أو غير منتهية (infinite). البنية العامة infinite? → nil or 1
القيمة المعادة تعاد القيمة nil إذا كانت قيمة الطويلة (r) للشكل القطبي من العدد العقدي المعطى منتهية (finite)، أو تعاد القيمة 1+ إن كانت قيمة الطويلة غير منتهية (من الطرف الموجب لمستقيم الأعداد). أمثلة أمثلة عن استخدام معامل التابع infinite?: (1+1i).infinite? ...
التابع String.ord في روبي
يعيد التابع ord العدد الترتيبي (Integer ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) المقابل لأول محرف فى السلسلة النصية المعطاة. البنية العامة ord → integer
القيمة المعادة يُعاد العدد الترتيبي المقابل لأول محرف من محارف السلسلة النصية المعطاة. أمثلة مثال على استعمال التابع ord: "a".ord #=> 97
“hello”.ord #=> 104
انظر أيضًا التابع each_codepoint: يُمرر كل عدد من الأعداد الترتيبية (Integers ordinal) ...
التابع Random.new_seed في روبي
يعيد التابع new_seed قيمةً عشوائية تمثِّل البذرة. يستخدم هذا التابع من قبل التابع new عندما لا تُعيَّن قيمة البذرة كمعاملٍ لذلك التابع. البنية العامة new_seed → integer
القيم المعادة تُعاد قيمةٌ عشوائيَّةٌ للبذرة. أمثلة مثالٌ عن استخدام التابع new_seed: Random.new_seed #=> 115032730400174366788466674494640623225
انظر أيضًا التابع new: يُنشئ مولِّد أعدادٍ شبه عشوائيةٍ (PRNG) باستخدام قيمة محدَّدة للبذرة لضبط الحالة الأولية. التابع seed: يعيد قيمة البذرة التي استُخدمَت في إنشاء المولِّد. التابع srand: يحدِّد بذرة مولد الأعداد شبه العشوائية للنظام بتعيين Random::DEFAULT ...
التابع IO.syswrite في روبي
يكتب التابع syswrite السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write). لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في المجرى، وإلا ستحصل على نتائج غير متوقعة. يُطلق الاستثناء SystemCallError عند حدوث خطأ. البنية العامة syswrite(string)→ integer
المعاملات string سلسلة نصية يراد كتابتها على المجرى. القيمة المعادة يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى. أمثلة مثال على استخدام التابع syswrite: f = File.new("out", "w")
f.syswrite("ABCDEF") #=> 6
انظر أيضًا التابع sysread: ...
التابع ?Queue.closed في روبي
يتحقَّق التابع ?closed إذا كان طابور الانتظار (queue) مغلقًا. البنية العامة closed?
القيم المعادة تُعاد القيمة true إذا كان طابور الانتظار مغلقًا. خلاف ذلك، تعاد القيمة false. انظر أيضًا التابع ?empty : يتحقَّق إذا كان طابور الانتظار فارغًا. التابع close : يغلق الطابور الذي استُدعي معه. التابع clear : يحذف كل الكائنات من الطابور الذي استُدعي معه. مصادر صفحة التابع ?closed في الصنف queue في توثيق روبي الرسمي.
التابع Regexp.compile في روبي
اسم بديل للتابع new. البنية العامة compile(*args)
القيمة المعادة يعاد كائنٌ جديدٌ من النوع Regexp. انظر أيضا التابع new: ينشئ تعبيرًا نمطيًّا جديدًا. مصادر قسم التابع compile في الصنف Regexp في توثيق روبي الرسمي.
التابع Thread.stop في روبي
يوقف التابع stop تنفيذ المهمة الفرعية الحالية، ويضعها في حالة "نوم" (sleep)، ويُجدوٍل (schedules) تنفيذ مهمة فرعية أخرى. البنية العامة stop→ nil
القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع stop: a = Thread.new { print "a"; Thread.stop; print "c" }
sleep 0.1 while a.status!='sleep'
print "b"
a.run
a.join
#=> "abc"
انظر أيضًا التابع start: يشبه التابع new بشكل أساسي إلا أنه عند اشتقاق صنف فرعي (subclassed) من Thread، فإنَّ استدعاء start في ذلك الصنف الفرعي لن يستدعي تابع الصنف الفرعي initialize. مصادر قسم التابع ...
التابع Integer.abs في روبي
يعيد التابع abs القيمة المطلقة للعدد الذي استُدعي معه. البنية العامة abs → integer
القيمة المعادة تعاد القيمة المطلقة للعدد الذي استُدعي معه. أمثلة مثال على استخدام التابع abs: (-12345).abs #=> 12345
-12345.abs #=> 12345
12345.abs #=> 12345
انظر أيضا المعامل -: يعيد ناتج عملية الطرح بين عددين. المعامل *: يعيد ناتج عملية الضرب بين عددين. المعامل +: يعيد ناتج عملية الجمع بين عددين، صنف الكائن الناتج يتعلق بصنف الطرف الثاني للعملية. التابع sqrt: ...
التابع Array.slice! في روبي
يقتطع التابع slice! عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice! العناصر المحذوفة، أو nil إن كان index خارج النطاق. البنية العامة slice!(index) → obj or nil
slice!(start, length) → new_ary or nil
slice!(range) → new_ary or nil
المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر ...
التابع Encoding.name في روبي
يُعيد التّابع name اسم التّرميز الفعلي لترميز محدد. البنية العامة name → string
القيم المعادة تُعاد سلسلةٌ نصّيةٌ (string) تمثّل اسم التّرميز الفعلي للترميز المعطى. أمثلة مثالٌ عن استخدام التابع name: Encoding::UTF_8.name #=> "UTF-8"
انظر أيضًا التّابع aliases: يُعيد الأسماء البديلة وجميع أسماء الترميزات الأصلية المتاحة. التابع find: يبحث عن ترميز باسم محدّد. التابع list: يُعيد قائمةً بالترميزات المُحمّلة. التابع name_list: يُعيد التّابع name_list قائمة بأسماء التّرميزات المتاحة. التّابع inspect: يُعيد سلسلة نصية تمثل الترميز المعطى بشكل يخص المبرمجين فقط. ...
التابع String.chop في روبي
يعيد التابع chop نسخةً عن السلسلة النصية مع حذف المحرف الأخير منها. إذا انتهت السلسلة بالمحرفين r\n\ على الترتيب، فسيحذف التابع هذين المحرفين. إذا استُعمل التابع chop مع سلسلة نصية فارغة،فسيعيد سلسلة نصية فارغة وليس القيمة nil. في أغلب الأحيان، يعتبر التابع chomp بديلاً أكثر أمانًا للتابع chop، لأنه يبقي نسخة السلسلة النصية بدون تغيير في حال لم تنتهِ بالفاصل المُحدد، على عكس التابع chop الذي يحذف المحرف الأخير دومًا. البنية العامة chop → new_str
القيمة المعادة تُعاد نسخة عن ...
التابع ENV.to_h في روبي
ينشئ التابع to_h جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة. البنية العامة to_hash → hash
to_h → hash
القيمة المعادة يعاد كائن من النوع Hash يحوي نسخةً من متغيرات البيئة. انظر أيضًا التابع to_a: يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_h في الصنف ENV في توثيق روبي الرسمي.
التابع Enumerable.slice_after في روبي
يقطِّع التابع slice_after عناصر الكائن القابل للتعداد إلى أجزاء تحدَّد نهايتها عبر نمطٍ محدِّدٍ أو كتلةٍ معطاةٍ ثم يعيد مُعدِّد لكل جزء من الأجزاء الناتجة. البنية العامة slice_after(pattern) → an_enumerator
slice_after { |elt| bool } → an_enumerator
إن كان النمط مطابقًا للعنصر (أي يعيد pattern === elt القيمة true) أو أعادت الكتلة القيمة true للعنصر المُمرَّر إليها، فسيُعدُّ العنصر نهايةً لجزء. يُستدعَى المعامل === والكتلة block من أول عنصر وحتى آخر عنصر من عناصر الكائن القابل للتعداد المعطى. يُنتِج المُعدِّد المعاد العناصر ...
التابع File.lchmod في روبي
يشبه التابع lchmod التابع chmod باستثناء أنه لا يتبع الوصلات الرمزية (أي أنه يغير أذونات الوصلة نفسها وليس الملف الذي تشير إليه). هذا التابع غير متاح في أغلب الأحيان. البنية العامة lchmod(mode_int, file_name, ...) → integer
المعاملات mode_int نمط الأذونات الجديدة المراد تعيينها إلى الملفات المحدَّدة. file_name اسم الملف المراد تغيير أذوناته. ... أسماء الملفات الأخرى المراد تغيير أذوناتها. القيمة المعادة يعاد عدد صحيح يمثِّل عدد الملفات التي غُيِّرت أذوناتها. انظر أيضا التابع chmod: يغيِّر بتات الأذونات لملف أو عدة ملفات ...
التابع Complex.polar في روبي
يعيد التابع polar عددًا عقديًا وفق الشكل القطبي (polar form). الشكل القطبي للعدد العقدي هو: z= r(cosθ + i.sinθ). البنية العامة polar(abs[, arg]) → complex
المعاملات abs يمثّل طويلة (r) العدد العقدي. arg يمثِّل زاوية (θ) العدد العقدي. القيمة المعادة يعيد التابع polar عددًا عقديًا وفق الشكل القطبي إذ يكون abs طويلة العدد العقدي و arg زاويته. أمثلة أمثلة عن استخدام التابع polar لإنشاء عدد عقدي انطلاقًا من الشكل القطبي: Complex.polar(3, 0) ...
التابع TracePoint.raised_exception في روبي
يعيد التابع raised_exception قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. البنية العامة raised_exception()
القيمة المعادة تعاد قيمة الاستثناء الذي تم إطلاقه في الحدث raise:. انظر أيضًا التابع path: يعيد مسار الملف الجاري تنفيذه. مصادر قسم التابع raised_exception في الصنف TracePoint في توثيق روبي الرسمي.
التابع Hash.default في روبي
يعيد التابع default القيمة الافتراضية للمفتاح المُمرَّر إليه؛ أي يعيد القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. البنية العامة default(key=nil) → obj
المعاملات key المفتاح الذي يراد معرفة قيمته الافتراضية. القيمة المعادة تعاد القيمة الافتراضية للمفتاح key وهي القيمة التي سيعيدها الكائن Hash إذا كان المفتاح غير موجود فيه. أمثلة مثال على استعمال التابع default: h = Hash.new ...
عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).