التابع ENV.fetch في روبي

من موسوعة حسوب
< Ruby‏ | ENV
اذهب إلى التنقل اذهب إلى البحث

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

مصادر