الفرق بين المراجعتين لصفحة: «Ruby/ENV/fetch»

من موسوعة حسوب
< Ruby‏ | ENV
لا ملخص تعديل
مراجعة وتدقيق
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:  التابع <code>fetch</code> الخاص بالصنف <code>ENV</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE:  التابع <code>ENV.fetch</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby ENV]]
[[تصنيف: Ruby ENV]]
يعيد التابع <code>fetch‎</code>  متغير البيئة ذو الإسم <code>name</code>، في حال لم يكن ذلك الاسم موجودًا، ولم يُعطى الوسيط <code>default</code> (انظر فقرة البنية العامة) ولم تُمرّر كتلة برمجية، فسيٌطلق الخطأ <code>KeyError</code>. في حال تمرير كتلة، فستُستدعى مع الاسم المفقود وتعاد قيمتها. إذا أعطي الوسيط <code>default</code>، فستعاد قيمته إن لم تٌعطى أي كتلة.  
يجلب التابع <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>.
القيمة الافتراضية، يُعاد في حال لم يكن الاسم <code>name</code> موجودًا.
==انظر أيضًا==
 
*التابع [[Ruby/ENV/assoc|<code>assoc</code>]]: يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
== القيمة المٌعادة ==
*التابع <code>[[Ruby/ENV/empty|empty?]]‎</code>: يتحقَّق من عدم وجود أي متغيرات بيئة. 
يعيد التابع <code>fetch‎</code> متغير البيئة ذو الإسم <code>name</code>، في حال تمرير كتلة، فستُستدعى مع الاسم المفقود وتعاد قيمتها. إذا أعطي الوسيط <code>default</code>، فستعاد قيمته إن لم تٌعطى أي كتلة.
==مصادر==
 
*[http://ruby-doc.org/core-2.5.1/ENV.html#method-c-fetch قسم التابع fetch في الصنف ENV في توثيق روبي الرسمي.]
== أنظر أيضًا ==
* صفحة الصنف <code>[[Ruby/ENV|ENV]]</code>.
* التابع <code>[[Ruby/ENV/empty|empty?]]‎</code>: يعيد التابع <code>empty?‎</code> القيمة <code>true</code> إن لم يكن هناك أي متغيرات بيئة، وإلا فسيعيد <code>false</code>.
 
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/ENV.html#method-c-fetch قسم التابع fetch في الصنف ENV في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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?: يتحقَّق من عدم وجود أي متغيرات بيئة. 

مصادر