نتائج البحث

الصنف BasicObject هو الصنف الأب لجميع الأصناف في روبي، وهو صنف فارغ. يمكن استخدام الصنف BasicObject لإنشاء هرميات كائنية (object hierarchies) مستقلة عن الهرمية الكائنية للغة روبي، أو لإنشاء مغلفات الكائنات (proxy objects) مثل الصنف Delegator، أو حيث يجب تجنب إفساد مجال الأسماء (namespace pollution) من قبل توابع وأصناف روبي. لتجنب إفساد الصنف BasicObject للمستخدمين الآخرين، يجب إنشاء صنف فرعي من الصنف BasicObject تحت اسم مناسب بدلاً من تعديل BasicObject مباشرةً: class MyObjectSystem < BasicObject end لا يتضمَّن الصنف BasicObject الوحدة Kernel ...

تُضمَّن الوحدة Kernel من طرف الصنف Object، لذلك فتوابعها متاحة في كل كائنات روبي. توابع نسخ الصنف Kernel مُوثّقة في صفحة الصنف Object، أما توابع الوحدة Kernel فهي مُوثقة هنا. تستدعى هذه التوابع بدون مستقبل (receiver)، وبالتالي يمكن استدعاؤها وفق الشكل الدالي: sprintf "%.1f", 1.234 #=> "1.2" توابع الصنف العامة (Public Class Methods) Array يعيد المعامل الممرَّر إليه على شكل مصفوفة (Array). Complex يعيد ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. Float Hash يعيد ناتج التعبير x + ...

يستدعي التابع __send__ (يدعى أيضًا send) التابع الممرَّر إليه مع تمرير وسائط محددة إليه. يُستعمَل الاسم __send__ الخاص بهذا التابع إذا تعارض الاسم send مع اسم تابع موجود مسبقًا في obj. البنية العامة send(symbol [, args...]) → obj __send__(symbol [, args...]) → obj send(string [, args...]) → obj __send__(string [, args...]) → obj المعاملات symbol اسم التابع المُعرَّف المراد استدعاؤه. ...args الوسائط المراد تمريرها إلى التابع المحدد في المعامل symbol. string سلسلة نصية تمثل اسم التابع المراد استدعاؤه. عندما يُعرّف التابع بواسطة سلسلة ...

يَستدعي التابع send التابع المعرَّف برمزٍ (symbol) ويُنفَّذه تلقائيًا ويمرِّر إليه أي معاملاتٍ معطاة. يمكنك استخدام الاسم __send__ البديل إذا تضارب الاسم مع توابع موجودةٍ في الكائن تحمل نفس الاسم. إن عُرِّف التابع عن طريق سلسلةٍ نصية، فستُحوَّل تلك السلسلة إلى رمز. البنية العامة send(symbol [, args...]) → obj __send__(symbol [, args...]) → obj send(string [, args...]) → obj __send__(string [, args...]) → obj المعاملات symbol الرَّمزُ المعرِّف للتابع المُعطى. ...args المعاملات المراد تمريرها إلى التابع. القيم المعادة يُعاد الكائن الناتج عن تنفيذ ...

يعدُّ الصنف Object الجذر الافتراضي لكل كائنات روبي. يَرِث الصنف Object من الصنف BasicObject ما يسمح بإنشاء تسلسلات هرمية بديلة للكائن. تُتاح توابع الكائن لكل الأصناف ما لم يتم تجاهلها (overridden) صراحةً. تندمج الوحدة Kernel ضمن الصنف Object ما يعطي الوصول العام (global) للدّوال المبنية ضمنيًّا في الوحدة. رغم أنَّ توابع النسخة المنشأة من الصنف Object معرَّفةٌ عن طريق الوحدة Kernel، رأينا أن نوثّقهم هنا لمزيد من الوضوح. عند الإشارة (referencing) إلى الثوابت في الأصناف الوارثة من الصنف Object، لا ...

المشكلة شيفرة برمجية متطابقة موجودة في جميع فروع الشَرطيات. الحل نقل الشيفرة البرمجية خارج الشَرطية. مثال قبل إعادة التصميم استدعاء وتنفيذ الدالة ()send في نهاية جميع فروع الكتلة if الشرطية سواءً أكان الشرط محققًا أم لا: في لغة Java: if (isSpecialDeal()) { total = price * 0.95; send(); } else { total = price * 0.98; send(); } في لغة C#‎: if (IsSpecialDeal()) { total = price * 0.95; Send(); } else { total = price * 0.98; ...

يَستدعي التابع public_send التابع المعرَّف برمزٍ (symbol) محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. خلافًا للتابع send، يَستدعي التابع public_send التوابع العامة فقط. إن عُرِّف التابع باستخدام سلسلةٍ نصيةٍ (string)، فستُحوَّل هذه السلسلة إلى رمز. البنية العامة public_send(symbol [, args...]) → obj public_send(string [, args...]) → obj المعاملات symbol الرَّمز المُعرِّف للتابع المراد استدعاءه. string سلسلة نصية تعرِّف التابع المراد استدعاءه.  ستُحوَّل هذه السلسلة إلى رمز إن أعطيت. ...args المعاملات المراد تمريرها إلى التابع الذي يراد استداعاؤه. القيم المعادة يُعاد ...

ينهي التابع abort تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء Kernel.exit(false)‎. إن مُرِّرَت رسالة إلى هذا التابع، فستُكتَب على مجرى الخطأ القياسي (STDERR) قبل إنهاء العملية. البنية العامة abort Kernel::abort([msg]) abort([msg]) المعاملات msg رسالة الخطأ المراد طباعتها على مجرى الخطأ القياسي. انظر أيضًا التابع Kernel.exit: يبدأ عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit. التابع argv0: يعيد اسم الشيفرة البرمجية التي يجري تنفيذها. التابع exit: يبدأ عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. مصادر قسم التابع abort في الصنف Process في ...

ينهي التابع abort تنفيذ العملية على الفور عبر استدعاء Kernel.exit(false)‎. في حال تمرير رسالة إلى التابع، فستُكتَب في المجرى STDERR قبل الإنهاء. البنية العامة abort Kernel::abort([msg]) abort([msg])‎ المعاملات msg الرسالة التي ستُكتب في المجرى STDERR. انظر أيضا التابع at_exit: يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc ويسجله لأجل تنفيذه عند نهاية البرنامج. مصادر قسم التابع abort‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعين التابع name=‎ اسم المهمة الفرعية التي استدعيت معه إلى الاسم المُمرَّر إليه. في بعض أنظمة التشغيل، قد يتم تعيين الاسم إلى pthread و/أو إلى kernel. البنية العامة name=(name)→ string‎ المعاملات name‎ الاسم المراد تعيينه إلى المهمة الفرعية المعطاة. القيمة المعادة يعاد الاسم name على شكل سلسلة نصية بعد تعيينه إلى المهمة الفرعية المعطاة. انظر أيضًا التابع name: يعيد اسم المهمة الفرعية. مصادر قسم التابع name=‎ في الصنف Thread‎ في توثيق روبي الرسمي.

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

يعيد المعامل `` مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell). تُستخدَم الصياغة المضمَّنة ‎%x{...}‎‎ هذا المعامل. تُضبَط حالة العملية (process status) إلى القيمة ‎$?‎‎. البنية العامة `cmd` → string‎ المعاملات cmd يمثل التعليمة المراد تنفيذها. القيمة المعادة يعاد مجرى المخرجات القياسي لتنفيذ تعليمة cmd في صدفة فرعية (subshell). أمثلة مثال على استخدام المعامل ``‎: `date` #=> "Wed Apr ...

يسجل التابع autoload اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة. البنية العامة autoload(module, filename)→ nil‎ المعاملات module سلسلةٌ نصيةٌ أو رمزٌ (symbol) يمثِّل اسم الوحدة. filename اسم الملف. المراد تحميله عن الوصول إلى الوحدة module. القيمة المعادة تعاد القيمة nil عند نجاح العملية. أمثلة مثال على استخدام التابع autoload‎: autoload(:MyModule, "/usr/local/lib/modules/my_module.rb") ‎ انظر أيضا التابع autoload?‎: يعيد اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. ...

يُُسجل التابع autoload اسم الملف المراد تحميله (باستخدام Kernel::require) في أول مرة يتم فيها الوصول إلى الوحدة الممررة (والتي قد تكون سلسلةً نصيةً أو رمزًا) في مجال أسماء الوحدة التي استُدعيت معه. البنية العامة autoload(module, filename)→ nil‎ المعاملات module‎ سلسلة نصية أو رمز يمثل الوحدة. filename‎ اسم الملف. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع autoload‎: module A end A.autoload(:B, "b") A::B.doit # autoloads "b"‎ انظر أيضا التابع autoload?‎: يعيد اسم ...

يبدأ التابع exit عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit. من الممكن التقاط هذا الاستثناء. begin exit puts "never get here" rescue SystemExit puts "rescued a SystemExit exception" end puts "after begin block" ينتج عند تنفيذه: rescued a SystemExit exception after begin block‎ قبل الإنهاء مباشرة، تنفذ روبي كل التوابع والكتل المرتبطة بالشيفرة عبر التابع at_exit، وتنفِّذ كل الكائنات المُنهيَة (object finalizers، راجع ObjectSpace.define_finalizer). at_exit { puts "at_exit function" } ObjectSpace.define_finalizer("string", proc { puts "in finalizer" }) exit ينتج عند تنفيذ الشيفرة: ...

يبحث التابع public_method عن التوابع العامة فقط بشكل مشابه لعمل التابع method. البنية العامة public_method(sym) → method المعاملات sym رمزٌ يشير إلى اسم التابع المراد البحث عنه. القيم المعادة يُعاد التابع الموافق للاسم sym من الكائن المُعطى، أو يُرمى الاستثناء NameError إذا لم توجد توابع موافقة لهذا الاسم. انظر أيضًا التابع method: يبحث عن تابعٍ باسمٍ محدَّد في الكائن المعطى بوصفه مستقبلًا. التابع public_send: يَستدعي التابع المعرَّف برمزٍ محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. التابع send: يَستدعي التابع ...

يبدأ التابع 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" ينتج عن تنفيذ ...

ينشئ التابع pipe زوجًا من طرفي أنبوب (pipe endpoints) متصلين ببعضهما بعضًا ثم يعيدهما على هيئة مصفوفة من الكائنات IO. في حال إعطاء كتلة، ستُستدعى تلك الكتلة، وتعاد قيمتها، مع تمرير أنبوب القراءة وأنبوب الكتابة بعد إنشائهما كوسائط من النوع IO إليها. وسيتم إغلاقهما إن لم يغلقا عند خروج الكتلة. أي أن إغلاق هذين المجريين لن يتسبب في حدوث خطأ. التابع pipe غير متوفر في جميع أنظمة التشغيل. إذا تم تمرير ترميز معين (اسم ترميز أو كائن ترميز) كمعامل إلى التابع، فسيتم ...

يَحذِف التابع remove_instance_variable متغيِّر نسخةٍ باسمٍ محدَّدٍ من الكائن الذي استدعي معه ويُعيد قيمة ذلك المتغيِّر. البنية العامة remove_instance_variable(symbol) → obj المعاملات symbol الرَّمز المعرِّف لمتغير النسخة المراد حذفه. القيم المعادة تعاد قيمة متغير النسخة symbol بعد حذفه من الكائن المعطى. أمثلة مثالٌ عن استخدام التابع remove_instance_variable: class Dummy attr_reader :var def initialize @var = 99 end def remove remove_instance_variable(:@var) end end d = Dummy.new d.var #=> ...

يعرّف التابع define_method تابع نُسخة (instance method) في المُستقبِل (receiver). في حال تمرير كتلة، فستُستخدم كجسم (body) للتابع. تُقيّم هذه الكتلة باستخدام التابع instance_eval، وهو أمر قد يكون مُشكلًا على البعض، لأن define_method خاصة. (لهذا سنحتال ونستخدم التابع send في المثال التالي.) البنية العامة define_method(symbol, method) → symbol define_method(symbol) { block }→ symbol‎ المعاملات symbol‎ رمز. method‎ تابع نُسخة. يمكن أن يكون من النوع Proc أو Method أو UnboundMethod. القيمة المعادة يعاد رمزٌ. أمثلة مثال على استخدام التابع define_method‎: class A ...

يعيد التابع binding  كائنًا من النوع Binding، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء. يمكن استخدام هذا الكائن عند استدعاء eval لتنفيذ الأمر الذي تم تقييمه (evaluated command) في هذه البيئة. البنية العامة binding → a_binding‎ القيمة المعادة يعاد كائنٌ من النوع Binding. أمثلة مثال على استخدام التابع binding‎: def get_binding(param) binding end b = get_binding("hello") eval("param", b) #=> "hello" ‎ انظر أيضا الصنف Binding. مصادر قسم التابع binding‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع __method__  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __method__→ symbol‎ القيمة المعادة يعاد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. التابع __dir__: يعيد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. مصادر ...

يطبع التابع print الكائنات الممررة إليه بالتتابع على المجرى stdout$. إذا كان فاصل حقل الخرج (‎$,‎) يخالف nil، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الخرج (‎$\‎‎‎) يخالف nil، فسيوضع في نهاية المُخرجات. في حال لم تعطَ أية وسائط، فستُطبَع _$. ستُحول الكائنات غير النصية باستخدام التابع to_s. البنية العامة print(obj, ...) → nil‎ المعاملات obj‎ الكائن المراد طباعته. ...‎ كائنات أخرى. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع print‎: print "cat", [1,2,3], 99, "\n" $, = ...

يعيد التابع 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" ...

ينفذ التابع loop الكتلة البرمجية المعطاة بشكل متكرر. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator بدلاً من ذلك. يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إيقاف الحلقة التكرارية. في هذه الحالة، سيعيد التابع loop قيمة "النتيجة" المخزنة في الاستثناء. البنية العامة loop { block } loop→ an_enumerator‎ القيمة المعادة يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إعادة قيمة "النتيجة" المخزنة في الاستثناء. أما في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator. أمثلة مثال على ...

يحول التابع at_exit  الكتلة البرمجية المعطاة إلى كائن من النوع Proc (وبالتالي يربطه في لحظة الاستدعاء) ويسجله لأجل تنفيذه عند نهاية البرنامج. في حالة تسجيل عدة معالجات (handlers)، فستٌنفّذ بترتيب معاكس لتسجيلها. البنية العامة at_exit { block } → proc‎ القيمة المعادة يعاد كائن من النوع Proc. أمثلة مثال على استخدام التابع at_exit‎: def do_at_exit(str1) at_exit { print str1 } end at_exit { puts "cruel world" } do_at_exit("goodbye ") exit الناتج: goodbye cruel world انظر أيضا التابع abort: ينهي التنفيذ على الفور عبر استدعاء Kernel.exit(false)‎. ...

يضبط (Controls) التابع trace_var تعقّبات (tracing) تعيين المتغيرات العامة. البنية العامة trace_var(symbol, cmd ) → nil trace_var(symbol) {|val| block } → nil‎ يحدد الوسيط المعطى symbol المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر cmd (الذي قد يكون سلسلةً نصيةً أو كائن من النوع Proc أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط. المعاملات symbol‎ يحدد المتغير. cmd‎ التعليمة المراد تنفيذها كلما تم تعيين المتغير. القيمة المعادة ...

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

يعيد التابع caller_locations مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects). انظر صفحة Thread::Backtrace::Location لمزيد من المعلومات. البنية العامة caller_locations(start=1, length=nil) → array or nil caller_locations(range)→ array or nil‎ يحدد الوسيط الاختياري start عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام الوسيط length اختياري ثاني لتحديد عدد المدخلات التي ستُعاد من المكدس. يعيد التابع القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي. اختياريًا، يمكنك تمرير مجال range، والذي سيؤدي إلى ...

يكافئ التابع chop  التعبير ‎($_.dup).chop!‎ باستثناء أنّ nil لا تُعاد أبدًا. انظر صفحة !String.chop. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر ‎-‎p/-n. البنية العامة chop→ $_‎ القيمة المعادة يعاد ناتج التعبير ‎($_.dup).chop!‎. انظر أيضا التابع chomp: يكافئ التعبير ‎$_ = $_.chomp( string)‎. مصادر قسم التابع chop‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يحول التابع 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‎ في توثيق روبي الرسمي.

يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد محدَّد من الثواني ثم يعيد عدد الثواني الفعلية (بعد تقريبه) الذي توقفت فيها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى التابع Thread.run. وفي حال استدعاء التابع sleep دون تمرير أي شيء إليه، فسيرسل المهمة الفرعية إلى النوم بشكل دائم. البنية العامة sleep([duration]) → integer‎ المعاملات duration‎ مدة تعليق المهمة الفرعية. قد يكون أي نوع عددي، بما في ذلك الأعداد العشري التي من النوع Float. القيمة ...

يحول التابع Hash المعامل المُمرَّر إليه إلى جدول Hash. ويعيد جدول Hash فارغًا إن كان المعامل المعطى يساوي nil أو []. البنية العامة Hash(arg) → hash‎ المعاملات arg‎ الكائن المراد تحويله إلى جدول Hash. القيمة المعادة يعاد كائن من النوع Hash يحوي قيمة المعامل arg عبر تحويلها باستدعاء التابع arg.to_hash، أو يكون فارغًا إن كان arg يساوي nil أو []. أمثلة مثال على استخدام التابع Hash‎: Hash([]) #=> {} Hash(nil) ...

يحول التابع Integer المعامل المُمرَّر إليه إلى عدد صحيح (Integer). البنية العامة Integer(arg, base=0) → integer‎ تُحوّل الأنواع العددية مباشرة (مع اقتطاع الفواصل العشرية [floating point numbers]). المعامل base المٌعطى يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع String، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر، فسيتم احتساب مؤشرات الأساس (0 و 0b و 0x). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع String.to_i. ...

ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. البنية العامة open(path [, mode [, perm]] [, opt]) → io or nil open(path [, mode [, perm]] [, opt]) {|io| block } → obj‎ في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج. إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة ...

يكافئ التابع chomp التعبير ‎$_ = $_.chomp( string)‎. انظر صفحة String.chomp. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر ‎-‎p/-n. البنية العامة chomp→ $_ chomp(string) → $_‎ القيمة المعادة يعاد ناتج التعبير ‎$_ = $_.chomp( string)‎. انظر أيضا التابع chop: يكافئ التعبير ‎($_.dup).chop!‎ ، باستثناء أنّ nil لا تُعاد أبدًا. مصادر قسم التابع chomp‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يكافئ التابع printf التعبير التالي: io.write(sprintf(string, obj, ...))‎ أو التعبير التالي: $stdout.write(sprintf(string, obj, ...))‎ البنية العامة printf(io, string [, obj ... ]) → nil printf(string [, obj ... ]) → nil‎ المعاملات io‎ مجرى من النوع IO ستكتب عليه البيانات. string‎ السلسلة النصية المراد طباعتها. obj ...‎ كائنات أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد طباعة السلسلة string على مخرج الخرج القياسي أو المجرى io إن أعطي. انظر أيضا التابع print: يطبع الكائنات الممرة إليه بالتتابع على المجرى stdout$. ...

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

يكافئ التابع puts التعبير: $stdout.puts(obj, ...)‎ أي يطبع السلسلة النصية المُمرَّرة إليه على مجرى الخرج القياسي. البنية العامة puts(obj, ...) → nil‎ المعاملات obj‎ الكائن المراد طباعته. ...‎ كائنا أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضا التابع format: يعيد السلسلة النصية المعطاة بعد تنسيقها بشكل معين. التابع print: يطبع الكائنات الممررة إليه بالتتابع على المجرى stdout$. التابع putc: أي يطبع القيمة الممرَّرة إليه على مجرى الخرج القياسي. مصادر قسم التابع puts‎ في الصنف Kernel‎ في توثيق روبي ...

يكتب التابع p في مجرى الخرج القياسي للبرنامج ناتج التعبير obj.inspect مباشرة متبوعًا بسطر جديد لكل كائن من الكائنات الممررة إليه. البنية العامة p(obj) → obj p(obj1, obj2, ...) → [obj, ...] p() → nil‎ المعاملات obj‎ كائن الذي ستطبق عليه العملية. obj1 الكائن الأول الذي ستطبق عليه العملية. obj2 الكائن الثاني الذي ستطبق عليه العملية. ... الكائنات الأخرى التي ستطبق عليه العملية. القيمة المعادة يعاد ناتج التعبير obj.inspect. أمثلة مثال على استخدام التابع p‎: S = Struct.new(:name, :state) s ...

يعيد التابع __callee__ اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __callee__→ symbol‎ القيمة المعادة يعاد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __dir__: يعيد المسار المطلق القانوني لمجلد الملف الذي استُدعي هذا التابع منه. التابع __method__: يعيد  الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). مصادر قسم التابع ‎__callee__‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يتحقق التابع block_given?‎ إذا كان yield سينفذ كتلةً برمجيةً في السياق الحالي. الشكل iterator?‎‎ صار شبه مهمل. البنية العامة block_given?→ true or false‎ القيمة المعادة تُعاد القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الحالي. أمثلة مثال على استخدام التابع block_given?‎: def try if block_given? yield else "no block" end end try #=> "no ...

يعيد التابع format السلسلة النصية المعطاة بعد تنسيقها بشكل معين. البنية العامة format(format_string [, arguments...] )→ string‎ المعاملات format_string‎ السلسلة التي تحدد التنسيق. داخل سلسلة التنسيق format_string، ستُنسخ كل المحارف إلى السلسلة النصية الناتجة باستثناء سلسلة التنسيق (format sequences). صيغة سلسلة محارف التنسيق تأخذ الشكل التالي: %[flags][width][.precision]type‎ تتألف سلسلة محارف التنسيق من علامة النسبة المئوية، متبوعةً بثلاث حقول اختيارية هي: flags و width و precision ثم تنتهي بمحرف يحدد حقل النوع type. يتحكم حقل النوع في كيفية تأويل الوسيط المقابل sprintf، ...

يستبدل التابع exec العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى والذي يمكن أن يأخذ أحد الأشكال التالية: الأمر الوصف exec(commandline)‎ أحد أوامر سطر الأوامر (command line) والذي يُمرّر إلى الصدفة (shell) القياسية. exec(cmdname, arg1, ...) ‎ اسم أمر (command name) ووسيط واحد أو أكثر (بدون صدفة). exec([cmdname, argv0], arg1, ...)‎ اسم أمر وكائن argv، مع إمكانية إضافة وسائط أخرى (بدون صدفة shell). في الشكل الأول، تؤخذ السلسلة النصية باعتبارها أمرًا يراد تنفيذه في سطر أوامر، ثم تعمل الصدفة على ...

يقيّم (Evaluates) التابع eval تعبيرات روبي الموجودة في سلسلة نصية. البنية العامة eval(string [, binding [, filename [,lineno]]]) → obj‎ إذا أعطي المعامل binding، فسيُجرَى التقييم في السياق الخاص به. في حال تمرير المعاملين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء الحاصلة في الصياغة. المعاملات string‎ سلسلة نصية تحتوي تعبيرات روبي. binding‎ كائن من النوع Binding. في حال تمريره، فسيُجرى التقييم في السياق الخاص به. filename‎ يُستخدم عند الإبلاغ عن أخطاءٍ في الصياغة. lineno‎ يُستخدم عند الإبلاغ عن ...

يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة command أو الكتلة المعطاة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة تساوي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا ...

يعيد التابع __dir__ المسار المطلق الأساسي (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. هذا يعني أنه سيتم استبيان الوصلات الرمزية في المسار. إذا كان __FILE__ يساوي nil، فسيعيد التابع __dir__ القيمة nil أيضًا. القيمة المعادة تساوي File.dirname(File.realpath(__FILE__))‎. البنية العامة __dir__→ string‎ القيمة المعادة يعاد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. إذا كان __FILE__ يساوي nil، فستُعاد القيمة nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). التابع __method__: يعيد الاسم الذي ...

يعيد التابع String المعامل المعطى على شكل سلسلة نصية (String). يحاول التابع String في البدء استدعاء التابع to_str ثم التابع to_s. البنية العامة String(arg)→ string‎ المعاملات arg القيمة المراد تحويلها إلى سلسلة نصية. القيمة المعادة تعاد سلسلة نصية تحوي قيمة المعامل arg المعطى. أمثلة مثال على استخدام التابع String‎: String(self) #=> "main" String(self.class) #=> "Object" String(123456) #=> "123456" ‎ انظر أيضا التابع Array: يعيد المعامل المعطى على شكل مصفوفة (Array). التابع Integer: يحول ...

يُنهِي التابع exit!‎ العملية على الفور. لا يتم تنفيذ أي معالجات إنهاء (exit handlers). وتعاد الحالة إلى النظام الأساسي (underlying system) كحالة الخروج (exit status). البنية العامة exit!(status=false)‎ المعاملات status‎ الحالة المراد إعادتها إلى النظام الأساسي كحالة الخروج (exit status). أمثلة مثال على استخدام التابع exit!‎: Process.exit!(true) انظر أيضا التابع exit: يبدأ التابع عملية إنهاء البرنامج النصي لروبي، عن طريق إطلاق استثناء SystemExit. التابع at_exit: يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc. مصادر قسم التابع exit!‎ في الصنف Kernel‎ في توثيق ...

ينفذ التابع spawn تعليمة محددة، ثم يعيد معرفها (pid). البنية العامة spawn([env,] command... [,options]) → pid spawn([env,] command... [,options]) → pid‎ يشبه التابعُ spawn التابعَ system باستثناء أنّه لا ينتظر إلى أن ينتهي تنفيذ الأمر. يجب على العملية الأب (parent process) أن تستخدم التابع Process.wait لتحصيل حالة الإنهاء للعملية الفرعية، أو تستخدم Process.detach لتسجيل عدم الاهتمام بحالتها؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات ميتة (zombie processes). التابع spawn لديه مجموعة من الخيارات لتحديد خاصيات العملية: env: hash name => ...

عند استدعاء التابع require_relative، ستحاول روبي تحميل المكتبة التي مُرِّر اسمها إليه نسبةً إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق الخطأ LoadError. إذا تم تحميل الملف، ستُعاد القيمة true، وإلا فستُعاد القيمة false. البنية العامة require_relative(string) → true or false‎ المعاملات string‎ سلسلة نصية تمثِّل اسم المكتبة المراد تحميلها. القيمة المعادة تُعاد القيمة true إذا تم تحميل المكتبة string، أو تعاد القيمة false خلاف ذلك. انظر أيضا التابع require: يُحمِّل ميزة محدَّدة ثمَّ يعيد true في حال نجح في ذلك، ...

في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية ‎-W0) ، فإنّ التابع warn لن يفعل شيئًا. خلا ذلك، سيُحوّل كل الرسائل المُمرَّرة إليه إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهايتها إن لم تكن منتهيةً بسطر جديد، ثم يستدعي التابع Warning.warn، ويمرر إليه تلك السلسلة النصية. warn("warning 1", "warning 2") <em>produces:</em> warning 1 warning 2‎ البنية العامة warn(msg, ...)→ nil‎ المعاملات msg‎ الرسالة الممررة. ...‎ رسائل أخرى القيمة المعادة تعاد القيمة nil. انظر أيضا التابع raise: ...

ينقل التابع throw الضبط (control) إلى نهاية الكتلة catch المُترقبة للوسم المعطى (tag). إذا لم يكن هناك كتلة catch لذلك الوسم، فسيطلق الخطأ UncaughtThrowError. يوفر الوسيط الاختياري الثاني في حال تمريره قيمة لتُعيدها الكتلة catch، وإلا فستعيد nil. للحصول على بعض الأمثلة، انظر صفحة التابع catch. البنية العامة throw(tag [, obj])‎ المعاملات tag‎ الوسم الذي تترقبه الكتلة catch. obj‎ وسيط اختياري يوفر -في حال تمريره- قيمة لتُعيدها الكتلة catch. انظر أيضا التابع catch: ينفذ كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ ...

يجعل التابع set_trace_func المعامل المعطى كمعالج للتعقب، أو يعطل التعقب إن كان الوسيط يساوي nil. ملاحظة: أصبح هذا التابع مهملًا، لذا يُرجى استخدام التابع TracePoint بدلاً منه. يقبل proc ستة معاملات هي: اسم حدث اسم ملف رقم سطر معرف كائن (object id) كائن ربط (binding) اسم صنف يستدعى proc كلما وقع حدث. الأحداث هي: الحدث الوصف c-call استدعاء برنامج فرعي في لغة C. c-return العودة من برنامج فرعي في لغة C. call استدعاء تابع من توابع روبي. class بدء تعريف ...

يكافي التابع proc التعبير Proc.new. البنية العامة proc{ |...| block } → a_proc‎ القيمة المعادة يعاد كائن جديد من النوع Proc. انظر أيضا انظر صفحة الصنف Proc. مصادر قسم التابع proc‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع local_variables مصفوفة تضم أسماء المتغيرات المحلية الحالية. البنية العامة local_variables → array‎ القيمة المعادة تعاد مصفوفة تضم أسماء المتغيرات المحلية الحالية. أمثلة مثال على استخدام التابع local_variables‎: fred = 1 for i in 1..10 # ... end local_variables #=> [:fred, :i]‎ انظر أيضا التابع global_variables: يعيد مصفوفةً تضم أسماء المتغيرات العامة (global variables). مصادر قسم التابع local_variables‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يكافئ التابع sub التعبير ‎‎‎$_‎.sub( args )‎ ، باستثناء أنه سيتم تحديث ‎$_‎ إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر ‎-p/-n. البنية العامة sub(pattern, replacement)→ $_ sub(pattern) {|...| block } → $_‎ القيمة المعادة يعاد ناتج استدعاء التعبير ‎‎‎$_‎.sub( args )‎. انظر أيضا التابع gsub: يكافئ التعبير ‎$_.gsub...‎، باستثناء أنه سيتم تحديث ‎$_‎ في حال حدوث استبدال. مصادر قسم التابع sub‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

ينفذ التابع catch كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ الكتلة بشكل طبيعي، وسيعيد catch قيمة آخر تعبير تم تقييمه. catch(1) { 123 } # => 123 إذا استُدعي throw(tag2, val)‎، فستبحث روبي في المكدس (stack) عن كتلة التابع catch، التي يكون العنوان tag الخاص بها نفس القيمة object_id الخاص بالعنوان tag2. وعند العثور عليه، يتوقف تنفيذ الكتلة وتُعاد val (أو القيمة nil إذا لم يتم تمرير وسيط ثاني ...

يكافئ التابع lambda التعبير Proc.new، باستثناء أنّ الكائنات Proc الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها. البنية العامة lambda { |...| block } → a_proc‎ القيمة المعادة يعاد ناتج الاستدعاء Proc.new. انظر أيضا الصنف Proc. مصادر قسم التابع lambda‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

في حال استدعاء التابع fail بدون تمرير أي معامل، فسيُطلق الاستثناء في ‎$!‎‎‎‎ أو يطلق الخطأ RuntimeError إذا كان ‎$!‎ يساوي nil. في حال تمرير سلسلة نصية فقط، فسيُطلَق الخطأ RuntimeError مع إظهار هذه السلسلة النصية كرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسم الصنف Exception (أو كائنًا يعيد كائنًا من النوع Exception عند إرسال رسالة استثناء). يحدِّد الوسيط الاختياري الثاني الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُلتقَط الاستثناءات بواسطة الجملة rescue من الكتل ...

يعيد التابع 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 | ...

استدعاء التابع raise بدون تمرير أي معامل يُطلق الاستثناء في ‎$!‎‎‎‎ أو يطلق الخطأ RuntimeError إذا كان ‎$!‎ يساوي nil. في حال تمرير سلسلة نصية فقط، فسيُطلَق الخطأRuntimeError مع إظهار هذه السلسلة النصية كرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسم الصنف Exception (أو كائنًا يعيد كائنًا من النوع Exception عند إرسال رسالة استثناء). يحدِّد الوسيط الاختياري الثاني الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُلتقَط الاستثناءات بواسطة الجملة rescue من الكتل begin...end. البنية العامة raise raise(string) raise(exception [, string [, array]])‎ المعاملات string‎ سلسلة نصية تمثل الرسالة المراد إظهارها ...

يشبه التابع readline التابع gets باستثناء أنّه يطلق الخطأ EOFError عند الوصول إلى نهاية الملف. البنية العامة readline(sep=$/) → string readline(limit)→ string readline(sep, limit) → string‎ المعاملات sep‎ يمثل الحد الفاصل الذي ستتوقف عملية القراءة عنده وتعاد البيانات المقروءة. limit‎ الحد الأقصى للبيانات المراد قراءتها. القيمة المعادة يعيد البيانات المقروءة في سلسلة نصية حتى بداية كل سطر أو حتى الوصول إلى الفاصل sep. انظر أيضا التابع readlines: يعيد مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته. مصادر قسم التابع ...

يحمّل التابع load وينفّذ برنامج روبي في الملف المعطى. في حال لم لميكن بالإمكان استبيان مسار الملف المطلق (absolute path)، فسيتم البحث عن الملف في مجلدات المكتبة الموجودة في ‎$:‎. إذا كان الوسيط الاختياري wrap يساوي true، فسيُنفذ النص البرمجي المحمّل كوحدة مجهولة (anonymous module)، لحماية مجال الأسماء الخاص بالبرنامج المُستدعَى. لن يتم نشر أيّ من المتغيرات المحلية الموجودة في الملف الذي تم تحميله تحت أي ظرف من الظروف في بيئة التحميل. البنية العامة load(filename, wrap=false)→ true‎ المعاملات filename‎ اسم ...

يجري التابع test عدة اختبارات على ملف واحد أو على ملفين. البنية العامة test(cmd, file1 [, file2] ) → obj‎ المعاملات cmd‎ يحدد الاختبار المراد تطبيقه. اختبارات File التي تطبَّق على ملف واحد هي: المعامل cmd نوع القيمة المعادة وصف "A" Time توقيت آخر دخول إلى الملف file1. "b" قيمة منطقية يعيد True إن كان الملف file1 جهازًا كتليًّا (block device). "c" قيمة منطقية يعيد True إن كان file1 من النوع جهازًا محرفيًّا (character device). "C" Time توقيت آخر تغيير ...

ينفذ التابع system الأمر المُمرَّر إليه في صدفة فرعية (subshell). البنية العامة system([env,] command... [,options]) → true, false or nil‎ المعاملات env‎ بيئة التنفيذ. يعد هذا المعامل الذي من النوع Hash مماثلة تمامًل لمعامل التابع exec و spawn. انظر صفحة spawn لمزيد من التفاصيل. command...‎ التعليمة المراد تنفيذها. تأخذ التعليمة command…‎ أحد الأشكال التالية. شكل المعامل command…‎ الوصف commandline تعليمة نصية تُمرر إلى الصدفة القياسية cmdname, arg1, ...‎ تعليمة نصية تُمرر إلى الصدفة القياسية ‎[cmdname, argv0], arg1, ...‎ تعليمة ووسيط ...

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

يستدعي التابع select دالة النظام select(2)‎، إذ يعمل على مراقبة المصفوفات الكائنات IO المعطاة، وينتظر حتى يصبح أحد تلك الكائنات أو أكثر جاهزًا للقراءة، وجاهزًا للكتابة، ومالكًا لاستثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من الكائنات IO السابقة. سيعيد التابع القيمة nil إذا تم إعطاء قيمة للمهلة الزمنية timeout، ولم يكن هناك أي كائن جاهز خلال هذه الفترة. يراقب التابع IO.select المخزن المؤقت (buffer) للكائنات IO لاختبار قابليتها للقراءة. إذا لم يكن المخزن المؤقت ...

يتحقق التابع iterator?‎ إذا كان yield سينفذ كتلة برمجية في السياق الراهن. لقد أصبح الشكل ‎iterator?‎ مهملًا إلى حد ما. البنية العامة iterator?→ true or false‎ القيمة المعادة تعاد القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الراهن. وإلا فستعاد false. أمثلة مثال على استخدام التابع iterator?‎: def try if block_given? yield else "no block" end end try ...

يعيد التابع readlines مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته. يشبه هذا التابع التابع gets( sep )‎. البنية العامة readlines(sep=$/) → array readlines(limit)→ array readlines(sep, limit) → array‎ المعاملات sep‎ يمثل هذا الوسيطُ الفاصل السطري بين البيانات المراد وضعها في عناصر المصفوفة المعادة. limit‎ يمثل هذا الوسيطُ الحد الأقصى للبيانات المقروءة. القيمة المعادة تعاد مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته حتى نهايته. انظر أيضا التابع readline: يقرأ التابع سطرًا واحدًا من أسطر الملف ...

يولد التابع callcc كائنًا من النوع Continuation، والذي يُمرّر إلى الكتلة البرمجية المعطاة. تحتاج إلى أن تستورد 'continuation' عبر require قبل استخدام هذا التابع. يؤدي تنفيذ cont.call إلى خروج التابع callcc (كما سيقع خلال نهاية الكتلة). القيمة التي يعيدها callcc هي قيمة الكتلة، أو القيمة المُمرّرة إلى cont.call. انظر صفحة الصف Continuation لمزيد من التفاصيل. انظر أيضًا صفحة التابع throw للتعرف على آلية بديلة لتخفيف مكدس الاستدعاءات (call stack). البنية العامة callcc {|cont| block } → obj‎ القيمة المعادة تعاد ...

يزيل التابع untrace_var التعقب (tracing) للأمر cmd المعطى على المتغير العام المحدد ثم يعيد القيمة nil. في حال عدم تحديد الأمر cmd، فسيزيل التعقب نهائيًا لهذا المتغير، ثم يعيد مصفوفة تحتوي على التعليمات المٌزالة فعلًا. البنية العامة untrace_var(symbol [, cmd] )→ array or nil‎ المعاملات symbol‎ يمثل المتغير. cmd‎ الأمر الذي سيُزال عنه التعقب. القيمة المعادة تعاد القيمة nil في حال تمرير المعامل cmd، وإلا فستُعاد مصفوفة تحتوي على التعليمات المٌزالة فعلًا. انظر أيضا التابع trace_var: يضبط تعقّبات (tracing) تعيين المتغيرات ...

يكافئ التابع gsub التعبير ‎$_.gsub...‎، باستثناء أنه سيتم تحديث ‎$_‎ في حال حدوث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر ‎-p/-n. البنية العامة gsub(pattern, replacement) → $_ gsub(pattern) {|...| block } → $_‎ القيمة المعادة يعاد ناتج استدعاء التعبير ‎$_.gsub...‎. انظر أيضا التابع gets: يعيد السطر التالي من قائمة الملفات في ARGV (أو ‎$‎‎*‎)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. مصادر قسم التابع gsub‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يستدعي التابع syscall دالة نظام التشغيل المحددة بواسطة المعامل المُمرَّر إليه ويعيد نتيجة هذه الدالة أو يطلق الخطأ SystemCallError في حال فشل استدعائها. وسائط الدالة المُستدعاة يمكن أن تمريرها إلى التابع بعد تمرير رقم تلك الدالة. يجب أن تكون تلك الوسائط إما سلاسل نصية أو أعدادًا صحيحةً. يُمرّر كائن من النوع String كمؤشر (pointer) لتسلسل البايتات (byte sequence) بينما يمُرَّر كائن من النوع Integer كعدد صحيح له نفس حجم بتات (bit size) المؤشر. الحد الأقصى للوسائط التي يمكن تمريرها هو ...

يعيد التابع global_variables مصفوفةً تضم أسماء المتغيرات العامة (global variables). البنية العامة global_variables → array‎ القيمة المعادة تعاد مصفوفةٌ تضم أسماء المتغيرات الكلية. أمثلة مثال على استخدام التابع global_variables‎: global_variables.grep /std/ #=> [:$stdin, :$stdout, :$stderr]‎ انظر أيضا التابع local_variables: يعيد مصفوفة تضم أسماء المتغيرات المحلية الحالية. مصادر قسم التابع global_variables‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يولد التابع rand عددًا شبه عشوائي يقع ضمن مجال محدَّد. البنية العامة rand(max=0) → number‎ إن استدعي التابع rand بدون تمرير معاملات إليه، أو إن كان max.to_i.abs == 0، فسيعيد التابع rand عددًا عشريًا شبه عشوائي (pseudo-random) محصورًا في المجال 0.0 و 1.0 (يدخل 0.0 ضمن المجال بينما لا يدخل 1.0). إذا كان max.abs أكبر من أو يساوي 1، فسيعيد rand عددًا صحيحًا عشوائيًا أكبر من أو يساوي 0، وأصغر من max.to_i.abs. إذا كان المعامل المعطى مجالًا (من النوع Range)، فسيعيد ...

يعيد التابع caller مكدس التنفيذ الحالي (execution stack)، والذي هو مصفوفة تحتوي على سلاسل نصية بالشكل file:line أو `file:line: in `method. البنية العامة caller(start=1, length=nil) → array or nil caller(range) → array or nil‎ يحدد الوسيط الاختياري start عدد مدخالات المكدس الأولية (initial stack entries) التي ستٌحذف من الجزء العلوي من المكدس. يمكن استخدام وسيط اختياري ثاني length لتحديد عدد المدخلات التي ستُعاد من المكدس. يعيد التابع caller القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي. اختياريًا، ...

يعيد التابع sprintf السلسلة النصية المُمرَّرة إليه بعد تنسيقها بنمط معيَّن. داخل سلسلة التنسيق، تُنسَخ كل محارفها في السلسلة النصية الناتجة باستثناء سلسلة التنسيق (format sequences). البنية العامة sprintf(format_string [, arguments...] ) → string‎ المعاملات format_string‎ السلسلة التي تحدد التنسيق. داخل سلسلة التنسيق format_string، ستُنسخ كل المحارف إلى السلسلة النصية الناتجة باستثناء سلسلة التنسيق (format sequences). صيغة سلسلة محارف التنسيق تأخذ الشكل التالي: %[flags][width][.precision]type‎ تتألف سلسلة محارف التنسيق من علامة النسبة المئوية، متبوعةً بثلاث حقول اختيارية هي: flags و width ...

يجلب التابع gets (ويسندها إلى ‎$_‎) السطر التالي من قائمة الملفات في المجرى ARGV (أو ‎$‎‎*‎)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. يعيد التابع القيمة nil عند الوصول إلى نهاية الملف. في حال تمرير عدة أسماء ملفات إلى ARGV، فسيقرأ التابع gets(nil)‎ محتويات الملفات، واحدًا في كل مرة بالتتالي. أسلوب البرمجة الذي يستخدم ‎$_‎ كوسيط ضمني أصبح استخدامه أقل شيوعًا في مجتمع روبي. البنية العامة gets(sep=$/ [, getline_args]) → string or ...

يُحمِّل التابع require ميزة محدَّدة ثمَّ يعيد true في حال نجح في ذلك، أو false إذا كانت الميزة (feature) مُحملة سلفًا. ستكون كل الثوابت والمتغيرات العامة (global) الموجودة في الملف المصدري المُحمل متاحةً في مجال أسماء البرنامج المُستدعِي (calling program) العام (global namespace). لكن لن تنتشر المتغيرات المحلية في بيئة التحميل. البنية العامة require(name) → true or false‎ المعاملات name‎ اسم الملف المراد تحميله. إذا لم يكن بالإمكان استبيان اسم الملف إلى مسار مطلق (absolute path)، فسيتم البحث عنه في ...

يكافئ التابع putc التعبير التالي: $stdout.putc(int) أي يطبع القيمة الممرَّرة إليه على مجرى الخرج القياسي. راجع توثيق التابع IO.putc لمزيد من المعلومات حول الأحرف متعددة البايتات (multi-byte characters). البنية العامة putc(int)→ int‎ المعاملات int‎ عدد صحيح يراد طباعته. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضا التابع puts: يكافئ التابع puts التعبير ‎$stdout.puts(obj, ...)‎. مصادر قسم التابع putc‎ في الصنف Kernel‎ في توثيق روبي الرسمي.

يعيد التابع Array المعامل الممرَّر إليه على شكل مصفوفة (Array). البنية العامة Array(arg) → array‎ في البدء، يحاول التابع Array استدعاء to_ary على arg، ثم يستدعي to_a. إذا لم يستجب arg إلى كل من to_ary و to_a، فستُعاد مصفوفة Array أحادية تحوي arg. إذا لم تكن القيمة المٌعادة من to_ary أو to_a من الصنف Array، فسيٌطلق الخطأ TypeError. المعاملات arg‎ الكائن المراد تحويله إلى مصفوفة. القيمة المعادة يعاد المعامل arg المعطى على شكل مصفوفة. أمثلة مثال على استخدام ...

يطبِّق المعامل % السلسلة النصية الواقعة على يساره التي تعد سلسلة تنسيق معيارية على الكائن المعطى الواقع على يمينه ثم يعيد الناتج. إن حوت سلسلة التنسيق أكثر من من عنصر نائب، فيجب أنذاك أن يكون الكائن الذي ستطبق عليه مصفوفةً أو كائنًا من النوع Hash يحوي القيم التي ستأخذ مكان العناصر النائبة المقابلة. البنية العامة str % arg → new_str المعاملات str سلسلة التنسيق التي ستُطبَّق على محتوى المعامل arg. لمزيد من التفاصيل حول صياغة سلسلة التنسيق، اطلع على صفحة ...

يشبه التابع enum_for التابع Kernel.to_enum باستثناء أنه يعيد مُعدِّدًا كسولًا (كائن من النوع Enumerator::Lazy). يجعل هذا من السهل تعريف توابع الصنف Enumerable التي ستبقى كسولة بشكل طبيعي إن استدعيت من مُعدِّد كسول (lazy enumerator). البنية العامة enum_for(method = :each, *args) → lazy_enum enum_for(method = :each, *args){|*args| block} → lazy_enum المعاملات method تابع. القيمة الافتراضية هي: each:. args الوسائط المُمرَّرة إلى التابع method. القيمة المعادة يعاد مُعدِّدٌ كسولٌ (كائن من النوع Enumerator::Lazy). أمثلة المثال التالي هو تكملة للمثال الموجود في صفحة التابع Kernel.to_enum: # ...

يشبه التابع to_enum التابع Kernel.to_enum باستثناء أنه يعيد مُعدِّدًا كسولًا (كائن من النوع Enumerator::Lazy). يجعل هذا من السهل تعريف توابع الصنف Enumerable التي ستبقى كسولة بشكل طبيعي إن استدعيت من مُعدِّد كسول (lazy enumerator). البنية العامة to_enum(method = :each, *args) → lazy_enum to_enum(method = :each, *args) {|*args| block} → lazy_enum المعاملات method تابع. القيمة الافتراضية هي: each:. args الوسائط المُمرَّرة إلى التابع method. القيمة المعادة يعاد مُعدِّدٌ كسولٌ (كائن من النوع Enumerator::Lazy). أمثلة المثال التالي هو تكملة للمثال الموجود في صفحة التابع Kernel.to_enum: ...

يبحث التابع method عن تابعٍ باسمٍ محدَّد في الكائن المعطى بوصفه مستقبلًا (receiver)، ثمَّ يعيد كائنًا من النوع Method لذلك التابع (أو يرمي الاستثناء NameError). يتصرَّف الكائن Method كتعبيرٍ مغلق (closure) في نسخ الكائن الخاصة بالكائن الذي يبحث فيه؛ لذلك، تبقى متغيِّرات النسخة (instance variables) وقيمة self متاحةً. البنية العامة method(sym) → method المعاملات sym رمزٌ يشير إلى اسم التابع المراد البحث عنه. القيم المعادة يُعاد كائنًا من النوع Method يمثِّل التابع الموافق للاسم sym الموجود في الكائن المعطى، أو ...

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

يأخذ التابع disasm كائنًا يمكن أن يكون من النوع Method أو من النوع Proc ويعيد سلسلة نصية تعليمات قابلة للقراءة لهذا المعامل المعطى. البنية العامة disasm(body) → str disassemble(body) → str‎ المعاملات body‎ كائن من النوع Method أو من النوع Proc. القيمة المعادة تعاد سلسلة نصية تحوي المعامل body على هيئة تعليمات قابلة للقراءة. أمثلة مثال على استخدام التابع disasm‎ مع تمرير الكائن Method إليه: # /tmp/method.rb def hello puts "hello, world" end puts RubyVM::InstructionSequence.disasm(method(:hello)) الناتج سيكون: == disasm: <RubyVM::InstructionSequence:hello@/tmp/method.rb>============ 0000 trace ...

يأخذ التابع disassemble المعامل body، والذي سيكون إما كائنًا من النوع Method، أو من النوع Proc، ثم يُعيد سلسلة نصية تحوي هذا المعامل على هيئة تعليمات قابلة للقراءة. البنية العامة disasm(body) → str disassemble(body) → str‎ المعاملات body‎ كائن من النوع Method أو من النوع Proc. القيمة المعادة تعاد سلسلة نصية تحوي محتوى المعامل body على هيئة تعليمات قابلة للقراءة. أمثلة مثال على استخدام التابع disassemble‎ مع كائن من النوع Method: # /tmp/method.rb def hello puts "hello, world" end puts RubyVM::InstructionSequence.disasm(method(:hello))‎ الناتج سيكون: == disasm: ...

يجب أن يوفر لك هذا الدليل كل ما تحتاج إليه للبدء في استخدام أصناف Model. يسمح Active Model لمساعدي Action Pack بالتفاعل مع كائنات روبي الصرفة. يساعد Active Model أيضًا على إنشاء قواعد بيانات ORM مخصصة للاستخدام خارج إطار ريلز. بعد قراءة هذا الدليل، ستتعلم: كيف يعمل نموذج Active Record. كيف تعمل ردود النداء وعمليات التحقق. كيف تعمل المُسَلسِلات (serializers). كيف يتكامل Active Model مع إطار تدويل ريلز (i18n). مقدمة Active Model هو مكتبة تحتوي على وحدات مختلفة تستخدم في ...

مقدمة عندما تفهم كيفية عمل أدوات تطويرك تزداد راحتك وثقتك عند استخدامها. تطوير التطبيقات لا يشذ عن هذه القاعدة. الهدف من هذه الصفحة هو منحك نظرة عامة جيدة وعالية المستوى عن كيفية عمل إطار عمل Laravel. يزول الإحساس "السحري" عن كل شيء عندما تبدأ بتحسين فهمك لمنصة العمل بشكل عام. لا تيأس إن لم تفهم كل المصطلحات على الفور! حاول فقط تكوين فكرة عامة عما يحدث ومعرفتك ستزداد كلما اكتشفت أجزاء جديدة من هذا التوثيق. نظرة عامة عن دورة الحياة ...

تقدّم هذه الوحدة مجموعة من الأصناف الأساسية المجرّدة abstract base calsses (يرمز لها ABC اختصارًا) والتي يمكن استخدامها للتأكد ممّا إذا كان صنف معيّن يقدّم واجهة interface معينة، كأن يكون الصنف قابلًا للتقطيع hashable أو أنّه صنف ربط mapping. ملاحظة: قبل الإصدار 3.3 من اللغة كانت هذه الوحدة جزءًا من وحدة collections. الأصناف الأساسية المجرّدة في الوحدة collections تقدّم وحدة collections الأصناف الأساسية المجرّدة التالية: الصنف الأساسي المجرد يرث من التوابع المجرّدة توابع mixin Container   __contains__   Hashable   ...

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

مقدمة ربّما ولّدت في الماضي نقطة دخول Cron لكل مهمة أردت جدولتها في الخادم. لكن يمكن أن يصبح هذا متعبًا بسرعة لأن الجدولة أصبحت خارج تحكم المصدر وأصبح عليك أن تدخل ب SSH للخادم لإضافة نقاط دخول Cron. يسمح مجدول الأوامر في Laravel بتعريف جدول المهام داخل Laravel بطريقة سلسلة وواضحة. عند استخدام جدولة المهام، تحتاج لنقطة دخول Cron واحدة على الخادم. يُعرّف جدول المهام في التابع schedule من الملف app/Console/Kernel.php. لمساعدتك على البداية، يوجد مثال بسيط معرّف في التابع. ...

مقدمة بالإضافة لدعم إرسال البريد الإلكتروني، يوفّر Laravel دعمًا لإرسال إشعارات بين قنوات توصيل عديدة من ضمنها البريد الإكتروني، والرسائل القصيرة (عبر Nexmo)، و Slack. يمكن أيضًا حفظ الإشعارات في قاعدة البيانات لإظهارها في واجهة الويب. تكون الإشعارات في العادة على شكل رسائل قصيرة، وغنية بالمعلومات، تنبّه المستخدم لشيءٍ حدث في التطبيق. مثلًا، إن كنت تكتب تطبيق فواتير، يمكنك إرسال تنبيه "تمّ خلاص الفاتورة" للمستخدم عبر بريد إلكتروني أو رسالة قصيرة. إنشاء الإشعارات في Laravel، يُمثَّل كل تنبيه بصنف (موجودٌ ...

الوحدات تخدم الوحدات (Modules) غايتين اثنتين في لغة روبي وهما: ميّزة نطاقات الأسماء (namespace)، والخلط الضمني (mix-in) التي سنوضّحها لاحقًا. يستخدم نطاق الأسماء لتنظيم الشيفرة البرمجية ضمن مجموعات مستقلّة تمنع تداخل التوابع والمتغيّرات ذات الأسماء المتشابهة فيما بينها. فعلى سبيل المثال، نطاق الأسماء IRB يوفّر عمليات irb والتي تمنع التصادم مع الاسم الشائع "Context". وظيفة الخلط الضمني (Mix-in) تسمح بمشاركة توابع مشتركة عبر عدد من الأصناف أو الوحدات، إذ يأتي مع لغة روبي على سبيل المثال الوحدة Enumerable التي توفّر ...

 مقدمة يوفّر Laravel واجهة برمجية (API) سلسة و بسيطة للمكتبة الرائجة SwiftMailer مع برنامج تشغيل لكل من SMTP و Mailgun و SparkPost و Amazon SOS وتابع mail ، و sendmail. ممّا يسمح بالبداية في إرسال الرسائل الإكترونية بسرعة عبر خدمات محلية أو سحابية من اختيارك. برامج التشغيل اللازمة تكون برامج التشغيل المعتمدة على الوسائط مثل Mailgun و SparkPost في العادة أسرع وأسهل في الاستعمال من خوادم SMTP. استعمل أحد هذه برامج التشغيل إن أمكنك. تَستعمل كل المشغّلات التي تعتمد على ...

مقدمة Artisan هي واجهة الأوامر المُرفقة ب Laravel. وهي تُوفّر عددًا من الأوامر المفيدة والتي ستساعدك في بناء التطبيق. لإظهار جميع الأوامر التي يوفّرها Artisan، يمكنك استعمال الأمر list php artisan list يحتوي كل أمر على صفحة مساعدة "help" تعرّف وتوضّح الأمر كما تُقدّم قائمة المعاملات والخيارات لكل أمر. يُستعمل الأمر مسبوقًا بالكلمة help لإظهار صفحة المساعدة: php artisan help migrate Laravel REPL تأتي كل تطبيقات Laravel مُرفَقَةً ب Tinker، وهي REPL مشغّلة بواسطة حُزمة PsySH. يسمح Tinker بالتفاعل مع ...

مقدمة عقود Laravel هي مجموعة من الواجهات (interfaces) التي تعرِّف الخدمات المركزية التي يوفرها إطار العمل. على سبيل المثال، يعرِّف العقد Illuminate\Contracts\Queue\Queue  الدوال اللازمة لصف الأعمال في الطوابير، بينما يعرِّف عقد Illuminate\Contracts\Mail \Mailer الدوال اللازمة لإرسال رسائل البريد الإلكتروني. لكل عقد تعريف استخدام (implementation) يوفره إطار العمل. على سبيل المثال، يوفِّر Laravel تعريف استخدام للطابور لعدة أنواع من المشغلات (drivers) كما يوفِّر تعريف استخدام للمُرسِل مشغل بواسطة SwiftMailer. توجد كل عقود Laravel في مستودعات في GitHub. هذا يوفر نقطة مرجعية سريعة لكل ...