صفحة الصنف 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 اسم متغير البيئة ذا القيمة 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 مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.