عرض مصدر Ruby/ENV

<noinclude>{{DISPLAYTITLE: صفحة الصنف <code>ENV</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby ENV]]
 
يشبه الصنف <code>ENV</code> [[Ruby/Hash|جداول hash]] كثيرًا ويُستعمل للوصول إلى متغيرات البيئة.

==توابع الصنف العامة (Public Class Methods)==
===[[Ruby/ENV/5B-5D|[]]]===
يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
===[[Ruby/ENV/5B-5D-3D|[]]]===
يضبط المعامل <code>[]</code> عندما يُستعمَل بالشكل <code>ENV[name] = value‎</code> قيمة متغير البيئة ذي الاسم<code>name</code> إلى القيمة <code>value</code>. إذا كانت القيمة <code>value</code> المعطاة تساوي <code>nil</code>، فسيُحذَف متغير البيئة ذاك.
===[[Ruby/ENV/assoc|<code>assoc</code>]]===
يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
===[[Ruby/ENV/clear|<code>clear</code>]]===
يحذف جميع متغيرات البيئة.
===[[Ruby/ENV/delete|<code>delete</code>]]===
يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا.
===[[Ruby/ENV/delete if|<code>delete_if</code>]]===
يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا.
===[[Ruby/ENV/each|<code>each</code>]]===
يجلب أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها فُرادى إلى الكتلة البرمجية المعطاة.
===[[Ruby/ENV/each key|<code>each_key</code>]]===
يجلب أسماء متغيرات البيئة بالتتابع، ويرسلها فُرادَى إلى الكتلة البرمجية المعطاة.
===[[Ruby/ENV/each pair|<code>each_pair</code>]]===
يجلب الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة.
===[[Ruby/ENV/each value|<code>each_value</code>]]===
يجلب قيمة كل متغير من متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة.

=== <code>[[Ruby/ENV/empty|empty?‎]]</code> ===
يتحقَّق من عدم وجود أي متغيرات بيئة.

=== <code>[[Ruby/ENV/fetch|fetch‎]]</code> ===
يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ
===[[Ruby/ENV/has key|<code>?has_key</code>]]===
يتحقَّق إن كان هناك متغير بيئة باسم محدَّد.
===[[Ruby/ENV/has value|<code>?has_value</code>]]===
يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة.
===[[Ruby/ENV/include|<code>?include</code>]]===
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد.
===[[Ruby/ENV/index|<code>index</code>]]===
أصبح مهملًا (Deprecated). استخدم بدلًا منه التابع <code>[[Ruby/ENV/key|key]]</code>.
===[[Ruby/ENV/inspect|<code>inspect</code>]]===
يعيد محتوى البيئة (environment) في سلسلة نصية.
===[[Ruby/ENV/invert|<code>invert</code>]]===
يعكس بين أسماء وقيم متغيرات البيئة ثمَّ يعيدها في كائنٍ جديدٍ من النوع <code>[[Ruby/Hash|Hash]]</code>.
===[[Ruby/ENV/keep if|<code>keep_if</code>]]===
يُبقِي كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا ويحذف البقية.
===[[Ruby/ENV/key|key]]===
يعيد التابع <code>key</code> اسم متغير البيئة ذا القيمة <code>value</code>. في حال لم تكن القيمة موجودة فسيعيد <code>nil.</code>
===[[Ruby/ENV/key-3F|التابع <code>?key</code>]]===
يعيد التابع <code>?key</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم <code>name</code>.
===[[Ruby/ENV/keys|التابع keys]]===
يعيد التابع <code>keys</code> جميع متغيرات البيئة في مصفوفة.
===[[Ruby/ENV/length|التابع length]]===
يعيد التابع <code>length</code> عدد متغيرات البيئة.
===[[Ruby/ENV/member|التابع ?member]]===
يعيد التابع <code>?member</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم <code>name</code>(انظر فقرة البنية العامة).
===[[Ruby/ENV/rassoc|التابع rassoc]]===
يعيد التابع <code>rassoc‎</code> مصفوفة تضم اسم وقيمة متغير البيئة ذا القيمة <code>value</code> (انظر فقرة البنية العامة)، أو يعيد <code>nil</code> في حال لم تكن تلك القيمة موجودة. 
===[[Ruby/ENV/rehash|التابع rehash]]===
التابع <code>rehash‎</code> لا يفعل أي شيء، فهو موجود لأغراض التوافقية مع الصنف <code>[[Ruby/Hash|Hash]]</code>. 
===[[Ruby/ENV/reject|التابع reject]]===
التابع <code>reject</code> مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code>، لكنه يعمل على ويعيد نسخة من البيئة. 
===[[Ruby/ENV/reject-21|التابع  <code>reject!‎</code>]]===
التابع <code>reject!‎</code> مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code>، لكنه يعيد القيمة <code>nil</code> إن لم يحدث أي تغيير.
===[[Ruby/ENV/replace|التابع replace]]===
يستبدل التابع <code>replace</code> محتويات متغيرات البيئة بمحتويات قيمة التجزئة المعطاة <code>hash</code>. 
===[[Ruby/ENV/select|التابع select]]===
يعيد التابع <code>select‎</code> نسخة من البيئة (environment) تضم المدخلات التي تعيد القيمة <code>true</code> عند تمريرها إلى الكتلة البرمجية. 
===[[Ruby/ENV/select-21|التابع <code>select!‎</code>]]===
التابع <code>select!‎</code> مكافئ للتابع <code>[[Ruby/ENV/keep if|keep_if]]</code>، لكنه يعيد القيمة <code>nil</code> إن لم يحدث أي تغيير. 
===[[Ruby/ENV/shift|التابع shift]]===
يحذف التابع <code>shift</code> متغير بيئة (name-value) من  <code>ENV</code>، ثم يعيده على شكل مصفوفة، في حال كانت البيئة فارغة فسيعيد القيمة <code>nil</code>. 
===[[Ruby/ENV/size|التابع size]]===
يعيد التابع <code>size</code> عدد متغيرات البيئة.
===[[Ruby/ENV/store|التابع store]]===
يضبط التابع<code>store‎</code> القيمة الخاصة بمتغير البيئة المعطى <code>name</code>  ويعطيه القيمة <code>value</code>، إذا كانت قيمة الوسيط <code>value</code> تساوي <code>nil</code> فسيُحذف متغير البيئة ذاك.  
===[[Ruby/ENV/to a|التابع to_a]]===
يحول التابع <code>to_a</code>  متغيرات البيئة إلى مصفوفة مكونة من مصفوفات تضم أسماء وقيم تلك المتغيرات. 
===[[Ruby/ENV/to h|التابع to_h]]===
ينشئ التابع <code>to_h</code> تجزئة (hash) تحتوي نسخة من متغيرات البيئة. 
===[[Ruby/ENV/to hash|التابع to_hash]]===
ينشئ التابع <code>to_hash</code> تجزئة (hash) تحتوي نسخة من متغيرات البيئة. 
===[[Ruby/ENV/to s|التابع to_s]]===
يعيد التابع <code>to_s</code> السلسلة النصية “<code>ENV</code>”. 
===[[Ruby/ENV/update|التابع update]]===
يضيف  التابع<code>update</code> محتويات التجزئة المعطاة <code>hash</code> إلى متغيرات البيئة. في حال لم تُعطى أي كتلة برمجية ، فسيكتب فوق المداخل (entries) ذات المفاتيح (keys) المكررة. وإلا يتم تحديد قيمة كل اسم مكرر عن طريق استدعاء الكتلة مع تمرير المفتاح (key) وقيمته من البيئة وقيمته من التجزئة المُعطاة <code>hash</code> إليها.  
===[[Ruby/ENV/value-3F|التابع <code>?value</code>]]===
يعيد التابع <code>?value</code> القيمة <code>true</code> إن كان هناك متغير له القيمة <code>value</code>(انظر فقرة البنية العامة).
===[[Ruby/ENV/values|التابع values]]===
يعيد التابع <code>values‎</code> جميع قيم متغيرات البيئة في مصفوفة. 
===[[Ruby/ENV/values at|التابع values_at]]===
يعيد التابع <code>values_at</code> مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.
==مصادر<span> </span>==
*[http://ruby-doc.org/core-2.5.1/ENV.html قسم  الصنف ENV في توثيق روبي الرسمي.]