نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الصنف BasicObject في روبي
الصنف BasicObject هو الصنف الأب لجميع الأصناف في روبي، وهو صنف فارغ. يمكن استخدام الصنف BasicObject لإنشاء هرميات كائنية (object hierarchies) مستقلة عن الهرمية الكائنية للغة روبي، أو لإنشاء مغلفات الكائنات (proxy objects) مثل الصنف Delegator، أو حيث يجب تجنب إفساد مجال الأسماء (namespace pollution) من قبل توابع وأصناف روبي. لتجنب إفساد الصنف BasicObject للمستخدمين الآخرين، يجب إنشاء صنف فرعي من الصنف BasicObject تحت اسم مناسب بدلاً من تعديل BasicObject مباشرةً: class MyObjectSystem < BasicObject
end
لا يتضمَّن الصنف BasicObject الوحدة Kernel ...
الصنف 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__ في الصنف BasicObject في ruby
يستدعي التابع __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 سلسلة نصية تمثل اسم التابع المراد استدعاؤه. عندما يُعرّف التابع بواسطة سلسلة ...
التابع Object.send في روبي
يَستدعي التابع send التابع المعرَّف برمزٍ (symbol) ويُنفَّذه تلقائيًا ويمرِّر إليه أي معاملاتٍ معطاة. يمكنك استخدام الاسم __send__ البديل إذا تضارب الاسم مع توابع موجودةٍ في الكائن تحمل نفس الاسم. إن عُرِّف التابع عن طريق سلسلةٍ نصية، فستُحوَّل تلك السلسلة إلى رمز. البنية العامة send(symbol [, args...]) → obj
__send__(symbol [, args...]) → obj
send(string [, args...]) → obj
__send__(string [, args...]) → obj
المعاملات symbol الرَّمزُ المعرِّف للتابع المُعطى. ...args المعاملات المراد تمريرها إلى التابع. القيم المعادة يُعاد الكائن الناتج عن تنفيذ ...
الصنف Object في روبي
يعدُّ الصنف Object الجذر الافتراضي لكل كائنات روبي. يَرِث الصنف Object من الصنف BasicObject ما يسمح بإنشاء تسلسلات هرمية بديلة للكائن. تُتاح توابع الكائن لكل الأصناف ما لم يتم تجاهلها (overridden) صراحةً. تندمج الوحدة Kernel ضمن الصنف Object ما يعطي الوصول العام (global) للدّوال المبنية ضمنيًّا في الوحدة. رغم أنَّ توابع النسخة المنشأة من الصنف Object معرَّفةٌ عن طريق الوحدة Kernel، رأينا أن نوثّقهم هنا لمزيد من الوضوح. عند الإشارة (referencing) إلى الثوابت في الأصناف الوارثة من الصنف Object، لا ...
توحيد الأجزاء الشرطية المكررة (Consolidate Duplicate Conditional Fragments)
المشكلة شيفرة برمجية متطابقة موجودة في جميع فروع الشَرطيات. الحل نقل الشيفرة البرمجية خارج الشَرطية. مثال قبل إعادة التصميم استدعاء وتنفيذ الدالة ()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;
...
التابع Object.public_send في روبي
يَستدعي التابع public_send التابع المعرَّف برمزٍ (symbol) محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. خلافًا للتابع send، يَستدعي التابع public_send التوابع العامة فقط. إن عُرِّف التابع باستخدام سلسلةٍ نصيةٍ (string)، فستُحوَّل هذه السلسلة إلى رمز. البنية العامة public_send(symbol [, args...]) → obj
public_send(string [, args...]) → obj
المعاملات symbol الرَّمز المُعرِّف للتابع المراد استدعاءه. string سلسلة نصية تعرِّف التابع المراد استدعاءه. ستُحوَّل هذه السلسلة إلى رمز إن أعطيت. ...args المعاملات المراد تمريرها إلى التابع الذي يراد استداعاؤه. القيم المعادة يُعاد ...
التابع Process.abort في روبي
ينهي التابع abort تنفيذ العملية مباشرةً بشكل فعَّال عبر استدعاء Kernel.exit(false). إن مُرِّرَت رسالة إلى هذا التابع، فستُكتَب على مجرى الخطأ القياسي (STDERR) قبل إنهاء العملية. البنية العامة abort
Kernel::abort([msg])
abort([msg])
المعاملات msg رسالة الخطأ المراد طباعتها على مجرى الخطأ القياسي. انظر أيضًا التابع Kernel.exit: يبدأ عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit. التابع argv0: يعيد اسم الشيفرة البرمجية التي يجري تنفيذها. التابع exit: يبدأ عملية الإنهاء لشيفرة روبي البرمجية عبر اطلاق الاستثناء SystemExit. مصادر قسم التابع abort في الصنف Process في ...
التابع abort الخاص بالصنف Kernel في روبي
ينهي التابع abort تنفيذ العملية على الفور عبر استدعاء Kernel.exit(false). في حال تمرير رسالة إلى التابع، فستُكتَب في المجرى STDERR قبل الإنهاء. البنية العامة abort
Kernel::abort([msg])
abort([msg])
المعاملات msg الرسالة التي ستُكتب في المجرى STDERR. انظر أيضا التابع at_exit: يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc ويسجله لأجل تنفيذه عند نهاية البرنامج. مصادر قسم التابع abort في الصنف Kernel في توثيق روبي الرسمي.
التابع Thread.name= في روبي
يعين التابع name= اسم المهمة الفرعية التي استدعيت معه إلى الاسم المُمرَّر إليه. في بعض أنظمة التشغيل، قد يتم تعيين الاسم إلى pthread و/أو إلى kernel. البنية العامة name=(name)→ string
المعاملات name الاسم المراد تعيينه إلى المهمة الفرعية المعطاة. القيمة المعادة يعاد الاسم name على شكل سلسلة نصية بعد تعيينه إلى المهمة الفرعية المعطاة. انظر أيضًا التابع name: يعيد اسم المهمة الفرعية. مصادر قسم التابع name= في الصنف Thread في توثيق روبي الرسمي.
التابع Module.autoload? في روبي
يعيد التابع autoload? اسم الملف الذي سيُحمل إن كان المعامل المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. البنية العامة autoload?(name)→ String or nil
القيمة المعادة تعاد سلسلة نصية تمثِّل اسم الملف الذي سيُحمل إن كان الوسيط المعطى مسجلًا عبر التابع autoload في مجال أسماء الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع autoload?: module A
end
A.autoload(:B, "b")
A.autoload?(:B) #=> "b"
انظر أيضا التابع autoload: يُُسجل اسم الملف ...
المعامل ` الخاص بالصنف Kernel في روبي
يعيد المعامل `` مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell). تُستخدَم الصياغة المضمَّنة %x{...} هذا المعامل. تُضبَط حالة العملية (process status) إلى القيمة $?. البنية العامة `cmd` → string
المعاملات cmd يمثل التعليمة المراد تنفيذها. القيمة المعادة يعاد مجرى المخرجات القياسي لتنفيذ تعليمة cmd في صدفة فرعية (subshell). أمثلة مثال على استخدام المعامل ``: `date` #=> "Wed Apr ...
التابع autoload الخاص بالصنف Kernel في روبي
يسجل التابع autoload اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة. البنية العامة autoload(module, filename)→ nil
المعاملات module سلسلةٌ نصيةٌ أو رمزٌ (symbol) يمثِّل اسم الوحدة. filename اسم الملف. المراد تحميله عن الوصول إلى الوحدة module. القيمة المعادة تعاد القيمة nil عند نجاح العملية. أمثلة مثال على استخدام التابع autoload: autoload(:MyModule, "/usr/local/lib/modules/my_module.rb")
انظر أيضا التابع autoload?: يعيد اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. ...
التابع Module.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 الخاص بالصنف Kernel في روبي
يبدأ التابع 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
ينتج عند تنفيذ الشيفرة: ...
التابع Object.public_method في روبي
يبحث التابع public_method عن التوابع العامة فقط بشكل مشابه لعمل التابع method. البنية العامة public_method(sym) → method
المعاملات sym رمزٌ يشير إلى اسم التابع المراد البحث عنه. القيم المعادة يُعاد التابع الموافق للاسم sym من الكائن المُعطى، أو يُرمى الاستثناء NameError إذا لم توجد توابع موافقة لهذا الاسم. انظر أيضًا التابع method: يبحث عن تابعٍ باسمٍ محدَّد في الكائن المعطى بوصفه مستقبلًا. التابع public_send: يَستدعي التابع المعرَّف برمزٍ محدَّدٍ ويُنفَّذه تلقائيًا مع تمرير أي معاملاتٍ معطاة. التابع send: يَستدعي التابع ...
التابع 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.pipe في روبي
ينشئ التابع pipe زوجًا من طرفي أنبوب (pipe endpoints) متصلين ببعضهما بعضًا ثم يعيدهما على هيئة مصفوفة من الكائنات IO. في حال إعطاء كتلة، ستُستدعى تلك الكتلة، وتعاد قيمتها، مع تمرير أنبوب القراءة وأنبوب الكتابة بعد إنشائهما كوسائط من النوع IO إليها. وسيتم إغلاقهما إن لم يغلقا عند خروج الكتلة. أي أن إغلاق هذين المجريين لن يتسبب في حدوث خطأ. التابع pipe غير متوفر في جميع أنظمة التشغيل. إذا تم تمرير ترميز معين (اسم ترميز أو كائن ترميز) كمعامل إلى التابع، فسيتم ...
التابع Object.remove_instance_variable في روبي
يَحذِف التابع 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 #=> ...
التابع Module.define_method في روبي
يعرّف التابع 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 الخاص بالصنف Kernel في روبي
يعيد التابع 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__ الخاص بالصنف Kernel في روبي
يعيد التابع __method__ الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __method__→ symbol
القيمة المعادة يعاد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. التابع __dir__: يعيد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. مصادر ...
التابع print الخاص بالصنف Kernel في روبي
يطبع التابع print الكائنات الممررة إليه بالتتابع على المجرى stdout$. إذا كان فاصل حقل الخرج ($,) يخالف nil، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الخرج ($\) يخالف nil، فسيوضع في نهاية المُخرجات. في حال لم تعطَ أية وسائط، فستُطبَع _$. ستُحول الكائنات غير النصية باستخدام التابع to_s. البنية العامة print(obj, ...) → nil
المعاملات obj الكائن المراد طباعته. ... كائنات أخرى. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع print: print "cat", [1,2,3], 99, "\n"
$, = ...
التابع Rational الخاص بالصنف Kernel في روبي
يعيد التابع 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 الخاص بالصنف Kernel في روبي
ينفذ التابع loop الكتلة البرمجية المعطاة بشكل متكرر. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator بدلاً من ذلك. يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إيقاف الحلقة التكرارية. في هذه الحالة، سيعيد التابع loop قيمة "النتيجة" المخزنة في الاستثناء. البنية العامة loop { block }
loop→ an_enumerator
القيمة المعادة يؤدي اطلاق الاستثناء StopIteration داخل الكتلة إلى إعادة قيمة "النتيجة" المخزنة في الاستثناء. أما في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator. أمثلة مثال على ...
التابع at_exit الخاص بالصنف Kernel في روبي
يحول التابع 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). ...
التابع trace_var الخاص بالصنف Kernel في روبي
يضبط (Controls) التابع trace_var تعقّبات (tracing) تعيين المتغيرات العامة. البنية العامة trace_var(symbol, cmd ) → nil
trace_var(symbol) {|val| block } → nil
يحدد الوسيط المعطى symbol المتغير (إمَّا على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الأمر cmd (الذي قد يكون سلسلةً نصيةً أو كائن من النوع Proc أو كتلةً برمجيةً) كلما تم تعيين المتغير ثم تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط. المعاملات symbol يحدد المتغير. cmd التعليمة المراد تنفيذها كلما تم تعيين المتغير. القيمة المعادة ...
التابع autoload? الخاص بالصنف Kernel في روبي
يعيد التابع autoload? اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. البنية العامة autoload?(name)→ String or nil
المعاملات name سلسلة نصية تمثل اسم الوحدة. القيمة المعادة تعاد سلسلة نصية تمثل اسم الملف المراد تحميله عند الوصول إلى الوحدة name، أو تعاد القيمة nil إن لم يكن هنالك أي ملف مُسجَّل. أمثلة مثال على استخدام التابع autoload?: autoload(:B, "b")
autoload?(:B) #=> "b"
انظر أيضا ...
التابع caller_locations الخاص بالصنف Kernel في روبي
يعيد التابع 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 الخاص بالصنف Kernel في روبي
يكافئ التابع chop التعبير ($_.dup).chop! باستثناء أنّ nil لا تُعاد أبدًا. انظر صفحة !String.chop. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. البنية العامة chop→ $_
القيمة المعادة يعاد ناتج التعبير ($_.dup).chop!. انظر أيضا التابع chomp: يكافئ التعبير $_ = $_.chomp( string). مصادر قسم التابع chop في الصنف Kernel في توثيق روبي الرسمي.
التابع Float الخاص بالصنف 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 الخاص بالصنف Kernel في روبي
يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد محدَّد من الثواني ثم يعيد عدد الثواني الفعلية (بعد تقريبه) الذي توقفت فيها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى التابع Thread.run. وفي حال استدعاء التابع sleep دون تمرير أي شيء إليه، فسيرسل المهمة الفرعية إلى النوم بشكل دائم. البنية العامة sleep([duration]) → integer
المعاملات duration مدة تعليق المهمة الفرعية. قد يكون أي نوع عددي، بما في ذلك الأعداد العشري التي من النوع Float. القيمة ...
التابع Hash الخاص بالصنف Kernel في روبي
يحول التابع Hash المعامل المُمرَّر إليه إلى جدول Hash. ويعيد جدول Hash فارغًا إن كان المعامل المعطى يساوي nil أو []. البنية العامة Hash(arg) → hash
المعاملات arg الكائن المراد تحويله إلى جدول Hash. القيمة المعادة يعاد كائن من النوع Hash يحوي قيمة المعامل arg عبر تحويلها باستدعاء التابع arg.to_hash، أو يكون فارغًا إن كان arg يساوي nil أو []. أمثلة مثال على استخدام التابع Hash: Hash([]) #=> {}
Hash(nil) ...
التابع Integer الخاص بالصنف Kernel في روبي
يحول التابع Integer المعامل المُمرَّر إليه إلى عدد صحيح (Integer). البنية العامة Integer(arg, base=0) → integer
تُحوّل الأنواع العددية مباشرة (مع اقتطاع الفواصل العشرية [floating point numbers]). المعامل base المٌعطى يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع String، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر، فسيتم احتساب مؤشرات الأساس (0 و 0b و 0x). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع String.to_i. ...
التابع open الخاص بالصنف Kernel في روبي
ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. البنية العامة open(path [, mode [, perm]] [, opt]) → io or nil
open(path [, mode [, perm]] [, opt]) {|io| block } → obj
في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج. إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة ...
التابع chomp الخاص بالصنف Kernel في روبي
يكافئ التابع chomp التعبير $_ = $_.chomp( string). انظر صفحة String.chomp. هذا التابع متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. البنية العامة chomp→ $_
chomp(string) → $_
القيمة المعادة يعاد ناتج التعبير $_ = $_.chomp( string). انظر أيضا التابع chop: يكافئ التعبير ($_.dup).chop! ، باستثناء أنّ nil لا تُعاد أبدًا. مصادر قسم التابع chomp في الصنف Kernel في توثيق روبي الرسمي.
التابع printf الخاص بالصنف 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 الخاص بالصنف Kernel في روبي
يضبط التابع srand بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator)، إذ يعين Random::DEFAULT ويعطيها قيمة العدد المُعطى ثم يعيد قيمة البذرة السابقة. في حال عدم تمرير أي عدد إلى التابع، يحدد التابع srand بذرةً للمولد باستخدام مصدر العشوائية (entropy) الذي يوفره نظام التشغيل، إن كان متاحًا (وهو /dev/urandom على أنظمة يونكس أو مُوفِّر خوارزمية التشفير RSA على نظام ويندوز)، والذي يُدمَج مع الوقت، ومعرف العملية (pid)، ورقم التسلسل. يمكن استخدام التابع srand لضمان تكرار تسلسلات الأعداد شبه العشوائية ...
التابع puts الخاص بالصنف Kernel في روبي
يكافئ التابع puts التعبير: $stdout.puts(obj, ...)
أي يطبع السلسلة النصية المُمرَّرة إليه على مجرى الخرج القياسي. البنية العامة puts(obj, ...) → nil
المعاملات obj الكائن المراد طباعته. ... كائنا أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد تنفيذ العملية. انظر أيضا التابع format: يعيد السلسلة النصية المعطاة بعد تنسيقها بشكل معين. التابع print: يطبع الكائنات الممررة إليه بالتتابع على المجرى stdout$. التابع putc: أي يطبع القيمة الممرَّرة إليه على مجرى الخرج القياسي. مصادر قسم التابع puts في الصنف Kernel في توثيق روبي ...
التابع p الخاص بالصنف 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__ الخاص بالصنف Kernel في روبي
يعيد التابع __callee__ اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. البنية العامة __callee__→ symbol
القيمة المعادة يعاد اسم التابع الحالي على شكل رمز (Symbol). وفي حال استدعائه خارج أي تابع، فسيعيد nil. انظر أيضا التابع __dir__: يعيد المسار المطلق القانوني لمجلد الملف الذي استُدعي هذا التابع منه. التابع __method__: يعيد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol). مصادر قسم التابع __callee__ في الصنف Kernel في توثيق روبي الرسمي.
التابع block_given? الخاص بالصنف 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 الخاص بالصنف Kernel في روبي
يعيد التابع format السلسلة النصية المعطاة بعد تنسيقها بشكل معين. البنية العامة format(format_string [, arguments...] )→ string
المعاملات format_string السلسلة التي تحدد التنسيق. داخل سلسلة التنسيق format_string، ستُنسخ كل المحارف إلى السلسلة النصية الناتجة باستثناء سلسلة التنسيق (format sequences). صيغة سلسلة محارف التنسيق تأخذ الشكل التالي: %[flags][width][.precision]type
تتألف سلسلة محارف التنسيق من علامة النسبة المئوية، متبوعةً بثلاث حقول اختيارية هي: flags و width و precision ثم تنتهي بمحرف يحدد حقل النوع type. يتحكم حقل النوع في كيفية تأويل الوسيط المقابل sprintf، ...
التابع exec الخاص بالصنف Kernel في روبي
يستبدل التابع exec العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى والذي يمكن أن يأخذ أحد الأشكال التالية: الأمر الوصف exec(commandline) أحد أوامر سطر الأوامر (command line) والذي يُمرّر إلى الصدفة (shell) القياسية. exec(cmdname, arg1, ...) اسم أمر (command name) ووسيط واحد أو أكثر (بدون صدفة). exec([cmdname, argv0], arg1, ...) اسم أمر وكائن argv، مع إمكانية إضافة وسائط أخرى (بدون صدفة shell). في الشكل الأول، تؤخذ السلسلة النصية باعتبارها أمرًا يراد تنفيذه في سطر أوامر، ثم تعمل الصدفة على ...
التابع eval الخاص بالصنف Kernel في روبي
يقيّم (Evaluates) التابع eval تعبيرات روبي الموجودة في سلسلة نصية. البنية العامة eval(string [, binding [, filename [,lineno]]]) → obj
إذا أعطي المعامل binding، فسيُجرَى التقييم في السياق الخاص به. في حال تمرير المعاملين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء الحاصلة في الصياغة. المعاملات string سلسلة نصية تحتوي تعبيرات روبي. binding كائن من النوع Binding. في حال تمريره، فسيُجرى التقييم في السياق الخاص به. filename يُستخدم عند الإبلاغ عن أخطاءٍ في الصياغة. lineno يُستخدم عند الإبلاغ عن ...
التابع trap الخاص بالصنف Kernel في روبي
يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة command أو الكتلة المعطاة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة تساوي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا ...
التابع __dir__ الخاص بالصنف Kernel في روبي
يعيد التابع __dir__ المسار المطلق الأساسي (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. هذا يعني أنه سيتم استبيان الوصلات الرمزية في المسار. إذا كان __FILE__ يساوي nil، فسيعيد التابع __dir__ القيمة nil أيضًا. القيمة المعادة تساوي File.dirname(File.realpath(__FILE__)). البنية العامة __dir__→ string
القيمة المعادة يعاد المسار المطلق الأساسي لمجلد الملف الذي استُدعي هذا التابع منه. إذا كان __FILE__ يساوي nil، فستُعاد القيمة nil. انظر أيضا التابع __callee__: يعيد اسم التابع الحالي على شكل رمز (Symbol). التابع __method__: يعيد الاسم الذي ...
التابع String الخاص بالصنف Kernel في روبي
يعيد التابع 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! الخاص بالصنف Kernel في روبي
يُنهِي التابع 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 الخاص بالصنف 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 => ...