الفرق بين المراجعتين لصفحة: «Ruby/Kernel»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 9: | سطر 9: | ||
==توابع الصنف العامة (Public Class Methods)== | ==توابع الصنف العامة (Public Class Methods)== | ||
===[[Ruby/Kernel/Array | التابع Array]]===يعيد التابع ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية العقدية. | ==توابع الصنف العامة (Public Class Methods)== | ||
===[[Ruby/Kernel/Array | التابع Array]]=== | |||
يعيد التابع ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية العقدية. | |||
===[[Ruby/Kernel/Complex | التابع Complex]]=== | ===[[Ruby/Kernel/Complex | التابع Complex]]=== | ||
===[[Ruby/Kernel/Float | التابع Float]]===يحول arg إلى <code>Hash</code> عبر استدعاء arg<code>.to_hash</code>. ويعيد قاموسًا (<code>Hash</code>) فارغًا إذا كان arg يساوي <code>nil</code> أو <code>[]</code>. | ===[[Ruby/Kernel/Float | التابع Float]]=== | ||
يحول arg إلى <code>Hash</code> عبر استدعاء arg<code>.to_hash</code>. ويعيد قاموسًا (<code>Hash</code>) فارغًا إذا كان arg يساوي <code>nil</code> أو <code>[]</code>. | |||
===[[Ruby/Kernel/Hash | التابع Hash]]===يحول arg إلى عدد صحيح (<code>Integer</code>). تُحوّل الأنواع العددية (<code>Numeric</code>) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع <code>String</code> ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع ا<code>String#to_i</code>. تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع <code>to_int</code> ، ثم استدعاء <code>to_i</code>. في حال تمرير <code>nil</code> فسيُطلق خطأ <code>TypeError</code>. | ===[[Ruby/Kernel/Hash | التابع Hash]]=== | ||
يحول arg إلى عدد صحيح (<code>Integer</code>). تُحوّل الأنواع العددية (<code>Numeric</code>) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع <code>String</code> ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (<code>0</code> و <code>0b</code> و <code>0x</code>). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع ا<code>String#to_i</code>. تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع <code>to_int</code> ، ثم استدعاء <code>to_i</code>. في حال تمرير <code>nil</code> فسيُطلق خطأ <code>TypeError</code>. | |||
===[[Ruby/Kernel/Integer | التابع Integer]]===يعيد ناتج العملية <code>x/y</code> أو الوسيط المعطى <code>arg</code> على شكل عدد جذري (<code>Rational</code>). | ===[[Ruby/Kernel/Integer | التابع Integer]]=== | ||
يعيد ناتج العملية <code>x/y</code> أو الوسيط المعطى <code>arg</code> على شكل عدد جذري (<code>Rational</code>). | |||
===[[Ruby/Kernel/Rational | التابع Rational]]===يعيد arg على شكل سلسلة نصية (<code>String</code>). | ===[[Ruby/Kernel/Rational | التابع Rational]]=== | ||
يعيد arg على شكل سلسلة نصية (<code>String</code>). | |||
===[[Ruby/Kernel/String | التابع String]]===يعيد اسم التابع الحالي على شكل رمز (<code>Symbol</code>). في حال استدعائه خارج أي تابع، فسيعيد <code>nil</code>. | ===[[Ruby/Kernel/String | التابع String]]=== | ||
يعيد اسم التابع الحالي على شكل رمز (<code>Symbol</code>). في حال استدعائه خارج أي تابع، فسيعيد <code>nil</code>. | |||
===[[Ruby/Kernel/__callee__ | التابع __callee__]]===يعيد المسار المطلق القانوني (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. وهذا يعني أنه سيتم حل الروابط symlinks في المسار. إذا كان <code>__FILE__</code> يساوي <code>nil</code>، فسيعيد <code>nil</code>. القيمة المعادة تساوي <code>File.dirname(File.realpath(__FILE__))</code>. | ===[[Ruby/Kernel/__callee__ | التابع __callee__]]=== | ||
يعيد المسار المطلق القانوني (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. وهذا يعني أنه سيتم حل الروابط symlinks في المسار. إذا كان <code>__FILE__</code> يساوي <code>nil</code>، فسيعيد <code>nil</code>. القيمة المعادة تساوي <code>File.dirname(File.realpath(__FILE__))</code>. | |||
===[[Ruby/Kernel/__dir__ | التابع __dir__]]===يعيد التابع الاسم المعطى للتابع الحالي عند تعريفه على شكل رمز (<code>Symbol</code>). في حال استدعائه خارج أي تابع ، فسيعيد <code>nil</code>. | ===[[Ruby/Kernel/__dir__ | التابع __dir__]]=== | ||
يعيد التابع الاسم المعطى للتابع الحالي عند تعريفه على شكل رمز (<code>Symbol</code>). في حال استدعائه خارج أي تابع ، فسيعيد <code>nil</code>. | |||
===[[Ruby/Kernel/__method__ | التابع __method__]]===إرجاع مجرى المخرجات القياسية (standard output) لتنفيذ cmd في محث فرعي (subshell). تستخدم الصياغة <code>%x{...}</code> هذا التابع. يضبط حالة العملية (process status) ويعطيها القيمة <code>$?</code>. | ===[[Ruby/Kernel/__method__ | التابع __method__]]=== | ||
إرجاع مجرى المخرجات القياسية (standard output) لتنفيذ cmd في محث فرعي (subshell). تستخدم الصياغة <code>%x{...}</code> هذا التابع. يضبط حالة العملية (process status) ويعطيها القيمة <code>$?</code>. | |||
===[[Ruby/Kernel/60 | التابع `]]===ينهي التابع التنفيذ على الفور، عبر استدعاء <code>Kernel.exit(false)</code>. في حال إعطاء الوسيط msg، فسيُكتب في STDERR قبل الإنهاء. | ===[[Ruby/Kernel/60 | التابع `]]=== | ||
ينهي التابع التنفيذ على الفور، عبر استدعاء <code>Kernel.exit(false)</code>. في حال إعطاء الوسيط msg، فسيُكتب في STDERR قبل الإنهاء. | |||
===[[Ruby/Kernel/abort | التابع abort]]===يحول التابع الكتلة البرمجية إلى كائن من النوع <code>Proc</code> (وبالتالي يقوم يربطه لحظة الاستدعاء) ويسجله لأجلا التنفيذ عند نهاية البرنامج. في حالة تسجيل عدة معالجات (handlers)، فستٌنفّذ بترتيب معاكس لتسجيلها. | ===[[Ruby/Kernel/abort | التابع abort]]=== | ||
يحول التابع الكتلة البرمجية إلى كائن من النوع <code>Proc</code> (وبالتالي يقوم يربطه لحظة الاستدعاء) ويسجله لأجلا التنفيذ عند نهاية البرنامج. في حالة تسجيل عدة معالجات (handlers)، فستٌنفّذ بترتيب معاكس لتسجيلها. | |||
===[[Ruby/Kernel/at_exit | التابع at_exit]]===يسجل التابع اسم الملف filename لكي يُحمّل (باستخدام <code>Kernel::require</code>) في المرة الأولى التي يتم الدخول فيها إلى الوحدة module (والتي قد تكون <code>String</code> أو رمزًا symbol). | ===[[Ruby/Kernel/at_exit | التابع at_exit]]=== | ||
يسجل التابع اسم الملف filename لكي يُحمّل (باستخدام <code>Kernel::require</code>) في المرة الأولى التي يتم الدخول فيها إلى الوحدة module (والتي قد تكون <code>String</code> أو رمزًا symbol). | |||
===[[Ruby/Kernel/autoload | التابع autoload]]===يعيد التابع اسم الملف filename ليتم تحميله إذا تم تسجيل الوسيط المعطى name على شكل <code>autoload</code>. | ===[[Ruby/Kernel/autoload | التابع autoload]]=== | ||
يعيد التابع اسم الملف filename ليتم تحميله إذا تم تسجيل الوسيط المعطى name على شكل <code>autoload</code>. | |||
===[[Ruby/Kernel/autoload-3F | التابع autoload?]]===يعيد التابع كائنًا من النوع <code>Binding</code>، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء. يمكن استخدام هذا الكائن عند استدعاء <code>eval</code> لتنفيذ الأمر الذي تم تقييمه في هذه البيئة. انظر أيضًا وصف الصنف <code>Binding</code>. | ===[[Ruby/Kernel/autoload-3F | التابع autoload?]]=== | ||
يعيد التابع كائنًا من النوع <code>Binding</code>، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء. يمكن استخدام هذا الكائن عند استدعاء <code>eval</code> لتنفيذ الأمر الذي تم تقييمه في هذه البيئة. انظر أيضًا وصف الصنف <code>Binding</code>. | |||
===[[Ruby/Kernel/binding | التابع binding]]===يعيد التابع القيمة <code>true</code> إذا كان <code>yield</code> سينفذ كتلة برمجية في السياق الحالي. الشكل <code>iterator?</code> صار شبه مُتجاوز. | ===[[Ruby/Kernel/binding | التابع binding]]=== | ||
يعيد التابع القيمة <code>true</code> إذا كان <code>yield</code> سينفذ كتلة برمجية في السياق الحالي. الشكل <code>iterator?</code> صار شبه مُتجاوز. | |||
===[[Ruby/Kernel/block_given-3F | التابع block_given?]]===يولد التابع كائنًا من النوع <code>Continuation</code>، والذي يُمرّر إلى الكتلة البرمجية المعطاة. سيكون عليك أن تستورد <code>require | ===[[Ruby/Kernel/block_given-3F | التابع block_given?]]=== | ||
يولد التابع كائنًا من النوع <code>Continuation</code>، والذي يُمرّر إلى الكتلة البرمجية المعطاة. سيكون عليك أن تستورد <code>require | |||
===[[Ruby/Kernel/callcc | التابع callcc]]===يعيد التابع مكدس التنفيذ الحالي (execution stack)، والذي هو مصفوفة تحتوي على سلاسل نصية على الشاكلة <code>file:line</code> أو <code>file:line: in `method'</code>. | ===[[Ruby/Kernel/callcc | التابع callcc]]=== | ||
يعيد التابع مكدس التنفيذ الحالي (execution stack)، والذي هو مصفوفة تحتوي على سلاسل نصية على الشاكلة <code>file:line</code> أو <code>file:line: in `method'</code>. | |||
===[[Ruby/Kernel/caller | التابع caller]]===يعيد التابع مكدس التنفيذ الحالي، والذي هو عبارة عن مصفوفة تحتوي كائنات تعقب (backtrace location objects). | ===[[Ruby/Kernel/caller | التابع caller]]=== | ||
يعيد التابع مكدس التنفيذ الحالي، والذي هو عبارة عن مصفوفة تحتوي كائنات تعقب (backtrace location objects). | |||
===[[Ruby/Kernel/caller_locations | التابع caller_locations]]===ينفذ <code>catch</code> كتلته البرمجية في حال عدم استدعاء <code>throw</code>، فستنفّذ الكتلة بشكل طبيعي، وسيعيد <code>catch</code> قيمة آخر تعبير تم تقييمه. | ===[[Ruby/Kernel/caller_locations | التابع caller_locations]]=== | ||
ينفذ <code>catch</code> كتلته البرمجية في حال عدم استدعاء <code>throw</code>، فستنفّذ الكتلة بشكل طبيعي، وسيعيد <code>catch</code> قيمة آخر تعبير تم تقييمه. | |||
===[[Ruby/Kernel/catch | التابع catch]]===يكافئ التابع التعبير <code>$_ = $_.chomp( string )</code>. انظر صفحة <code>String#chomp</code>. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | ===[[Ruby/Kernel/catch | التابع catch]]=== | ||
يكافئ التابع التعبير <code>$_ = $_.chomp( string )</code>. انظر صفحة <code>String#chomp</code>. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | |||
===[[Ruby/Kernel/chomp | التابع chomp]]===يكافئ التابع التعبير <code>($_.dup).chop!</code> ، باستثناء أنّ <code>nil</code> لا تُعاد أبدًا. انظر صفحة <code>String#chop!</code>. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | ===[[Ruby/Kernel/chomp | التابع chomp]]=== | ||
يكافئ التابع التعبير <code>($_.dup).chop!</code> ، باستثناء أنّ <code>nil</code> لا تُعاد أبدًا. انظر صفحة <code>String#chop!</code>. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | |||
===[[Ruby/Kernel/chop | التابع chop]]===يقيم (Evaluates) التابع تعبيرات روبي الموجودة في سلاسل نصية. إذا أعطي الوسيط binding، والذي يجب أن يكون من النوع <code>Binding</code>، فسيُجرى التقييم في السياق الخاص بها. في حال تمرير الوسيطين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء في الصياغة. | ===[[Ruby/Kernel/chop | التابع chop]]=== | ||
يقيم (Evaluates) التابع تعبيرات روبي الموجودة في سلاسل نصية. إذا أعطي الوسيط binding، والذي يجب أن يكون من النوع <code>Binding</code>، فسيُجرى التقييم في السياق الخاص بها. في حال تمرير الوسيطين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء في الصياغة. | |||
===[[Ruby/Kernel/eval | التابع eval]]===يستبدل التابع العملية الحالية عن طريق تشغيل الأمر الخارجي المعطى، والذي يمكن أن يأخذ أحد الأشكال التالية: | ===[[Ruby/Kernel/eval | التابع eval]]=== | ||
يستبدل التابع العملية الحالية عن طريق تشغيل الأمر الخارجي المعطى، والذي يمكن أن يأخذ أحد الأشكال التالية: | |||
===[[Ruby/Kernel/exec | التابع exec]]===يبدأ التابع عملية إنهاء البرنامج النصي لروبي، عن طريق إطلاق استثناء <code>SystemExit</code>. من الممكن أن يتم احتواء هذا الاستثناء. يُستخدم الوسيط الاختياري لإعادة رمز الحالة (status code) لبيئة الاستدعاء. تشير الحالتان <code>true</code> و <code>FALSE</code> إلى النجاح والفشل على التوالي. يعتمد تفسير قيم الأعداد الأخرى على النظام المُستخدم. | ===[[Ruby/Kernel/exec | التابع exec]]=== | ||
يبدأ التابع عملية إنهاء البرنامج النصي لروبي، عن طريق إطلاق استثناء <code>SystemExit</code>. من الممكن أن يتم احتواء هذا الاستثناء. يُستخدم الوسيط الاختياري لإعادة رمز الحالة (status code) لبيئة الاستدعاء. تشير الحالتان <code>true</code> و <code>FALSE</code> إلى النجاح والفشل على التوالي. يعتمد تفسير قيم الأعداد الأخرى على النظام المُستخدم. | |||
===[[Ruby/Kernel/exit | التابع exit]]===ينهي العملية على الفور. لا يتم تنفيذ أي معالجات إنهاء (exit handlers). تعاد الحالة إلى النظام الأساسي باعتبارها حالة الخروج (exit status). | ===[[Ruby/Kernel/exit | التابع exit]]=== | ||
ينهي العملية على الفور. لا يتم تنفيذ أي معالجات إنهاء (exit handlers). تعاد الحالة إلى النظام الأساسي باعتبارها حالة الخروج (exit status). | |||
===[[Ruby/Kernel/exit-21 | التابع exit!]]===في حال استدعاء التابع بدون إعطاء أي وسائط، فسبُطلق الاستثناء في <code>$!</code> أو يطلق <code>RuntimeError</code> إذا كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق <code>RuntimeError</code> مع سلسلة نصية كرسالة. حلا ذلك، يجب أن يكون الوسيط الأول هو اسم صنف <code>Exception</code> (أو كائنًا يعيد كائن من النوع <code>Exception</code> عند إرسال رسالة <code>exception</code>). يحدد الوسيط الاختياري الثانية الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة الجملة <code>rescue</code> من كتل <code>begin...end</code>. | ===[[Ruby/Kernel/exit-21 | التابع exit!]]=== | ||
في حال استدعاء التابع بدون إعطاء أي وسائط، فسبُطلق الاستثناء في <code>$!</code> أو يطلق <code>RuntimeError</code> إذا كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق <code>RuntimeError</code> مع سلسلة نصية كرسالة. حلا ذلك، يجب أن يكون الوسيط الأول هو اسم صنف <code>Exception</code> (أو كائنًا يعيد كائن من النوع <code>Exception</code> عند إرسال رسالة <code>exception</code>). يحدد الوسيط الاختياري الثانية الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة الجملة <code>rescue</code> من كتل <code>begin...end</code>. | |||
===[[Ruby/Kernel/fail | التابع fail]]===ينشئ التابع عملية فرعية (subprocess). في حال إعطاء كتلة، فستُنفّذ تلك الكتلة في العملية الفرعية، كما أن قيمة الحالة عند الانتهاء ستساوي صفر. وإلا ، فإن استدعاء التابع <code>fork</code> سيقوم بالإعادة مرتين، مرة في العملية الأم (parent, process)، حيث يعيد معرف العملية الفرعية، ومرة في العملية الفرعية، حيث يعيد nil. يمكن للعملية الفرعية الخروج باستخدام <code>Kernel.exit!</code> لتجنب تشغيل دوال <code>at_exit</code>. يجب أن تستخدم العملية الأم <code>Process.wait</code> لجمع حالات إنهاء عملياتها الفرعية، أو تستخدم <code>Process.detach</code> لتسجيل إهمال تلك الحالات؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات الزومبي (zombie processes). | ===[[Ruby/Kernel/fail | التابع fail]]=== | ||
ينشئ التابع عملية فرعية (subprocess). في حال إعطاء كتلة، فستُنفّذ تلك الكتلة في العملية الفرعية، كما أن قيمة الحالة عند الانتهاء ستساوي صفر. وإلا ، فإن استدعاء التابع <code>fork</code> سيقوم بالإعادة مرتين، مرة في العملية الأم (parent, process)، حيث يعيد معرف العملية الفرعية، ومرة في العملية الفرعية، حيث يعيد nil. يمكن للعملية الفرعية الخروج باستخدام <code>Kernel.exit!</code> لتجنب تشغيل دوال <code>at_exit</code>. يجب أن تستخدم العملية الأم <code>Process.wait</code> لجمع حالات إنهاء عملياتها الفرعية، أو تستخدم <code>Process.detach</code> لتسجيل إهمال تلك الحالات؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات الزومبي (zombie processes). | |||
===[[Ruby/Kernel/fork | التابع fork]]===يعيد التابع السلسلة النصية الناتجة من تطبيق format_string على أي وسائط إضافية. داخل السلسلة النصية format_string، ستُنسخ كل الأحرف في النتيجة باستثناء تسلسلات التنسيق (format sequences). | ===[[Ruby/Kernel/fork | التابع fork]]=== | ||
يعيد التابع السلسلة النصية الناتجة من تطبيق format_string على أي وسائط إضافية. داخل السلسلة النصية format_string، ستُنسخ كل الأحرف في النتيجة باستثناء تسلسلات التنسيق (format sequences). | |||
===[[Ruby/Kernel/format | التابع format]]===يعيد التابع (ويُحيل على <code>$_</code>) السطر الموالي من قائمة الملفات في <code>ARGV</code> (أو <code>$*</code>)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. ويعيد <code>nil</code> في نهاية الملف. يحدد الوسيط الاختياري فاصل السجل. يتم تضمين الفاصل مع محتويات كل سجل. قي حال كان الوسيط sep يساوي <code>nil</code> فسيقرأ التابع gets كامل المحتوى، أما إذا كان الفاصل معدوم الطول (zero-length) فسيقرأ فقرة واحدة في كل مرة من المدخلات، بحيث تكون الفقرات مقسمة بواسطة سطرين جديدين متتاليين . إذا كان الوسيط الأول عددًا صحيحًا أو في حالإعطاء الوسيط الثاني الاختياري، فإنّ السلسلة النصية المعادة لن تكون أطول من القيمة المحددة من حيث عدد البتات (bytes). في حال تمرير عدة أسماء ملفات إلى <code>ARGV</code> ، فسيقرأ <code>gets(nil)</code> محتويات الملفات، واحدًا في كل مرة. | ===[[Ruby/Kernel/format | التابع format]]=== | ||
يعيد التابع (ويُحيل على <code>$_</code>) السطر الموالي من قائمة الملفات في <code>ARGV</code> (أو <code>$*</code>)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. ويعيد <code>nil</code> في نهاية الملف. يحدد الوسيط الاختياري فاصل السجل. يتم تضمين الفاصل مع محتويات كل سجل. قي حال كان الوسيط sep يساوي <code>nil</code> فسيقرأ التابع gets كامل المحتوى، أما إذا كان الفاصل معدوم الطول (zero-length) فسيقرأ فقرة واحدة في كل مرة من المدخلات، بحيث تكون الفقرات مقسمة بواسطة سطرين جديدين متتاليين . إذا كان الوسيط الأول عددًا صحيحًا أو في حالإعطاء الوسيط الثاني الاختياري، فإنّ السلسلة النصية المعادة لن تكون أطول من القيمة المحددة من حيث عدد البتات (bytes). في حال تمرير عدة أسماء ملفات إلى <code>ARGV</code> ، فسيقرأ <code>gets(nil)</code> محتويات الملفات، واحدًا في كل مرة. | |||
===[[Ruby/Kernel/gets | التابع gets]]===يعيد التابع global_variables مصفوفة تضم أسماء المتغيرات الكلية (global variables). | ===[[Ruby/Kernel/gets | التابع gets]]=== | ||
يعيد التابع global_variables مصفوفة تضم أسماء المتغيرات الكلية (global variables). | |||
===[[Ruby/Kernel/global_variables | التابع global_variables]]===يكافئ التابع gsub التعبير <code>$_.gsub...</code>، باستثناء أنه سيتم تحديث <code>$_</code> في حال حدوث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n | ===[[Ruby/Kernel/global_variables | التابع global_variables]]=== | ||
يكافئ التابع gsub التعبير <code>$_.gsub...</code>، باستثناء أنه سيتم تحديث <code>$_</code> في حال حدوث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n | |||
===[[Ruby/Kernel/gsub | التابع gsub]]===يعيد التابع iterator? القيمة <code>true</code> إذا كان <code>yield</code> سينفذ كتلة برمجية في السياق الراهن. لقد صار الشكل <code>iterator?</code> متجاوزًا إلى حد ما. | ===[[Ruby/Kernel/gsub | التابع gsub]]=== | ||
يعيد التابع iterator? القيمة <code>true</code> إذا كان <code>yield</code> سينفذ كتلة برمجية في السياق الراهن. لقد صار الشكل <code>iterator?</code> متجاوزًا إلى حد ما. | |||
===[[Ruby/Kernel/iterator-3F | التابع iterator?]]===يكافئ التابع lambda التعبير <code>Proc.new</code>، باستثناء أنّ كائنات <code>Proc</code> الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها. | ===[[Ruby/Kernel/iterator-3F | التابع iterator?]]=== | ||
يكافئ التابع lambda التعبير <code>Proc.new</code>، باستثناء أنّ كائنات <code>Proc</code> الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها. | |||
===[[Ruby/Kernel/lambda | التابع lambda]]===يحمل التابع load وينفّذ برنامج روبي في الملف filename. في حال لم يمكن حل filename إلى مسار مطلق (absolute path)، فسيتم البحث عن الملف في المجلدات المكتبة الواردة في <code>$:</code>. إذا كان الوسيط الاختياري wrap يساوي <code>true</code> ، فسيُنفذ النص البرمجي المحمّل كوحدة مجهولة (anonymous module)، لحماية مجال الأسماء الخاص بالبرنامج المُستدغي. لن يتم نشر أيّ من المتغيرات المحلية في الملف المحمّل تحت أي ظرف من الظروف في بيئة التحميل. | ===[[Ruby/Kernel/lambda | التابع lambda]]=== | ||
يحمل التابع load وينفّذ برنامج روبي في الملف filename. في حال لم يمكن حل filename إلى مسار مطلق (absolute path)، فسيتم البحث عن الملف في المجلدات المكتبة الواردة في <code>$:</code>. إذا كان الوسيط الاختياري wrap يساوي <code>true</code> ، فسيُنفذ النص البرمجي المحمّل كوحدة مجهولة (anonymous module)، لحماية مجال الأسماء الخاص بالبرنامج المُستدغي. لن يتم نشر أيّ من المتغيرات المحلية في الملف المحمّل تحت أي ظرف من الظروف في بيئة التحميل. | |||
===[[Ruby/Kernel/load | التابع load]]===يعيد التابع local_variables أسماء المتغيرات المحلية الحالية. | ===[[Ruby/Kernel/load | التابع load]]=== | ||
يعيد التابع local_variables أسماء المتغيرات المحلية الحالية. | |||
===[[Ruby/Kernel/local_variables | التابع local_variables]]===ينفذ التابع loop الكتلة البرمجية بشكل متكرر. | ===[[Ruby/Kernel/local_variables | التابع local_variables]]=== | ||
ينفذ التابع loop الكتلة البرمجية بشكل متكرر. | |||
===[[Ruby/Kernel/loop | التابع loop]]===ينشئ التابع open كائنًا من النوع <code>IO</code> متصلا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. | ===[[Ruby/Kernel/loop | التابع loop]]=== | ||
ينشئ التابع open كائنًا من النوع <code>IO</code> متصلا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. | |||
===[[Ruby/Kernel/open | التابع open]]===يكتب التابع p لكل كائن يُمرر إليه ناتج التعبير يكتب مباشرة .<code>inspect</code>، متبوعًا بسطر جديد في مجرى الإخراج القياسي للبرنامج. | ===[[Ruby/Kernel/open | التابع open]]=== | ||
يكتب التابع p لكل كائن يُمرر إليه ناتج التعبير يكتب مباشرة .<code>inspect</code>، متبوعًا بسطر جديد في مجرى الإخراج القياسي للبرنامج. | |||
===[[Ruby/Kernel/p | التابع p]]===يطبع التابع print الكائنات الممرة إليه بالتتابع في المجرى <code>$stdout</code>. إذا كان فاصل حقل الإخراج (<code>$,</code>) لا يساوي <code>nil</code> ، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الإخراج (<code>$\</code>) لا يساوي <code>nil</code> ، فسيوضع في نهاية المخراجات. في جال لم تعطى أي وسائط، فستُطبع <code>$_</code>. ستُحول الكائنات غير النصية باستخدام التابع <code>to_s</code> الخاصة بها. | ===[[Ruby/Kernel/p | التابع p]]=== | ||
يطبع التابع print الكائنات الممرة إليه بالتتابع في المجرى <code>$stdout</code>. إذا كان فاصل حقل الإخراج (<code>$,</code>) لا يساوي <code>nil</code> ، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الإخراج (<code>$\</code>) لا يساوي <code>nil</code> ، فسيوضع في نهاية المخراجات. في جال لم تعطى أي وسائط، فستُطبع <code>$_</code>. ستُحول الكائنات غير النصية باستخدام التابع <code>to_s</code> الخاصة بها. | |||
===[[Ruby/Kernel/print | التابع print]]===يكافئ التابع printf التعبير: | ===[[Ruby/Kernel/print | التابع print]]=== | ||
يكافئ التابع printf التعبير: | |||
===[[Ruby/Kernel/printf | التابع printf]]===يكافي التابع proc التعبير <code>Proc.new</code>. | ===[[Ruby/Kernel/printf | التابع printf]]=== | ||
يكافي التابع proc التعبير <code>Proc.new</code>. | |||
===[[Ruby/Kernel/proc | التابع proc]]===يكافئ التابع putc التعبير: | ===[[Ruby/Kernel/proc | التابع proc]]=== | ||
يكافئ التابع putc التعبير: | |||
===[[Ruby/Kernel/putc | التابع putc]]===يكافئ التابع puts التعبير: | ===[[Ruby/Kernel/putc | التابع putc]]=== | ||
يكافئ التابع puts التعبير: | |||
===[[Ruby/Kernel/puts | التابع puts]]===في حال عدم تمريرأي وسائط، سيطلق التابع raise استثناء في <code>$!</code> أو يطلق <code>RuntimeError</code> إن كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق <code>RuntimeError</code> بحيث يكون الوسيط الممرر string الرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسما للصنف <code>Exception</code> (أو كائنًا يعيد كائن <code>Exception</code> عند تلقيه رسالة <code>exception</code>). يحدد الوسيط الاختياري الثاني رسالة الاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة جملة <code>rescue</code> من كتل <code>begin...end</code>. | ===[[Ruby/Kernel/puts | التابع puts]]=== | ||
في حال عدم تمريرأي وسائط، سيطلق التابع raise استثناء في <code>$!</code> أو يطلق <code>RuntimeError</code> إن كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق <code>RuntimeError</code> بحيث يكون الوسيط الممرر string الرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسما للصنف <code>Exception</code> (أو كائنًا يعيد كائن <code>Exception</code> عند تلقيه رسالة <code>exception</code>). يحدد الوسيط الاختياري الثاني رسالة الاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة جملة <code>rescue</code> من كتل <code>begin...end</code>. | |||
===[[Ruby/Kernel/raise | التابع raise]]===في حال استدعاء التابع rand بدون تمرير وسائط إليه، أو إن كان <code>max.to_i.abs == 0</code>، فسيعيد التابع rand عدد عشري شبه عشوائي (pseudo-random) محصور بين 0.0 و 1.0، متضمنا 0.0، وباستثناء 1.0. | ===[[Ruby/Kernel/raise | التابع raise]]=== | ||
في حال استدعاء التابع rand بدون تمرير وسائط إليه، أو إن كان <code>max.to_i.abs == 0</code>، فسيعيد التابع rand عدد عشري شبه عشوائي (pseudo-random) محصور بين 0.0 و 1.0، متضمنا 0.0، وباستثناء 1.0. | |||
===[[Ruby/Kernel/rand | التابع rand]]===يكافئ التابع readline التعبير <code>Kernel::gets</code> ، باستثناء أنّ <code>readline</code> تطلق خطأ <code>EOFError</code> عند نهاية الملف. | ===[[Ruby/Kernel/rand | التابع rand]]=== | ||
يكافئ التابع readline التعبير <code>Kernel::gets</code> ، باستثناء أنّ <code>readline</code> تطلق خطأ <code>EOFError</code> عند نهاية الملف. | |||
===[[Ruby/Kernel/readline | التابع readline]]===يعيد التابع readlines مصفوفة تحتوي الأسطر المُعادة من استدعاء <code>Kernel.gets( sep )</code> حتى نهاية الملف. | ===[[Ruby/Kernel/readline | التابع readline]]=== | ||
يعيد التابع readlines مصفوفة تحتوي الأسطر المُعادة من استدعاء <code>Kernel.gets( sep )</code> حتى نهاية الملف. | |||
===[[Ruby/Kernel/readlines | التابع readlines]]===بحمل التابع require المُعطى <code>name</code>،ويعيد <code>true</code> في حال نجح في ذلك، أو <code>false</code> إذا كانت الميزة مُحملة (feature) .سلفًا | ===[[Ruby/Kernel/readlines | التابع readlines]]=== | ||
بحمل التابع require المُعطى <code>name</code>،ويعيد <code>true</code> في حال نجح في ذلك، أو <code>false</code> إذا كانت الميزة مُحملة (feature) .سلفًا | |||
===[[Ruby/Kernel/require | التابع require]]===عند استدعاء هذا التابع ستحاول روبي تحميل المكتبة المسماة في الوسيط المعطى string نسبة إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق خطأ <code>LoadError</code>. إذا تم تحميل ملف ستُعاد القيمة <code>true</code>، وإلا فستُعاد false على خلاف ذلك. | ===[[Ruby/Kernel/require | التابع require]]=== | ||
عند استدعاء هذا التابع ستحاول روبي تحميل المكتبة المسماة في الوسيط المعطى string نسبة إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق خطأ <code>LoadError</code>. إذا تم تحميل ملف ستُعاد القيمة <code>true</code>، وإلا فستُعاد false على خلاف ذلك. | |||
===[[Ruby/Kernel/require_relative | التابع require_relative]]===يستدعي select(2). ويقوم بمراقبة المصفوفة المعطاة المكونة من كائنات <code>IO</code>، وينتظر حتى يكون أحد كائنات <code>IO</code> جاهزًا للقراءة ، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من تلك كائنات <code>IO</code> السابقة. ستُعاد القيمة <code>nil</code> إذا تم إعطاء قيمة للوسيط الاختياري timeout، ولم يكن هناك أي كائن <code>IO</code> جاهزًا خلال timeout ثانية. | ===[[Ruby/Kernel/require_relative | التابع require_relative]]=== | ||
يستدعي select(2). ويقوم بمراقبة المصفوفة المعطاة المكونة من كائنات <code>IO</code>، وينتظر حتى يكون أحد كائنات <code>IO</code> جاهزًا للقراءة ، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من تلك كائنات <code>IO</code> السابقة. ستُعاد القيمة <code>nil</code> إذا تم إعطاء قيمة للوسيط الاختياري timeout، ولم يكن هناك أي كائن <code>IO</code> جاهزًا خلال timeout ثانية. | |||
===[[Ruby/Kernel/select | التابع select]]===يجعل التابع set_trace_func الوسيط المعطى proc كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي <code>nil</code>. | ===[[Ruby/Kernel/select | التابع select]]=== | ||
يجعل التابع set_trace_func الوسيط المعطى proc كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي <code>nil</code>. | |||
===[[Ruby/Kernel/set_trace_func | التابع set_trace_func]]===يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد من الثواني (والذي قد بكون أي عدد، بما في ذلك <code>Float</code> مع كسور ثوان). ثم يعيد عدد الثواني الفعلي (بالتقريب) الذي نامتها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى <code>Thread#run</code>. في حال استدعائها دون تمرير أي وسيط، ستقوم sleep() بتنويم المهمة الفرعية إلى الأبد. | ===[[Ruby/Kernel/set_trace_func | التابع set_trace_func]]=== | ||
يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد من الثواني (والذي قد بكون أي عدد، بما في ذلك <code>Float</code> مع كسور ثوان). ثم يعيد عدد الثواني الفعلي (بالتقريب) الذي نامتها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى <code>Thread#run</code>. في حال استدعائها دون تمرير أي وسيط، ستقوم sleep() بتنويم المهمة الفرعية إلى الأبد. | |||
===[[Ruby/Kernel/sleep | التابع sleep]]===ينفذ التابع spawn تعليمة محددة، ثم يعيد معرفها (pid). | ===[[Ruby/Kernel/sleep | التابع sleep]]=== | ||
ينفذ التابع spawn تعليمة محددة، ثم يعيد معرفها (pid). | |||
===[[Ruby/Kernel/spawn | التابع spawn]]===يعيد التابع sprintf السلسلة النصية الناتجة من تطبيق format_string على الوسائط الإضافية. داخل سلسلة التنسيق، يتم نسخ كل الأحرف في النتيجة باستثناء تسلسلات الشكل . | ===[[Ruby/Kernel/spawn | التابع spawn]]=== | ||
يعيد التابع sprintf السلسلة النصية الناتجة من تطبيق format_string على الوسائط الإضافية. داخل سلسلة التنسيق، يتم نسخ كل الأحرف في النتيجة باستثناء تسلسلات الشكل . | |||
===[[Ruby/Kernel/sprintf | التابع sprintf]]===يحدد التابع srand بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator)، حيث يعين Random :: DEFAULT ، ويعطيها القيمة <code>number</code>. تُعاد قيمة البذرة السابقة. | ===[[Ruby/Kernel/sprintf | التابع sprintf]]=== | ||
يحدد التابع srand بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator)، حيث يعين Random :: DEFAULT ، ويعطيها القيمة <code>number</code>. تُعاد قيمة البذرة السابقة. | |||
===[[Ruby/Kernel/srand | التابع srand]]===يكافئ التابع sub التعبير <code>$_.sub( args )</code> ، باستثناء أنه سيتم تحديث <code>$_</code> إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | ===[[Ruby/Kernel/srand | التابع srand]]=== | ||
يكافئ التابع sub التعبير <code>$_.sub( args )</code> ، باستثناء أنه سيتم تحديث <code>$_</code> إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n. | |||
===[[Ruby/Kernel/sub | التابع sub]]===يستدعي التابع syscall دالة نظام التشغيل المحددة بواسطة num، ويعيد نتيجة الدالة، أو يطلق <code>SystemCallError</code> في حال الفشل. | ===[[Ruby/Kernel/sub | التابع sub]]=== | ||
يستدعي التابع syscall دالة نظام التشغيل المحددة بواسطة num، ويعيد نتيجة الدالة، أو يطلق <code>SystemCallError</code> في حال الفشل. | |||
===[[Ruby/Kernel/syscall | التابع syscall]]===ينفذ التابع system الوسيط command… في صدفة فرعية (subshell).يأخذ command… أحد الأشكال التالية. | ===[[Ruby/Kernel/syscall | التابع syscall]]=== | ||
ينفذ التابع system الوسيط command… في صدفة فرعية (subshell).يأخذ command… أحد الأشكال التالية. | |||
===[[Ruby/Kernel/system | التابع system]]===يستخدم التابع test الحرف <code>cmd</code> لإجراء عدة اختبارات على <code>file1</code> (الجدول الأول أدناه) أو على <code>file1</code> و <code>file2</code> (الجدول الثاني). | ===[[Ruby/Kernel/system | التابع system]]=== | ||
يستخدم التابع test الحرف <code>cmd</code> لإجراء عدة اختبارات على <code>file1</code> (الجدول الأول أدناه) أو على <code>file1</code> و <code>file2</code> (الجدول الثاني). | |||
===[[Ruby/Kernel/test | التابع test]]===ينقل التابع throw الضبط (control) إلى نهاية كتلة <code>catch</code> النشطة في انتظار الوسم (tag). ويطلق <code>UncaughtThrowError</code> إذا لم يكن هناك كتلة <code>catch</code> لذلك الوسم. يوفر الوسيط الاختياري الثاني قيمة لتُعيدها الكتلة <code>catch</code>، في حال عدم تمريره ستكون قيمتها الافتراضية هي <code>nil</code>. للحصول على بعض الأمثلة، انظر <code>Kernel::catch</code>. | ===[[Ruby/Kernel/test | التابع test]]=== | ||
ينقل التابع throw الضبط (control) إلى نهاية كتلة <code>catch</code> النشطة في انتظار الوسم (tag). ويطلق <code>UncaughtThrowError</code> إذا لم يكن هناك كتلة <code>catch</code> لذلك الوسم. يوفر الوسيط الاختياري الثاني قيمة لتُعيدها الكتلة <code>catch</code>، في حال عدم تمريره ستكون قيمتها الافتراضية هي <code>nil</code>. للحصول على بعض الأمثلة، انظر <code>Kernel::catch</code>. | |||
===[[Ruby/Kernel/throw | التابع throw]]===يضبط التابع trace_var تعقّبات تعيين المتغيرات الكلية. يحدد الوسيط <code>symbol</code> المتغير (إما على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الوسيط cmd (الذي قد يكون سلسلة نصية أو كائن <code>Proc</code>) أو كتلة برمجية كلما تم تعيين المتغير. تتلقى الكتلة أو الكائن <code>Proc</code> القيمة الجديدة للمتغير كوسيط. انظر أيضا <code>Kernel::untrace_var</code>. | ===[[Ruby/Kernel/throw | التابع throw]]=== | ||
يضبط التابع trace_var تعقّبات تعيين المتغيرات الكلية. يحدد الوسيط <code>symbol</code> المتغير (إما على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الوسيط cmd (الذي قد يكون سلسلة نصية أو كائن <code>Proc</code>) أو كتلة برمجية كلما تم تعيين المتغير. تتلقى الكتلة أو الكائن <code>Proc</code> القيمة الجديدة للمتغير كوسيط. انظر أيضا <code>Kernel::untrace_var</code>. | |||
===[[Ruby/Kernel/trace_var | التابع trace_var]]===يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة المعطاة cmd أو الكتلة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة هي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا كان التعليمة تساوي "SYSTEM_DEFAULT" ، فسيتم استدعاء معالج نظام التشغيل الافتراضي. خلا ذلك، سيتم تشغيل التعليمة أو الكتلة المعطاة. سيتم استدعاء اسم الإشارة الخاص "EXIT"، أو رقم الإشارة 0، قبل إنهاء البرنامج مباشرة. يعيد التابع trap المعالج السابق للإشارة المعينة. | ===[[Ruby/Kernel/trace_var | التابع trace_var]]=== | ||
يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة المعطاة cmd أو الكتلة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة هي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا كان التعليمة تساوي "SYSTEM_DEFAULT" ، فسيتم استدعاء معالج نظام التشغيل الافتراضي. خلا ذلك، سيتم تشغيل التعليمة أو الكتلة المعطاة. سيتم استدعاء اسم الإشارة الخاص "EXIT"، أو رقم الإشارة 0، قبل إنهاء البرنامج مباشرة. يعيد التابع trap المعالج السابق للإشارة المعينة. | |||
===[[Ruby/Kernel/trap | التابع trap]]===يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد <code>nil</code>. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل. | ===[[Ruby/Kernel/trap | التابع trap]]=== | ||
يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد <code>nil</code>. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل. | |||
===[[Ruby/Kernel/untrace_var | التابع untrace_var]]===في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية <code>-W0</code>) ، فإنّ التابع warn لن يفعل شيئا. خلا ذلك، سيُحوّل كل الرسائل إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهاية السلسلة النصية إذا لم تكن تنتهي بسطر جديد، ثم يستدعي <code>Warning.warn</code> ويمرر إليه تلك السلسلة النصية. | ===[[Ruby/Kernel/untrace_var | التابع untrace_var]]=== | ||
في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية <code>-W0</code>) ، فإنّ التابع warn لن يفعل شيئا. خلا ذلك، سيُحوّل كل الرسائل إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهاية السلسلة النصية إذا لم تكن تنتهي بسطر جديد، ثم يستدعي <code>Warning.warn</code> ويمرر إليه تلك السلسلة النصية. | |||
===[[Ruby/Kernel/warn | التابع warn]]===يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد <code>nil</code>. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل. | ===[[Ruby/Kernel/warn | التابع warn]]=== | ||
يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد <code>nil</code>. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل. | |||
==مصادر<span> </span>== | ==مصادر<span> </span>== | ||
*[http://ruby-doc.org/core-2.5.1/Kernel.html قسم الصنف Kernel في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/Kernel.html قسم الصنف Kernel في توثيق روبي الرسمي.] | ||
مراجعة 01:25، 24 أكتوبر 2018
الوحدة Kernel مُتضمّنة من طرف الصنف Object، لذلك فتوابعه متاحة في كل كائنات روبي.
توابع نسخ الصنف Kernel مُوثّقة في صفحة الصنف Object، أما توابع الوحدة Kernel فهي مُوثقة هنا. تستدعى هذه التوابع بدون مستقبل (receiver)، وبالتالي يمكن استدعاؤها وفق الشكل الدوالي:
sprintf "%.1f", 1.234 #=> "1.2"
توابع الصنف العامة (Public Class Methods)
توابع الصنف العامة (Public Class Methods)
التابع Array
يعيد التابع ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية العقدية.
التابع Complex
التابع Float
يحول arg إلى Hash عبر استدعاء arg.to_hash. ويعيد قاموسًا (Hash) فارغًا إذا كان arg يساوي nil أو [].
التابع Hash
يحول arg إلى عدد صحيح (Integer). تُحوّل الأنواع العددية (Numeric) مباشرة (مع اقتطاع الأعداد الكسرية[floating point numbers]). الوسيط base المٌعطى (يساوي0، أو بين 2 و 36) يمثل أساس التمثيل النصي للأعداد الصحيحة. إن كان arg من النوع String ، وفي حال عدم تمرير الوسيط base أو كان يساوي الصفر ، يتم احتساب مؤشرات الموضع radix (0 و 0b و 0x). في جميع الحالات، يجب أن تكون السلاسل النصية متوافقة تمامًا مع التمثيل الرقمي. يختلف هذا السلوك عن سلوك التابع اString#to_i. تُحوّل القيم غير النصية أولًاً بمحاولة استدعاء التابع to_int ، ثم استدعاء to_i. في حال تمرير nil فسيُطلق خطأ TypeError.
التابع Integer
يعيد ناتج العملية x/y أو الوسيط المعطى arg على شكل عدد جذري (Rational).
التابع Rational
يعيد arg على شكل سلسلة نصية (String).
التابع String
يعيد اسم التابع الحالي على شكل رمز (Symbol). في حال استدعائه خارج أي تابع، فسيعيد nil.
التابع __callee__
يعيد المسار المطلق القانوني (canonicalized absolute path) لمجلد الملف الذي استُدعي هذا التابع منه. وهذا يعني أنه سيتم حل الروابط symlinks في المسار. إذا كان __FILE__ يساوي nil، فسيعيد nil. القيمة المعادة تساوي File.dirname(File.realpath(__FILE__)).
التابع __dir__
يعيد التابع الاسم المعطى للتابع الحالي عند تعريفه على شكل رمز (Symbol). في حال استدعائه خارج أي تابع ، فسيعيد nil.
التابع __method__
إرجاع مجرى المخرجات القياسية (standard output) لتنفيذ cmd في محث فرعي (subshell). تستخدم الصياغة %x{...} هذا التابع. يضبط حالة العملية (process status) ويعطيها القيمة $?.
التابع `
ينهي التابع التنفيذ على الفور، عبر استدعاء Kernel.exit(false). في حال إعطاء الوسيط msg، فسيُكتب في STDERR قبل الإنهاء.
التابع abort
يحول التابع الكتلة البرمجية إلى كائن من النوع Proc (وبالتالي يقوم يربطه لحظة الاستدعاء) ويسجله لأجلا التنفيذ عند نهاية البرنامج. في حالة تسجيل عدة معالجات (handlers)، فستٌنفّذ بترتيب معاكس لتسجيلها.
التابع at_exit
يسجل التابع اسم الملف filename لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الدخول فيها إلى الوحدة module (والتي قد تكون String أو رمزًا symbol).
التابع autoload
يعيد التابع اسم الملف filename ليتم تحميله إذا تم تسجيل الوسيط المعطى name على شكل autoload.
التابع autoload?
يعيد التابع كائنًا من النوع Binding، والذي يصف ويحدد ارتباطات المتغيرات والتوابع لحظة الاستدعاء. يمكن استخدام هذا الكائن عند استدعاء eval لتنفيذ الأمر الذي تم تقييمه في هذه البيئة. انظر أيضًا وصف الصنف Binding.
التابع binding
يعيد التابع القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الحالي. الشكل iterator? صار شبه مُتجاوز.
التابع block_given?
يولد التابع كائنًا من النوع Continuation، والذي يُمرّر إلى الكتلة البرمجية المعطاة. سيكون عليك أن تستورد require
التابع callcc
يعيد التابع مكدس التنفيذ الحالي (execution stack)، والذي هو مصفوفة تحتوي على سلاسل نصية على الشاكلة file:line أو file:line: in `method'.
التابع caller
يعيد التابع مكدس التنفيذ الحالي، والذي هو عبارة عن مصفوفة تحتوي كائنات تعقب (backtrace location objects).
التابع caller_locations
ينفذ catch كتلته البرمجية في حال عدم استدعاء throw، فستنفّذ الكتلة بشكل طبيعي، وسيعيد catch قيمة آخر تعبير تم تقييمه.
التابع catch
يكافئ التابع التعبير $_ = $_.chomp( string ). انظر صفحة String#chomp. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n.
التابع chomp
يكافئ التابع التعبير ($_.dup).chop! ، باستثناء أنّ nil لا تُعاد أبدًا. انظر صفحة String#chop!. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n.
التابع chop
يقيم (Evaluates) التابع تعبيرات روبي الموجودة في سلاسل نصية. إذا أعطي الوسيط binding، والذي يجب أن يكون من النوع Binding، فسيُجرى التقييم في السياق الخاص بها. في حال تمرير الوسيطين الاختياريين filename و lineno، فسيُستخدمان عند الإبلاغ عن أخطاء في الصياغة.
التابع eval
يستبدل التابع العملية الحالية عن طريق تشغيل الأمر الخارجي المعطى، والذي يمكن أن يأخذ أحد الأشكال التالية:
التابع exec
يبدأ التابع عملية إنهاء البرنامج النصي لروبي، عن طريق إطلاق استثناء SystemExit. من الممكن أن يتم احتواء هذا الاستثناء. يُستخدم الوسيط الاختياري لإعادة رمز الحالة (status code) لبيئة الاستدعاء. تشير الحالتان true و FALSE إلى النجاح والفشل على التوالي. يعتمد تفسير قيم الأعداد الأخرى على النظام المُستخدم.
التابع exit
ينهي العملية على الفور. لا يتم تنفيذ أي معالجات إنهاء (exit handlers). تعاد الحالة إلى النظام الأساسي باعتبارها حالة الخروج (exit status).
التابع exit!
في حال استدعاء التابع بدون إعطاء أي وسائط، فسبُطلق الاستثناء في $! أو يطلق RuntimeError إذا كان $! يساوي nil. في حال تمرير وسيط واحد String، فسيطلق RuntimeError مع سلسلة نصية كرسالة. حلا ذلك، يجب أن يكون الوسيط الأول هو اسم صنف Exception (أو كائنًا يعيد كائن من النوع Exception عند إرسال رسالة exception). يحدد الوسيط الاختياري الثانية الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة الجملة rescue من كتل begin...end.
التابع fail
ينشئ التابع عملية فرعية (subprocess). في حال إعطاء كتلة، فستُنفّذ تلك الكتلة في العملية الفرعية، كما أن قيمة الحالة عند الانتهاء ستساوي صفر. وإلا ، فإن استدعاء التابع fork سيقوم بالإعادة مرتين، مرة في العملية الأم (parent, process)، حيث يعيد معرف العملية الفرعية، ومرة في العملية الفرعية، حيث يعيد nil. يمكن للعملية الفرعية الخروج باستخدام Kernel.exit! لتجنب تشغيل دوال at_exit. يجب أن تستخدم العملية الأم Process.wait لجمع حالات إنهاء عملياتها الفرعية، أو تستخدم Process.detach لتسجيل إهمال تلك الحالات؛ خلاف ذلك، قد يُراكم نظام التشغيل عمليات الزومبي (zombie processes).
التابع fork
يعيد التابع السلسلة النصية الناتجة من تطبيق format_string على أي وسائط إضافية. داخل السلسلة النصية format_string، ستُنسخ كل الأحرف في النتيجة باستثناء تسلسلات التنسيق (format sequences).
التابع format
يعيد التابع (ويُحيل على $_) السطر الموالي من قائمة الملفات في ARGV (أو $*)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. ويعيد nil في نهاية الملف. يحدد الوسيط الاختياري فاصل السجل. يتم تضمين الفاصل مع محتويات كل سجل. قي حال كان الوسيط sep يساوي nil فسيقرأ التابع gets كامل المحتوى، أما إذا كان الفاصل معدوم الطول (zero-length) فسيقرأ فقرة واحدة في كل مرة من المدخلات، بحيث تكون الفقرات مقسمة بواسطة سطرين جديدين متتاليين . إذا كان الوسيط الأول عددًا صحيحًا أو في حالإعطاء الوسيط الثاني الاختياري، فإنّ السلسلة النصية المعادة لن تكون أطول من القيمة المحددة من حيث عدد البتات (bytes). في حال تمرير عدة أسماء ملفات إلى ARGV ، فسيقرأ gets(nil) محتويات الملفات، واحدًا في كل مرة.
التابع gets
يعيد التابع global_variables مصفوفة تضم أسماء المتغيرات الكلية (global variables).
التابع global_variables
يكافئ التابع gsub التعبير $_.gsub...، باستثناء أنه سيتم تحديث $_ في حال حدوث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n
التابع gsub
يعيد التابع iterator? القيمة true إذا كان yield سينفذ كتلة برمجية في السياق الراهن. لقد صار الشكل iterator? متجاوزًا إلى حد ما.
التابع iterator?
يكافئ التابع lambda التعبير Proc.new، باستثناء أنّ كائنات Proc الناتجة ستتحقق من عدد الوسائط الممررة عند استدعائها.
التابع lambda
يحمل التابع load وينفّذ برنامج روبي في الملف filename. في حال لم يمكن حل filename إلى مسار مطلق (absolute path)، فسيتم البحث عن الملف في المجلدات المكتبة الواردة في $:. إذا كان الوسيط الاختياري wrap يساوي true ، فسيُنفذ النص البرمجي المحمّل كوحدة مجهولة (anonymous module)، لحماية مجال الأسماء الخاص بالبرنامج المُستدغي. لن يتم نشر أيّ من المتغيرات المحلية في الملف المحمّل تحت أي ظرف من الظروف في بيئة التحميل.
التابع load
يعيد التابع local_variables أسماء المتغيرات المحلية الحالية.
التابع local_variables
ينفذ التابع loop الكتلة البرمجية بشكل متكرر.
التابع loop
ينشئ التابع open كائنًا من النوع IO متصلا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة.
التابع open
يكتب التابع p لكل كائن يُمرر إليه ناتج التعبير يكتب مباشرة .inspect، متبوعًا بسطر جديد في مجرى الإخراج القياسي للبرنامج.
التابع p
يطبع التابع print الكائنات الممرة إليه بالتتابع في المجرى $stdout. إذا كان فاصل حقل الإخراج ($,) لا يساوي nil ، فسيظهر محتواه بين الحقول. إذا كان فاصل سجل الإخراج ($\) لا يساوي nil ، فسيوضع في نهاية المخراجات. في جال لم تعطى أي وسائط، فستُطبع $_. ستُحول الكائنات غير النصية باستخدام التابع to_s الخاصة بها.
التابع print
يكافئ التابع printf التعبير:
التابع printf
يكافي التابع proc التعبير Proc.new.
التابع proc
يكافئ التابع putc التعبير:
التابع putc
يكافئ التابع puts التعبير:
التابع puts
في حال عدم تمريرأي وسائط، سيطلق التابع raise استثناء في $! أو يطلق RuntimeError إن كان $! يساوي nil. في حال تمرير وسيط واحد String، فسيطلق RuntimeError بحيث يكون الوسيط الممرر string الرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسما للصنف Exception (أو كائنًا يعيد كائن Exception عند تلقيه رسالة exception). يحدد الوسيط الاختياري الثاني رسالة الاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. تُضبط الاستثناءات بواسطة جملة rescue من كتل begin...end.
التابع raise
في حال استدعاء التابع rand بدون تمرير وسائط إليه، أو إن كان max.to_i.abs == 0، فسيعيد التابع rand عدد عشري شبه عشوائي (pseudo-random) محصور بين 0.0 و 1.0، متضمنا 0.0، وباستثناء 1.0.
التابع rand
يكافئ التابع readline التعبير Kernel::gets ، باستثناء أنّ readline تطلق خطأ EOFError عند نهاية الملف.
التابع readline
يعيد التابع readlines مصفوفة تحتوي الأسطر المُعادة من استدعاء Kernel.gets( sep ) حتى نهاية الملف.
التابع readlines
بحمل التابع require المُعطى name،ويعيد true في حال نجح في ذلك، أو false إذا كانت الميزة مُحملة (feature) .سلفًا
التابع require
عند استدعاء هذا التابع ستحاول روبي تحميل المكتبة المسماة في الوسيط المعطى string نسبة إلى مسار الملف المطلوب. إذا تعذر تحديد مسار الملف، سيُطلق خطأ LoadError. إذا تم تحميل ملف ستُعاد القيمة true، وإلا فستُعاد false على خلاف ذلك.
التابع require_relative
يستدعي select(2). ويقوم بمراقبة المصفوفة المعطاة المكونة من كائنات IO، وينتظر حتى يكون أحد كائنات IO جاهزًا للقراءة ، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من تلك كائنات IO السابقة. ستُعاد القيمة nil إذا تم إعطاء قيمة للوسيط الاختياري timeout، ولم يكن هناك أي كائن IO جاهزًا خلال timeout ثانية.
التابع select
يجعل التابع set_trace_func الوسيط المعطى proc كمتعقب (handler for tracing)، أو يعطل التعقب إن كان الوسيط يساوي nil.
التابع set_trace_func
يعلّق التابع sleep المهمة الفرعية (thread) الحالية لعدد من الثواني (والذي قد بكون أي عدد، بما في ذلك Float مع كسور ثوان). ثم يعيد عدد الثواني الفعلي (بالتقريب) الذي نامتها المهمة الفرعية، والذي قد يكون أقل من العدد المطلوب إن استدعت مهمة فرعية أخرى Thread#run. في حال استدعائها دون تمرير أي وسيط، ستقوم sleep() بتنويم المهمة الفرعية إلى الأبد.
التابع sleep
ينفذ التابع spawn تعليمة محددة، ثم يعيد معرفها (pid).
التابع spawn
يعيد التابع sprintf السلسلة النصية الناتجة من تطبيق format_string على الوسائط الإضافية. داخل سلسلة التنسيق، يتم نسخ كل الأحرف في النتيجة باستثناء تسلسلات الشكل .
التابع sprintf
يحدد التابع srand بذرة مولد الأعداد شبه العشوائية (system pseudo-random number generator)، حيث يعين Random :: DEFAULT ، ويعطيها القيمة number. تُعاد قيمة البذرة السابقة.
التابع srand
يكافئ التابع sub التعبير $_.sub( args ) ، باستثناء أنه سيتم تحديث $_ إذا حدث استبدال. متوفر فقط عند تحديد خيار سطر الأوامر -p/-n.
التابع sub
يستدعي التابع syscall دالة نظام التشغيل المحددة بواسطة num، ويعيد نتيجة الدالة، أو يطلق SystemCallError في حال الفشل.
التابع syscall
ينفذ التابع system الوسيط command… في صدفة فرعية (subshell).يأخذ command… أحد الأشكال التالية.
التابع system
يستخدم التابع test الحرف cmd لإجراء عدة اختبارات على file1 (الجدول الأول أدناه) أو على file1 و file2 (الجدول الثاني).
التابع test
ينقل التابع throw الضبط (control) إلى نهاية كتلة catch النشطة في انتظار الوسم (tag). ويطلق UncaughtThrowError إذا لم يكن هناك كتلة catch لذلك الوسم. يوفر الوسيط الاختياري الثاني قيمة لتُعيدها الكتلة catch، في حال عدم تمريره ستكون قيمتها الافتراضية هي nil. للحصول على بعض الأمثلة، انظر Kernel::catch.
التابع throw
يضبط التابع trace_var تعقّبات تعيين المتغيرات الكلية. يحدد الوسيط symbol المتغير (إما على شكل سلسلة نصية أو معرف رمز [symbol identifier]). يتم تنفيذ الوسيط cmd (الذي قد يكون سلسلة نصية أو كائن Proc) أو كتلة برمجية كلما تم تعيين المتغير. تتلقى الكتلة أو الكائن Proc القيمة الجديدة للمتغير كوسيط. انظر أيضا Kernel::untrace_var.
التابع trace_var
يحدد التابع trap معالج الإشارات (handling of signals). الوسيط الأول يمثل اسم إشارة (سلسلة نصية مثل "SIGALRM" أو "SIGUSR1" وغير ذلك) أو رقم إشارة. يمكن حذف الأحرف "SIG" من اسم الإشارة. تحدد التعليمة المعطاة cmd أو الكتلة الكود البرمجي المراد تشغيله عند إطلاق الإشارة. إذا كانت التعليمة هي السلسلة النصية "IGNORE" أو "SIG_IGN" ، فسيتم تجاهل الإشارة. أما إذا كانت تساوي "DEFAULT" أو "SIG_DFL" ، فسيُستدعى معالج روبي الافتراضي. لكن إذا كانت تساوي "EXIT" ، فستنهي الإشارة البرنامج النصي. إذا كان التعليمة تساوي "SYSTEM_DEFAULT" ، فسيتم استدعاء معالج نظام التشغيل الافتراضي. خلا ذلك، سيتم تشغيل التعليمة أو الكتلة المعطاة. سيتم استدعاء اسم الإشارة الخاص "EXIT"، أو رقم الإشارة 0، قبل إنهاء البرنامج مباشرة. يعيد التابع trap المعالج السابق للإشارة المعينة.
التابع trap
يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد nil. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل.
التابع untrace_var
في حال تعطيل التنبيهات (على سبيل المثال، عبر الراية -W0) ، فإنّ التابع warn لن يفعل شيئا. خلا ذلك، سيُحوّل كل الرسائل إلى سلاسل نصية، ويضيف محرف سطر جديد إلى نهاية السلسلة النصية إذا لم تكن تنتهي بسطر جديد، ثم يستدعي Warning.warn ويمرر إليه تلك السلسلة النصية.
التابع warn
يزيل التابع untrace_var التعقب للتعليمة cmd المحددة على المتغير الكلي المحدد ثم يعيد nil. في حال عدم تمرير الوسيط cmd، فسيزيل التعقب نهائيًا لهذا المتغير ويعيد مصفوفة تحتوي على التعليمات المٌزالة بالفعل.
مصادر