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

يشبه الصنف ENV جداول hash كثيرًا ويُستعمل للوصول إلى متغيرات البيئة.

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

[]

يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.

[]

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

`assoc`

يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil في حال لم يكن ذلك المتغير موجودًا.

`delete`

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

`delete_if`

يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا.

`each`

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

`each_key`

يجلب أسماء متغيرات البيئة بالتتابع، ويرسلها فُرادَى إلى الكتلة البرمجية المعطاة.

`each_pair`

يجلب الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة.

`each_value`

يجلب قيمة كل متغير من متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة.

`?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.

التابع 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 محتويات التجزئة المعطاة hash إلى متغيرات البيئة. في حال لم تُعطى أي كتلة برمجية ، فسيكتب فوق المداخل (entries) ذات المفاتيح (keys) المكررة. وإلا يتم تحديد قيمة كل اسم مكرر عن طريق استدعاء الكتلة مع تمرير المفتاح (key) وقيمته من البيئة وقيمته من التجزئة المُعطاة hash إليها.

مصادر

قسم الصنف ENV في توثيق روبي الرسمي.