الصنف ENV في روبي
يشبه الصنف ENV الجداول Hash كثيرًا ويُستعمل للوصول إلى متغيرات البيئة.
توابع الصنف العامة (Public Class Methods)
[]
يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.
[]
يضبط هذا المعامل عندما يُستعمَل بالشكل ENV[name] = value قيمة متغير البيئة ذي الاسمname إلى القيمة value. إذا كانت القيمة value المعطاة تساوي nil، فسيُحذَف متغير البيئة ذاك.
assoc
يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.
clear
يحذف جميع متغيرات البيئة.
delete
يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا.
delete_if
يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا.
each
يجلب أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها فُرادى إلى الكتلة البرمجية المعطاة.
each_key
يجلب أسماء متغيرات البيئة بالتتابع، ويرسلها فُرادَى إلى الكتلة البرمجية المعطاة.
each_pair
يجلب الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة.
each_value
يجلب قيمة كل متغير من متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة.
empty?
يتحقَّق من عدم وجود أي متغيرات بيئة.
fetch
يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ.
?has_key
يتحقَّق إن كان هناك متغير بيئة باسم محدَّد.
?has_value
يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة.
?include
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد.
index
أصبح مهملًا (Deprecated). استخدم بدلًا منه التابع key.
inspect
يعيد محتوى البيئة (environment) في سلسلة نصية.
invert
يعكس بين أسماء وقيم متغيرات البيئة ثمَّ يعيدها في كائنٍ جديدٍ من النوع Hash.
keep_if
يُبقِي كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا ويحذف البقية.
key
يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة.
?key
يتحقَّق إن كان هنالك متغير بيئة باسم محدَّد.
keys
يعيد جميع متغيرات البيئة في مصفوفة.
length
يعيد عدد متغيرات البيئة الموجودة.
?member
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد.
rassoc
يعيد مصفوفة تضم اسم وقيمة متغير بيئة ذي قيمة محدَّدة، أو يعيد القيمة nil في حال لم تكن تلك القيمة موجودة.
rehash
لا يفعل هذا التابع أي شيء، فهو موجود لأغراض التوافقية مع الصنف Hash.
reject
مشابه للتابع delete_if لكنه يعمل على نسخة من البيئة وليس البيئة نفسها.
reject!
مشابه للتابع delete_if لكنه يعيد القيمة nil إن لم يحدث أي تغيير في البيئة.
replace
يُبدِّل محتويات الجدول hash المعطى مكان محتويات متغيرات البيئة الحالية.
select
يعيد نسخة من البيئة (environment) تضم المدخلات التي حقَّقت شرطًا معيَّنًا.
select!
مكافئ للتابع keep_if لكنه يعيد القيمة nil إن لم يُحدِث أي تغيير في البيئة.
shift
يحذف متغير بيئة (اسم المتغير وقيمته) من البيئة ENV ثمَّ يعيده في مصفوفة.
size
يعيد عدد متغيرات البيئة.
store
يضبط قيمة متغير بيئة ذي اسمٍ محدَّدٍ إلى قيمة معيَّنة.
to_a
يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.
to_h
ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.
to_hash
ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.
to_s
يعيد السلسلة النصية “ENV”.
update
يضيف محتويات الجدول Hash المعطى إلى متغيرات البيئة الحالية.
?value
يتحقَّق إن كان هناك متغير له قيمة محدَّدة.
values
يعيد مصفوفة تضم جميع قيم متغيرات البيئة.
values_at
يعيد مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.