صفحة الصنف `ENV` في روبي

الصنفENV يشبه دوال التجزئة (hash-like accessor) لبيئة المتغيرات.

توابع الصنف العامة (Public Class Methods)

التابع []

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

يضبط التعبير ENV[name] = value‎ القيمة الخاصة بمتغير البيئة المعطى name ويعطيه القيمة value، إذا كانت قيمة الوسيط value تساويnil فسيُحذف متغير البيئة. الوسيط name ينبغي أن يكون سلسلة نصية.

التابع assoc

يعيد التابع assoc‎ مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم name، أو يعيد nil في حال لم يكن ذلك المتغير موجودًا.

التابع clear

يحذف التابع clear‎ جميع متغيرات البيئة.

التابع delete

يحذف التابع delete متغير البيئة ذو الإسم name، ثم يعيد قيمة ذلك المتغير. في حال تمرير كتلة فستُستدعى في حال لم يكن ذلك المتغير موجودًا.

التابع delete_if

يحذف التابع delete_if كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة true.

التابع each

يعيد التابع each‎ اسم وقيمة كل متغير من متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع Enumerator.

التابع each_key

يعيد التابع each_key‎ أسماء متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع Enumerator.

التابع each_pair

يعيد التابع each_pair‎ أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع Enumerator.

التابع each_value

يعيد التابع each_value‎ قيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع Enumerator.

التابع ?has_key

يعيد التابع has_key?‎‎ القيمة true إن كان هناك متغير بيئة بالاسم المٌمرّر في الوسيط name. وإلا فسيعيد false.

التابع ?has_value

يعيد التابع has_value?‎‎ القيمة true إن كان هناك متغير بيئة له القيمة المٌمرّرة في الوسيط value. وإلا فسيعيد false.

التابع ?include

يعيد التابع include?‎‎ القيمة true إن كان هناك متغير بيئة بالاسم المٌمرّر في الوسيط name. وإلا فسيعيد false.

التابع index

التابع index‎ صار مُتجاوزًا (Deprecated)، استخدم بدلًا منه التابع key.

التابع inspect

يعيد التابع inspect‎ محتوى البيئة (environment) على شكل سلسلة نصية.

التابع invert

يعيد التابع invert‎ تجزئة (hash) جديدة باستخدام أسماء متغيرات البيئة كقيم وقيمها كأسماء (أي يعكسها).

التابع keep_if

يحذف التابع keep_if كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة false.

التابع key

يعيد التابع key اسم متغير البيئة ذا القيمة value. في حال لم تكن القيمة موجودة فسيعيد nil.

التابع `?key`

يعيد التابع ?key القيمة true إن كان هناك متغير بيئة بالاسم name.

التابع keys

يعيد التابع keys جميع متغيرات البيئة في مصفوفة.

التابع length

يعيد التابع length عدد متغيرات البيئة.

التابع ?member

يعيد التابع ?member القيمة true إن كان هناك متغير بيئة بالاسم name(انظر فقرة البنية العامة).

التابع rassoc

يعيد التابع rassoc‎ مصفوفة تضم اسم وقيمة متغير البيئة ذا القيمة value (انظر فقرة البنية العامة)، أو يعيد nil في حال لم تكن تلك القيمة موجودة.

التابع rehash

التابع rehash‎ لا يفعل أي شيء، فهو موجود لأغراض التوافقية مع الصنف Hash.

التابع reject

التابع reject مشابه للتابع delete_if، لكنه يعمل على ويعيد نسخة من البيئة.

التابع `reject!‎`

التابع reject!‎ مشابه للتابع delete_if، لكنه يعيد القيمة nil إن لم يحدث أي تغيير.

التابع replace

يستبدل التابع replace محتويات متغيرات البيئة بمحتويات قيمة التجزئة المعطاة hash.

التابع select

يعيد التابع select‎ نسخة من البيئة (environment) تضم المدخلات التي تعيد القيمة true عند تمريرها إلى الكتلة البرمجية.

التابع `select!‎`

التابع select!‎ مكافئ للتابع keep_if، لكنه يعيد القيمة nil إن لم يحدث أي تغيير.

التابع shift

يحذف التابع shift متغير بيئة (name-value) من ENV، ثم يعيده على شكل مصفوفة، في حال كانت البيئة فارغة فسيعيد القيمة nil.

التابع size

يعيد التابع size عدد متغيرات البيئة.

التابع store

يضبط التابعstore‎ القيمة الخاصة بمتغير البيئة المعطى name ويعطيه القيمة value، إذا كانت قيمة الوسيط value تساوي nil فسيُحذف متغير البيئة ذاك.