الصنف 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 + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي.
Integer
يحول المعامل المُمرَّر إليه إلى عدد صحيح (Integer).
Rational
يعيد ناتج العملية x/y إن مُرر عددين إليه أو عدد جذري (Rational) إن مُرِّر معامل وحيد فقط.
String
يعيد المعامل المعطى على شكل سلسلة نصية (String).
__callee__
يعيد اسم التابع الحالي على شكل رمز (Symbol).
__dir__
يعيد المسار المطلق الأساسي (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه.
__method__
يعيد الاسم الذي أعطي للتابع الحالي عند تعريفه على شكل رمز (Symbol).
`
يعيد مجرى المخرجات القياسي (standard output) لتنفيذ تعليمة في صدفة فرعية (subshell)
abort
ينهي تنفيذ العملية على الفور عبر استدعاء Kernel.exit(false).
at_exit
يحول الكتلة البرمجية المعطاة إلى كائن من النوع Proc (وبالتالي يربطه في لحظة الاستدعاء) ويسجله لأجل تنفيذه عند نهاية البرنامج.
autoload
يسجل اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة.
autoload?
يعيد التابع autoload? اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload.
binding
يعيد كائنًا من النوع Binding، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء.
block_given?
يتحقق إذا كان yield سينفذ كتلةً برمجيةً في السياق الحالي.
callcc
يولد كائنًا من النوع Continuation، والذي يُمرّر إلى الكتلة البرمجية المعطاة.
caller
يعيد مكدس التنفيذ الحالي (execution stack).
caller_locations
يعيد التابع caller_locations مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects).
catch
ينفذ كتلته البرمجية.
chomp
يكافئ التعبير $_ = $_.chomp( string ).
chop
يكافئ التعبير ($_.dup).chop! ، باستثناء أنّ nil لا تُعاد أبدًا.
eval
يقيّم (Evaluates) تعبيرات روبي الموجودة في سلسلة نصية.
exec
يستبدل العملية (process) الحالية عبر تشغيل الأمر الخارجي المعطى
exit
يبدأ عملية إنهاء البرنامج في روبي، عن طريق إطلاق استثناء SystemExit.
exit!
يُنهِي العملية على الفور.
fail
في حال استدعاء هذا التابع بدون تمرير أي معامل، فسيُطلق الاستثناء في $! أو يطلق الخطأ RuntimeError إذا كان $! يساوي nil.
fork
ينشئ عملية فرعية (subprocess).
format
يعيد السلسلة النصية المعطاة بعد تنسيقها بشكل معين.
gets
يجلب (ويسندها إلى $_) السطر التالي من قائمة الملفات في المجرى ARGV (أو $*)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر.
global_variables
يعيد مصفوفة تضم أسماء المتغيرات العامة (global variables).
gsub
يكافئ التعبير $_.gsub...، باستثناء أنه سيتم تحديث $_ في حال حدوث استبدال.
iterator?
يعيد القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الراهن. لقد أصبح الشكل iterator? مهملًا إلى حد ما.
lambda
يكافئ التعبير Proc.new، باستثناء أنّ الكائنات Proc الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها.
load
يحمّل وينفّذ برنامج روبي في الملف المعطى.
local_variables
يعيد مصفوفة تضم أسماء المتغيرات المحلية الحالية.
loop
ينفذ الكتلة البرمجية المعطاة بشكل متكرر.
open
ينشئ كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة.
p
يكتب في مجرى الخرج القياسي للبرنامج ناتج التعبير obj.inspect مباشرة متبوعًا بسطر جديد لكل كائن من الكائنات الممررة إليه.
print
يطبع الكائنات الممررة إليه بالتتابع على المجرى stdout$.
printf
يكافئ التعبير io.write(sprintf(string, obj, ...)).
proc
يكافي التعبير Proc.new.
putc
يكافئ التعبير $stdout.putc(int) أي يطبع القيمة الممرَّرة إليه على مجرى الخرج القياسي.
puts
يكافئ التعبير $stdout.puts(obj, ...)؛ أي يطبع السلسلة النصية المُمرَّرة إليه على مجرى الخرج القياسي.
raise
يطلق استثناءً أو خطأً مع إظهار رسالة تصف هذا الاستثناء أو الخطأ.
rand
يولد التابع rand عددًا شبه عشوائي يقع ضمن مجال محدَّد.
readline
يقرأ التابع سطرًا واحدًا من أسطر الملف ثم يعيده.
readlines
يعيد مصفوفة يحوي كل عنصر منها سطرًا من أسطر الملف المراد قراءته بالكامل.
require
يُحمِّل ميزة محدَّدة ثمَّ يعيد true في حال نجح في ذلك، أو false إذا كانت الميزة (feature) مُحملة سلفًا.
require_relative
عند استدعاء هذا التابع، ستحاول روبي تحميل المكتبة التي مُرِّر اسمها إليه نسبةً إلى مسار الملف المطلوب.
select
يستدعي دالة النظام select(2)، إذ يعمل على مراقبة المصفوفات الكائنات IOالمعطاة، وينتظر حتى يصبح أحد تلك الكائنات أو أكثر جاهزًا للقراءة، وجاهزًا للكتابة، ومالكًا لاستثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من الكائنات IO السابقة.
set_trace_func
يجعل المعامل المعطى كمعالج للتعقب، أو يعطل التعقب إن كان الوسيط يساوي nil.
sleep
يعلّق المهمة الفرعية (thread) الحالية لعدد محدَّد من الثواني.
spawn
ينفذ تعليمة محددة، ثم يعيد معرفها (pid).
sprintf
يعيد السلسلة النصية المُمرَّرة إليه بعد تنسيقها بنمط معيَّن.
srand
يضبط بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator).
sub
يكافئ التعبير $_.sub( args ) باستثناء أنه سيتم تحديث $_ إذا حدث استبدال.
syscall
يستدعي دالة نظام التشغيل المحددة بواسطة المعامل المُمرَّر إليه ويعيد نتيجة هذه الدالة أو يطلق الخطأ SystemCallError في حال فشل استدعائها.
system
ينفذ الأمر المُمرَّر إليه في صدفة فرعية (subshell).
test
يجري عدة اختبارات على ملف واحد أو على ملفين.
throw
ينقل الضبط (control) إلى نهاية الكتلة catch المُترقبة للوسم المعطى (tag). إذا لم يكن هناك كتلة catch لذلك الوسم، فسيطلق الخطأ UncaughtThrowError.
trace_var
يضبط (Controls) تعقّبات (tracing) تعيين المتغيرات العامة.
trap
يحدد معالج الإشارات (handling of signals).
untrace_var
يزيل التعقب (tracing) للأمر cmd المعطى على المتغير العام المحدد ثم يعيد القيمة nil.
warn
في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية -W0) ، فإنّ التابع warn لن يفعل شيئًا. خلا ذلك، سيُحوّل كل الرسائل المُمرَّرة إليه إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهايتها إن لم تكن منتهيةً بسطر جديد، ثم يستدعي التابع Warning.warn، ويمرر إليه تلك السلسلة النصية.