الفرق بين المراجعتين لصفحة: «Ruby/ENV/fetch»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) مراجعة وتدقيق |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>fetch | <noinclude>{{DISPLAYTITLE: التابع <code>ENV.fetch</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ENV]] | [[تصنيف: Ruby ENV]] | ||
يجلب التابع <code>fetch</code> قيمة متغير بيئة ذي اسمٍ محدَّدٍ؛ في حال لم يكن ذلك الاسم موجودًا ولم يُمرَّر أي شي إلى التابع ولا حتى كتلة برمجية، فسيٌطلق الخطأ <code>KeyError</code>. أمَّا في حال تمرير كتلة، فستُستدعَى مع الاسم الذي لم يُعثَر عليه ويعاد ناتج تنفيذها، أو إذا أعطي الوسيط <code>default</code>، فستعاد قيمته إن لم تٌعطَ أي كتلة في تلك الحالة. | |||
==البنية العامة== | |||
== البنية العامة == | |||
<syntaxhighlight lang="ruby"> | <syntaxhighlight lang="ruby"> | ||
fetch(name) → value | fetch(name) → value | ||
سطر 11: | سطر 10: | ||
fetch(name) { |missing_name| ... } → value | fetch(name) { |missing_name| ... } → value | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
== المعاملات == | ===<code>name</code>=== | ||
اسم متغير البيئة المراد البحث عنه وجلب قيمته. | |||
=== <code>name</code> === | ===<code>default</code>=== | ||
اسم متغير البيئة | القيمة الافتراضية التي ستُعاد في حال لم يكن الاسم <code>name</code> موجودًا. | ||
==القيمة المعادة== | |||
=== <code>default</code> === | يعاد متغير البيئة ذو الاسم <code>name</code>. إن لم يُعثر على المتغير ذي الاسم <code>name</code>، فإمَّا أن تُعاد القيمة <code>default</code> الافتراضية أو يعاد ناتج تنفيذ الكتلة <code>block</code> بعد تمرير اسم المتغير الذي لم يُعثر عليه. إن لم يُعطَ المعامل <code>default</code> ولا الكتلة <code>block</code>، فسيٌطلق الخطأ <code>KeyError</code>. | ||
القيمة | ==انظر أيضًا== | ||
*التابع [[Ruby/ENV/assoc|<code>assoc</code>]]: يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا. | |||
== القيمة | *التابع <code>[[Ruby/ENV/empty|empty?]]</code>: يتحقَّق من عدم وجود أي متغيرات بيئة. | ||
==مصادر== | |||
*[http://ruby-doc.org/core-2.5.1/ENV.html#method-c-fetch قسم التابع fetch في الصنف ENV في توثيق روبي الرسمي.] | |||
== | |||
* | |||
* التابع <code>[[Ruby/ENV/empty|empty?]]</code>: | |||
== مصادر == | |||
* [http://ruby-doc.org/core-2.5.1/ENV.html#method-c-fetch قسم |
المراجعة الحالية بتاريخ 11:58، 12 نوفمبر 2018
يجلب التابع fetch
قيمة متغير بيئة ذي اسمٍ محدَّدٍ؛ في حال لم يكن ذلك الاسم موجودًا ولم يُمرَّر أي شي إلى التابع ولا حتى كتلة برمجية، فسيٌطلق الخطأ KeyError
. أمَّا في حال تمرير كتلة، فستُستدعَى مع الاسم الذي لم يُعثَر عليه ويعاد ناتج تنفيذها، أو إذا أعطي الوسيط default
، فستعاد قيمته إن لم تٌعطَ أي كتلة في تلك الحالة.
البنية العامة
fetch(name) → value
fetch(name, default) → value
fetch(name) { |missing_name| ... } → value
المعاملات
name
اسم متغير البيئة المراد البحث عنه وجلب قيمته.
default
القيمة الافتراضية التي ستُعاد في حال لم يكن الاسم name
موجودًا.
القيمة المعادة
يعاد متغير البيئة ذو الاسم name
. إن لم يُعثر على المتغير ذي الاسم name
، فإمَّا أن تُعاد القيمة default
الافتراضية أو يعاد ناتج تنفيذ الكتلة block
بعد تمرير اسم المتغير الذي لم يُعثر عليه. إن لم يُعطَ المعامل default
ولا الكتلة block
، فسيٌطلق الخطأ KeyError
.
انظر أيضًا
- التابع
assoc
: يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمةnil
في حال لم يكن ذلك المتغير موجودًا. - التابع
empty?
: يتحقَّق من عدم وجود أي متغيرات بيئة.