الفرق بين المراجعتين ل"Ruby/ENV/fetch"

من موسوعة حسوب
< Ruby‏ | ENV
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:  التابع <code>fetch</code> الخاص بالصنف <code>ENV</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ru...')
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby ENV]]
 
[[تصنيف: Ruby ENV]]
يعيد التابع <code>assoc‎</code> مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم <code>name</code>، أو يعيد <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.  
+
يعيد التابع <code>fetch‎</code> متغير البيئة ذو الإسم <code>name</code>، في حال لم يكن ذلك الاسم موجودًا، ولم يُعطى الوسيط <code>default</code> (انظر فقرة البنية العامة) ولم تُمرّر كتلة برمجية، فسيٌطلق الخطأ <code>KeyError</code>. في حال تمرير كتلة، فستُستدعى مع الاسم المفقود لإعادة قيمة. إذا أعطي الوسيط <code>default</code>، فستعاد قيمته إن لم تٌعطى أي كتلة.  
  
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="ruby">
 
<syntaxhighlight lang="ruby">
assoc(name) → Array or nil
+
fetch(name) → value
 +
fetch(name, default) → value
 +
fetch(name) { |missing_name| ... } → value
 
</syntaxhighlight>
 
</syntaxhighlight>
  
سطر 14: سطر 16:
 
=== <code>name</code> ===
 
=== <code>name</code> ===
 
اسم متغير البيئة المعطى.
 
اسم متغير البيئة المعطى.
 +
 +
=== <code>default</code> ===
 +
القيمة الافتراضية، يُعاد في حال لم يكن الاسم <code>name</code> موجودًا.
  
 
== القيمة المٌعادة ==
 
== القيمة المٌعادة ==
يعيد التابع <code>assoc‎</code> مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم <code>name</code>، أو يعيد <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
+
يعيد التابع <code>fetch‎</code> متغير البيئة ذو الإسم <code>name</code>، في حال لم يكن ذلك الاسم موجودًا، ولم يُعطى الوسيط <code>default</code> (انظر فقرة البنية العامة) ولم تُمرّر كتلة برمجية، فسيٌطلق الخطأ <code>KeyError</code>. في حال تمرير كتلة، فستُستدعى مع الاسم المفقود لإعادة قيمة. إذا أعطي الوسيط <code>default</code>، فستعاد قيمته إن لم تٌعطى أي كتلة.
  
 
== أنظر أيضًا ==
 
== أنظر أيضًا ==
سطر 23: سطر 28:
  
 
== مصادر ==
 
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/ENV.html#method-c-assoc قسم  التابع assoc في الصنف ENV في توثيق روبي الرسمي.]
+
* [http://ruby-doc.org/core-2.5.1/ENV.html#method-c-assoc قسم  التابع fetch في الصنف ENV في توثيق روبي الرسمي.]

مراجعة 11:37، 25 سبتمبر 2018

يعيد التابع fetch‎ متغير البيئة ذو الإسم name، في حال لم يكن ذلك الاسم موجودًا، ولم يُعطى الوسيط default (انظر فقرة البنية العامة) ولم تُمرّر كتلة برمجية، فسيٌطلق الخطأ KeyError. في حال تمرير كتلة، فستُستدعى مع الاسم المفقود لإعادة قيمة. إذا أعطي الوسيط default، فستعاد قيمته إن لم تٌعطى أي كتلة.

البنية العامة

fetch(name)  value 
fetch(name, default)  value
fetch(name) { |missing_name| ... }  value

المعاملات

name

اسم متغير البيئة المعطى.

default

القيمة الافتراضية، يُعاد في حال لم يكن الاسم name موجودًا.

القيمة المٌعادة

يعيد التابع fetch‎ متغير البيئة ذو الإسم name، في حال لم يكن ذلك الاسم موجودًا، ولم يُعطى الوسيط default (انظر فقرة البنية العامة) ولم تُمرّر كتلة برمجية، فسيٌطلق الخطأ KeyError. في حال تمرير كتلة، فستُستدعى مع الاسم المفقود لإعادة قيمة. إذا أعطي الوسيط default، فستعاد قيمته إن لم تٌعطى أي كتلة.

أنظر أيضًا

  • صفحة الصنف ENV.
  • التابع []: يعيد التابع ENV[]‎ القيمة الخاصة بمتغير البيئة المعطى على شكل سلسلة نصية، ويعيد nil في حال لم يكن المتغير المعطى موجودًا.

مصادر