صفحة الصنف ENV في روبي
يشبه الصنف ENV دوال التجزئة (hash-like accessor) لمتغيرات البيئة.
توابع الصنف العامة (Public Class Methods)
[]
يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.
[]
يضبط المعامل [] عندما يُستعمَل بالشكل ENV[name] = value قيمة متغير البيئة ذي الاسمname إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك.
assoc
يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.
clear
يحذف جميع متغيرات البيئة.
delete
يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا.
التابع 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 فسيُحذف متغير البيئة ذاك.
التابع to_a
يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات تضم أسماء وقيم تلك المتغيرات.
التابع to_h
ينشئ التابع to_h تجزئة (hash) تحتوي نسخة من متغيرات البيئة.
التابع to_hash
ينشئ التابع to_hash تجزئة (hash) تحتوي نسخة من متغيرات البيئة.
التابع to_s
يعيد التابع to_s السلسلة النصية “ENV”.
التابع update
يضيف التابعupdate محتويات التجزئة المعطاة hash إلى متغيرات البيئة. في حال لم تُعطى أي كتلة برمجية ، فسيكتب فوق المداخل (entries) ذات المفاتيح (keys) المكررة. وإلا يتم تحديد قيمة كل اسم مكرر عن طريق استدعاء الكتلة مع تمرير المفتاح (key) وقيمته من البيئة وقيمته من التجزئة المُعطاة hash إليها.
التابع ?value
يعيد التابع ?value القيمة true إن كان هناك متغير له القيمة value(انظر فقرة البنية العامة).
التابع values
يعيد التابع values جميع قيم متغيرات البيئة في مصفوفة.
التابع values_at
يعيد التابع values_at مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.