الفرق بين المراجعتين لصفحة: «Ruby/ENV»
لا ملخص تعديل |
لا ملخص تعديل |
||
سطر 4: | سطر 4: | ||
الصنف<code>ENV</code> يشبه دوال التجزئة (hash-like accessor) لبيئة المتغيرات. | الصنف<code>ENV</code> يشبه دوال التجزئة (hash-like accessor) لبيئة المتغيرات. | ||
==توابع الصنف العامة (Public Class Methods)== | ==توابع الصنف العامة (Public Class Methods)== | ||
===[[Ruby/ENV/5B-5D|التابع []]]=== | |||
=== [[Ruby/ENV/5B-5D|التابع []]] === | |||
يعيد التابع <code>ENV[]</code> القيمة الخاصة بمتغير البيئة المعطى على شكل سلسلة نصية، ويعيد <code>nil</code> في حال لم يكن المتغير المعطى موجودًا. | يعيد التابع <code>ENV[]</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>ENV[name] = value</code> القيمة الخاصة بمتغير البيئة المعطى <code>name</code> ويعطيه القيمة <code>value</code>، إذا كانت قيمة الوسيط <code>value</code> تساوي<code>nil</code> فسيُحذف متغير البيئة. الوسيط <code>name</code> ينبغي أن يكون سلسلة نصية. | ||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
=== [[Ruby/ENV/assoc|التابع assoc]] === | |||
يعيد التابع <code>assoc</code> مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم <code>name</code>، أو يعيد <code>nil</code> في حال لم يكن ذلك المتغير موجودًا. | يعيد التابع <code>assoc</code> مصفوفة تضم اسم وقيمة متغير البيئة ذو الإسم <code>name</code>، أو يعيد <code>nil</code> في حال لم يكن ذلك المتغير موجودًا. | ||
===[[Ruby/ENV/clear|التابع clear]]=== | |||
=== [[Ruby/ENV/clear|التابع clear]] === | |||
يحذف التابع <code>clear</code> جميع متغيرات البيئة. | يحذف التابع <code>clear</code> جميع متغيرات البيئة. | ||
===[[Ruby/ENV/delete|التابع delete]]=== | |||
=== [[Ruby/ENV/delete|التابع delete]] === | |||
يحذف التابع <code>delete</code> متغير البيئة ذو الإسم <code>name</code>، ثم يعيد قيمة ذلك المتغير. في حال تمرير كتلة فستُستدعى في حال لم يكن ذلك المتغير موجودًا. | يحذف التابع <code>delete</code> متغير البيئة ذو الإسم <code>name</code>، ثم يعيد قيمة ذلك المتغير. في حال تمرير كتلة فستُستدعى في حال لم يكن ذلك المتغير موجودًا. | ||
===[[Ruby/ENV/delete if|التابع delete_if]]=== | |||
=== [[Ruby/ENV/delete if|التابع delete_if]] === | |||
يحذف التابع <code>delete_if</code> كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة <code>true</code>. | يحذف التابع <code>delete_if</code> كل متغيرات البيئة التي تعيد عند تمريرها إلى الكتلة البرمجية المعطاة القيمة <code>true</code>. | ||
===[[Ruby/ENV/each|التابع each]]=== | |||
=== [[Ruby/ENV/each|التابع each]] === | |||
يعيد التابع <code>each</code> اسم وقيمة كل متغير من متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | يعيد التابع <code>each</code> اسم وقيمة كل متغير من متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
===[[Ruby/ENV/each key|التابع each_key]]=== | |||
=== [[Ruby/ENV/each key|التابع each_key]] === | |||
يعيد التابع <code>each_key</code> أسماء متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | يعيد التابع <code>each_key</code> أسماء متغيرات البيئة بالتتابع، ثم يرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
===[[Ruby/ENV/each pair|التابع each_pair]]=== | |||
=== [[Ruby/ENV/each pair|التابع each_pair]] === | |||
يعيد التابع <code>each_pair</code> أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | يعيد التابع <code>each_pair</code> أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
===[[Ruby/ENV/each value|التابع each_value]]=== | |||
=== [[Ruby/ENV/each value|التابع each_value]] === | |||
يعيد التابع <code>each_value</code> قيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | يعيد التابع <code>each_value</code> قيم متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة، في حال عدم تمرير كتلة برمجية فسيُعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
===[[Ruby/ENV/has key|التابع ?has_key]]=== | ===[[Ruby/ENV/has key|التابع ?has_key]]=== | ||
سطر 39: | سطر 29: | ||
===[[Ruby/ENV/has value|التابع ?has_value]]=== | ===[[Ruby/ENV/has value|التابع ?has_value]]=== | ||
يعيد التابع <code>has_value?</code> القيمة <code>true</code> إن كان هناك متغير بيئة له القيمة المٌمرّرة في الوسيط <code>value</code>. وإلا فسيعيد <code>false.</code> | يعيد التابع <code>has_value?</code> القيمة <code>true</code> إن كان هناك متغير بيئة له القيمة المٌمرّرة في الوسيط <code>value</code>. وإلا فسيعيد <code>false.</code> | ||
===[[Ruby/ENV/include|التابع ?include]]=== | |||
يعيد التابع <code>include?</code> القيمة <code>true</code> إن كان هناك متغير بيئة بالاسم المٌمرّر في الوسيط <code>name</code>. وإلا فسيعيد <code>false.</code> | |||
=== [[Ruby/ENV/ | ===[[Ruby/ENV/index|التابع index]]=== | ||
التابع <code>index</code> صار مُتجاوزًا (Deprecated)، استخدم بدلًا منه التابع <code>[[Ruby/ENV/key|key]]</code>. | |||
=== [[Ruby/ENV/ | ===[[Ruby/ENV/inspect|التابع inspect]]=== | ||
يعيد التابع <code>inspect</code> محتوى البيئة (environment) على شكل سلسلة نصية. | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
===[[Ruby/ENV/assoc|التابع assoc]]=== | |||
==مصادر<span> </span>== | ==مصادر<span> </span>== | ||
*[http://ruby-doc.org/core-2.5.1/ENV.html#method-c-inspect قسم الصنف ENV في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/ENV.html#method-c-inspect قسم الصنف ENV في توثيق روبي الرسمي.] |
مراجعة 16:57، 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) على شكل سلسلة نصية.