الفرق بين المراجعتين لصفحة: «Ruby/ENV»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 114: | سطر 114: | ||
==مصادر<span> </span>== | ==مصادر<span> </span>== | ||
*[http://ruby-doc.org/core-2.5.1/ENV.html | *[http://ruby-doc.org/core-2.5.1/ENV.html قسم الصنف ENV في توثيق روبي الرسمي.] | ||
مراجعة 23:39، 25 سبتمبر 2018
الصنف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 فسيُحذف متغير البيئة ذاك.
التابع 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 مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.