نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
الصنف 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 + ...
الصنف BasicObject في روبي
الصنف BasicObject هو الصنف الأب لجميع الأصناف في روبي، وهو صنف فارغ. يمكن استخدام الصنف BasicObject لإنشاء هرميات كائنية (object hierarchies) مستقلة عن الهرمية الكائنية للغة روبي، أو لإنشاء مغلفات الكائنات (proxy objects) مثل الصنف Delegator، أو حيث يجب تجنب إفساد مجال الأسماء (namespace pollution) من قبل توابع وأصناف روبي. لتجنب إفساد الصنف BasicObject للمستخدمين الآخرين، يجب إنشاء صنف فرعي من الصنف BasicObject تحت اسم مناسب بدلاً من تعديل BasicObject مباشرةً: class MyObjectSystem < BasicObject
end
لا يتضمَّن الصنف BasicObject الوحدة Kernel ...
التابع 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
ينتج عند تنفيذ الشيفرة: ...
التابع 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"
ينتج عن تنفيذ ...
التابع 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 => ...
التابع require_relative الخاص بالصنف Kernel في روبي
عند استدعاء التابع require_relative، ستحاول روبي تحميل المكتبة التي مُرِّر اسمها إليه نسبةً إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق الخطأ LoadError. إذا تم تحميل الملف، ستُعاد القيمة true، وإلا فستُعاد القيمة false. البنية العامة require_relative(string) → true or false
المعاملات string سلسلة نصية تمثِّل اسم المكتبة المراد تحميلها. القيمة المعادة تُعاد القيمة true إذا تم تحميل المكتبة string، أو تعاد القيمة false خلاف ذلك. انظر أيضا التابع require: يُحمِّل ميزة محدَّدة ثمَّ يعيد true في حال نجح في ذلك، ...
التابع warn الخاص بالصنف Kernel في روبي
في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية -W0) ، فإنّ التابع warn لن يفعل شيئًا. خلا ذلك، سيُحوّل كل الرسائل المُمرَّرة إليه إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهايتها إن لم تكن منتهيةً بسطر جديد، ثم يستدعي التابع Warning.warn، ويمرر إليه تلك السلسلة النصية. warn("warning 1", "warning 2")
<em>produces:</em>
warning 1
warning 2
البنية العامة warn(msg, ...)→ nil
المعاملات msg الرسالة الممررة. ... رسائل أخرى القيمة المعادة تعاد القيمة nil. انظر أيضا التابع raise: ...
التابع throw الخاص بالصنف Kernel في روبي
ينقل التابع throw الضبط (control) إلى نهاية الكتلة catch المُترقبة للوسم المعطى (tag). إذا لم يكن هناك كتلة catch لذلك الوسم، فسيطلق الخطأ UncaughtThrowError. يوفر الوسيط الاختياري الثاني في حال تمريره قيمة لتُعيدها الكتلة catch، وإلا فستعيد nil. للحصول على بعض الأمثلة، انظر صفحة التابع catch. البنية العامة throw(tag [, obj])
المعاملات tag الوسم الذي تترقبه الكتلة catch. obj وسيط اختياري يوفر -في حال تمريره- قيمة لتُعيدها الكتلة catch. انظر أيضا التابع catch: ينفذ كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ ...
التابع set_trace_func الخاص بالصنف Kernel في روبي
يجعل التابع set_trace_func المعامل المعطى كمعالج للتعقب، أو يعطل التعقب إن كان الوسيط يساوي nil. ملاحظة: أصبح هذا التابع مهملًا، لذا يُرجى استخدام التابع TracePoint بدلاً منه. يقبل proc ستة معاملات هي: اسم حدث اسم ملف رقم سطر معرف كائن (object id) كائن ربط (binding) اسم صنف يستدعى proc كلما وقع حدث. الأحداث هي: الحدث الوصف c-call استدعاء برنامج فرعي في لغة C. c-return العودة من برنامج فرعي في لغة C. call استدعاء تابع من توابع روبي. class بدء تعريف ...
التابع proc الخاص بالصنف Kernel في روبي
يكافي التابع proc التعبير Proc.new. البنية العامة proc{ |...| block } → a_proc
القيمة المعادة يعاد كائن جديد من النوع Proc. انظر أيضا انظر صفحة الصنف Proc. مصادر قسم التابع proc في الصنف Kernel في توثيق روبي الرسمي.
التابع local_variables الخاص بالصنف 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 الخاص بالصنف Kernel في روبي
يكافئ التابع sub التعبير $_.sub( args ) ، باستثناء أنه سيتم تحديث $_ إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. البنية العامة sub(pattern, replacement)→ $_
sub(pattern) {|...| block } → $_
القيمة المعادة يعاد ناتج استدعاء التعبير $_.sub( args ). انظر أيضا التابع gsub: يكافئ التعبير $_.gsub...، باستثناء أنه سيتم تحديث $_ في حال حدوث استبدال. مصادر قسم التابع sub في الصنف Kernel في توثيق روبي الرسمي.
التابع catch الخاص بالصنف Kernel في روبي
ينفذ التابع catch كتلته البرمجية. في حال عدم استدعاء throw، فستنفّذ الكتلة بشكل طبيعي، وسيعيد catch قيمة آخر تعبير تم تقييمه. catch(1) { 123 } # => 123
إذا استُدعي throw(tag2, val)، فستبحث روبي في المكدس (stack) عن كتلة التابع catch، التي يكون العنوان tag الخاص بها نفس القيمة object_id الخاص بالعنوان tag2. وعند العثور عليه، يتوقف تنفيذ الكتلة وتُعاد val (أو القيمة nil إذا لم يتم تمرير وسيط ثاني ...
التابع lambda الخاص بالصنف Kernel في روبي
يكافئ التابع lambda التعبير Proc.new، باستثناء أنّ الكائنات Proc الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها. البنية العامة lambda { |...| block } → a_proc
القيمة المعادة يعاد ناتج الاستدعاء Proc.new. انظر أيضا الصنف Proc. مصادر قسم التابع lambda في الصنف Kernel في توثيق روبي الرسمي.