الفرق بين المراجعتين لصفحة: «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) على شكل سلسلة نصية.