الفرق بين المراجعتين لصفحة: «Ruby/ENV»

مراجعة 14:56، 11 نوفمبر 2018

يشبه الصنف ENV دوال التجزئة (hash-like accessor) لمتغيرات البيئة.

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

[]

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

[]

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

`assoc`

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

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

التابع 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 في توثيق روبي الرسمي.

@@ سطر 2: / سطر 2: @@
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby ENV]]
-الصنف<code>ENV</code> يشبه دوال التجزئة (hash-like accessor) لبيئة المتغيرات.
+يشبه الصنف <code>ENV</code> دوال التجزئة (hash-like accessor) لمتغيرات البيئة.
 ==توابع الصنف العامة (Public Class Methods)==
-===[[Ruby/ENV/5B-5D|التابع []]]===
+===[[Ruby/ENV/5B-5D|[]]]===
-يعيد التابع <code>ENV[]‎</code> القيمة الخاصة بمتغير البيئة المعطى على شكل سلسلة نصية، ويعيد <code>nil</code> في حال لم يكن المتغير المعطى موجودًا.
+يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
-===[[Ruby/ENV/5B-5D-3D|التابع  = []]]===
+===[[Ruby/ENV/5B-5D-3D|[]]]===
-يضبط التعبير <code>ENV[name] = value‎</code> القيمة الخاصة بمتغير البيئة المعطى <code>name</code>  ويعطيه القيمة <code>value</code>، إذا كانت قيمة الوسيط <code>value</code> تساوي<code>nil</code> فسيُحذف متغير البيئة. الوسيط <code>name</code> ينبغي أن يكون سلسلة نصية.
+يضبط المعامل <code>[]</code> عندما يُستعمَل بالشكل <code>ENV[name] = value‎</code> قيمة متغير البيئة ذي الاسم<code>name</code> إلى القيمة <code>value</code>. إذا كانت القيمة <code>value</code> المعطاة تساوي <code>nil</code>، فسيُحذَف متغير البيئة ذاك.
-===[[Ruby/ENV/assoc|التابع assoc]]===
+===[[Ruby/ENV/assoc|<code>assoc</code>]]===
-يعيد التابع <code>assoc‎</code> مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم <code>name</code>، أو يعيد <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
+يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا.
-===[[Ruby/ENV/clear|التابع clear]]===
+===[[Ruby/ENV/clear|<code>clear</code>]]===
-يحذف التابع <code>clear‎</code> جميع متغيرات البيئة.
+يحذف جميع متغيرات البيئة.
-===[[Ruby/ENV/delete|التابع delete]]===
+===[[Ruby/ENV/delete|<code>delete</code>]]===
-يحذف التابع <code>delete</code> متغير البيئة ذو الإسم <code>name</code>،  ثم يعيد قيمة ذلك المتغير. في حال تمرير كتلة فستُستدعى في  حال لم يكن ذلك المتغير موجودًا.
+يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا.
 ===[[Ruby/ENV/delete if|التابع delete_if]]===
 يحذف التابع <code>delete_if</code> كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة <code>true</code>.
@@ سطر 31: / سطر 31: @@
 ===[[Ruby/ENV/include|التابع ?include]]===
 يعيد التابع <code>include?‎‎</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم المٌمرّر في الوسيط <code>name</code>. وإلا فسيعيد <code>false.</code>
 ===[[Ruby/ENV/index|التابع index]]===
 التابع <code>index‎</code> صار مُتجاوزًا (Deprecated)، استخدم بدلًا منه التابع <code>[[Ruby/ENV/key|key]]</code>.
 ===[[Ruby/ENV/inspect|التابع inspect]]===
 يعيد التابع <code>inspect‎</code> محتوى البيئة (environment) على شكل سلسلة نصية.
 ===[[Ruby/ENV/invert|التابع invert]]===
 يعيد التابع <code>invert‎</code> تجزئة (hash) جديدة باستخدام أسماء متغيرات البيئة كقيم وقيمها كأسماء (أي يعكسها).
 ===[[Ruby/ENV/keep if|التابع keep_if]]===
 يحذف التابع <code>keep_if</code> كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة <code>false</code>.
 ===[[Ruby/ENV/key|التابع key]]===
 يعيد التابع <code>key</code> اسم متغير البيئة ذا القيمة <code>value</code>. في حال لم تكن القيمة موجودة فسيعيد <code>nil.</code>
 ===[[Ruby/ENV/key-3F|التابع <code>?key</code>]]===
 يعيد التابع <code>?key</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم <code>name</code>.
 ===[[Ruby/ENV/keys|التابع keys]]===
 يعيد التابع <code>keys</code> جميع متغيرات البيئة في مصفوفة.
 ===[[Ruby/ENV/length|التابع length]]===
 يعيد التابع <code>length</code> عدد متغيرات البيئة.
 ===[[Ruby/ENV/member|التابع ?member]]===
 يعيد التابع <code>?member</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم <code>name</code>(انظر فقرة البنية العامة).
 ===[[Ruby/ENV/rassoc|التابع rassoc]]===
 يعيد التابع <code>rassoc‎</code> مصفوفة تضم اسم وقيمة متغير البيئة ذا القيمة <code>value</code> (انظر فقرة البنية العامة)، أو يعيد <code>nil</code> في حال لم تكن تلك القيمة موجودة.
+===[[Ruby/ENV/rehash|التابع rehash]]===
-=== [[Ruby/ENV/rehash|التابع rehash]] ===
 التابع <code>rehash‎</code> لا يفعل أي شيء، فهو موجود لأغراض التوافقية مع الصنف <code>[[Ruby/Hash|Hash]]</code>.
+===[[Ruby/ENV/reject|التابع reject]]===
-=== [[Ruby/ENV/reject|التابع reject]] ===
 التابع <code>reject</code> مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code>، لكنه يعمل على ويعيد نسخة من البيئة.
+===[[Ruby/ENV/reject-21|التابع  <code>reject!‎</code>]]===
-=== [[Ruby/ENV/reject-21|التابع  <code>reject!‎</code>]] ===
 التابع <code>reject!‎</code> مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code>، لكنه يعيد القيمة <code>nil</code> إن لم يحدث أي تغيير.
+===[[Ruby/ENV/replace|التابع replace]]===
-=== [[Ruby/ENV/replace|التابع replace]] ===
 يستبدل التابع <code>replace</code> محتويات متغيرات البيئة بمحتويات قيمة التجزئة المعطاة <code>hash</code>.
+===[[Ruby/ENV/select|التابع select]]===
-=== [[Ruby/ENV/select|التابع select]] ===
 يعيد التابع <code>select‎</code> نسخة من البيئة (environment) تضم المدخلات التي تعيد القيمة <code>true</code> عند تمريرها إلى الكتلة البرمجية.
+===[[Ruby/ENV/select-21|التابع <code>select!‎</code>]]===
-=== [[Ruby/ENV/select-21|التابع <code>select!‎</code>]] ===
 التابع <code>select!‎</code> مكافئ للتابع <code>[[Ruby/ENV/keep if|keep_if]]</code>، لكنه يعيد القيمة <code>nil</code> إن لم يحدث أي تغيير.
+===[[Ruby/ENV/shift|التابع shift]]===
-=== [[Ruby/ENV/shift|التابع shift]] ===
 يحذف التابع <code>shift</code> متغير بيئة (name-value) من  <code>ENV</code>، ثم يعيده على شكل مصفوفة، في حال كانت البيئة فارغة فسيعيد القيمة <code>nil</code>.
+===[[Ruby/ENV/size|التابع size]]===
-=== [[Ruby/ENV/size|التابع size]] ===
 يعيد التابع <code>size</code> عدد متغيرات البيئة.
+===[[Ruby/ENV/store|التابع store]]===
-=== [[Ruby/ENV/store|التابع store]] ===
 يضبط التابع<code>store‎</code> القيمة الخاصة بمتغير البيئة المعطى <code>name</code>  ويعطيه القيمة <code>value</code>، إذا كانت قيمة الوسيط <code>value</code> تساوي <code>nil</code> فسيُحذف متغير البيئة ذاك.
+===[[Ruby/ENV/to a|التابع to_a]]===
-=== [[Ruby/ENV/to a|التابع to_a]] ===
 يحول التابع <code>to_a</code>  متغيرات البيئة إلى مصفوفة مكونة من مصفوفات تضم أسماء وقيم تلك المتغيرات.
+===[[Ruby/ENV/to h|التابع to_h]]===
-=== [[Ruby/ENV/to h|التابع to_h]] ===
 ينشئ التابع <code>to_h</code> تجزئة (hash) تحتوي نسخة من متغيرات البيئة.
+===[[Ruby/ENV/to hash|التابع to_hash]]===
-=== [[Ruby/ENV/to hash|التابع to_hash]] ===
 ينشئ التابع <code>to_hash</code> تجزئة (hash) تحتوي نسخة من متغيرات البيئة.
+===[[Ruby/ENV/to s|التابع to_s]]===
-=== [[Ruby/ENV/to s|التابع to_s]] ===
 يعيد التابع <code>to_s</code> السلسلة النصية “<code>ENV</code>”.
+===[[Ruby/ENV/update|التابع update]]===
-=== [[Ruby/ENV/update|التابع update]] ===
 يضيف  التابع<code>update</code> محتويات التجزئة المعطاة <code>hash</code> إلى متغيرات البيئة. في حال لم تُعطى أي كتلة برمجية ، فسيكتب فوق المداخل (entries) ذات المفاتيح (keys) المكررة. وإلا يتم تحديد قيمة كل اسم مكرر عن طريق استدعاء الكتلة مع تمرير المفتاح (key) وقيمته من البيئة وقيمته من التجزئة المُعطاة <code>hash</code> إليها.
+===[[Ruby/ENV/value-3F|التابع <code>?value</code>]]===
-=== [[Ruby/ENV/value-3F|التابع <code>?value</code>]] ===
 يعيد التابع <code>?value</code> القيمة <code>true</code> إن كان هناك متغير له القيمة <code>value</code>(انظر فقرة البنية العامة).
+===[[Ruby/ENV/values|التابع values]]===
-=== [[Ruby/ENV/values|التابع values]] ===
 يعيد التابع <code>values‎</code> جميع قيم متغيرات البيئة في مصفوفة.
+===[[Ruby/ENV/values at|التابع values_at]]===
-=== [[Ruby/ENV/values at|التابع values_at]] ===
 يعيد التابع <code>values_at</code> مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.
 ==مصادر<span> </span>==
 *[http://ruby-doc.org/core-2.5.1/ENV.html قسم  الصنف ENV في توثيق روبي الرسمي.]