الفرق بين المراجعتين لصفحة: «Ruby/ENV»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق |
||
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:الصنف <code>ENV</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Class]] | |||
[[تصنيف: Ruby ENV]] | [[تصنيف: Ruby ENV]] | ||
الصنف<code>ENV</code> | يشبه الصنف <code>ENV</code> الجداول <code>[[Ruby/Hash|Hash]]</code> كثيرًا ويُستعمل للوصول إلى متغيرات البيئة. | ||
==توابع الصنف العامة (Public Class Methods)== | ==توابع الصنف العامة (Public Class Methods)== | ||
===[[Ruby/ENV/5B-5D| | ===[[Ruby/ENV/5B-5D|[]]]=== | ||
يعيد | يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة <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>، فسيُحذَف متغير البيئة ذاك. | ||
===[[Ruby/ENV/assoc| | ===[[Ruby/ENV/assoc|<code>assoc</code>]]=== | ||
يعيد | يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة <code>nil</code> في حال لم يكن ذلك المتغير موجودًا. | ||
===[[Ruby/ENV/clear| | ===[[Ruby/ENV/clear|<code>clear</code>]]=== | ||
يحذف | يحذف جميع متغيرات البيئة. | ||
===[[Ruby/ENV/delete| | ===[[Ruby/ENV/delete|<code>delete</code>]]=== | ||
يحذف | يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا. | ||
===[[Ruby/ENV/delete if| | ===[[Ruby/ENV/delete if|<code>delete_if</code>]]=== | ||
يحذف | يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا. | ||
===[[Ruby/ENV/each| | ===[[Ruby/ENV/each|<code>each</code>]]=== | ||
يجلب أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها فُرادى إلى الكتلة البرمجية المعطاة. | |||
===[[Ruby/ENV/each key| | ===[[Ruby/ENV/each key|<code>each_key</code>]]=== | ||
يجلب أسماء متغيرات البيئة بالتتابع، ويرسلها فُرادَى إلى الكتلة البرمجية المعطاة. | |||
===[[Ruby/ENV/each pair|<code>each_pair</code>]]=== | |||
يجلب الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة. | |||
===[[Ruby/ENV/each value|<code>each_value</code>]]=== | |||
يجلب قيمة كل متغير من متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة. | |||
===[[Ruby/ENV/ | ===<code>[[Ruby/ENV/empty|empty?]]</code>=== | ||
يتحقَّق من عدم وجود أي متغيرات بيئة. | |||
===<code>[[Ruby/ENV/fetch|fetch]]</code>=== | |||
===[[Ruby/ENV/has value| | يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ. | ||
===[[Ruby/ENV/has key|<code>?has_key</code>]]=== | |||
===[[Ruby/ENV/ | يتحقَّق إن كان هناك متغير بيئة باسم محدَّد. | ||
يعيد | ===[[Ruby/ENV/has value|<code>?has_value</code>]]=== | ||
يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة. | |||
===[[Ruby/ENV/ | ===[[Ruby/ENV/include|<code>?include</code>]]=== | ||
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد. | |||
===[[Ruby/ENV/index|<code>index</code>]]=== | |||
===[[Ruby/ENV/ | أصبح مهملًا (Deprecated). استخدم بدلًا منه التابع <code>[[Ruby/ENV/key|key]]</code>. | ||
يعيد | ===[[Ruby/ENV/inspect|<code>inspect</code>]]=== | ||
يعيد محتوى البيئة (environment) في سلسلة نصية. | |||
===[[Ruby/ENV/ | ===[[Ruby/ENV/invert|<code>invert</code>]]=== | ||
يعيد | يعكس بين أسماء وقيم متغيرات البيئة ثمَّ يعيدها في كائنٍ جديدٍ من النوع <code>[[Ruby/Hash|Hash]]</code>. | ||
===[[Ruby/ENV/keep if|<code>keep_if</code>]]=== | |||
===[[Ruby/ENV/ | يُبقِي كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا ويحذف البقية. | ||
===[[Ruby/ENV/key|<code>key</code>]]=== | |||
يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة. | |||
===[[Ruby/ENV/ | ===[[Ruby/ENV/key-3F|<code>?key</code>]]=== | ||
يعيد | يتحقَّق إن كان هنالك متغير بيئة باسم محدَّد. | ||
===[[Ruby/ENV/keys|<code>keys</code>]]=== | |||
===[[Ruby/ENV/ | يعيد جميع متغيرات البيئة في مصفوفة. | ||
===[[Ruby/ENV/length|<code>length</code>]]=== | |||
يعيد عدد متغيرات البيئة الموجودة. | |||
===[[Ruby/ENV/member|<code>?member</code>]]=== | |||
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد. | |||
===[[Ruby/ENV/rassoc|<code>rassoc</code>]]=== | |||
يعيد مصفوفة تضم اسم وقيمة متغير بيئة ذي قيمة محدَّدة، أو يعيد القيمة <code>nil</code> في حال لم تكن تلك القيمة موجودة. | |||
===[[Ruby/ENV/rehash|<code>rehash</code>]]=== | |||
لا يفعل هذا التابع أي شيء، فهو موجود لأغراض التوافقية مع الصنف <code>[[Ruby/Hash|Hash]]</code>. | |||
===[[Ruby/ENV/reject|<code>reject</code>]]=== | |||
مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code> لكنه يعمل على نسخة من البيئة وليس البيئة نفسها. | |||
===[[Ruby/ENV/reject-21|<code>reject!</code>]]=== | |||
مشابه للتابع <code>[[Ruby/ENV/delete if|delete_if]]</code> لكنه يعيد القيمة <code>nil</code> إن لم يحدث أي تغيير في البيئة. | |||
===[[Ruby/ENV/replace|<code>replace</code>]]=== | |||
يُبدِّل محتويات الجدول <code>[[Ruby/Hash|hash]]</code> المعطى مكان محتويات متغيرات البيئة الحالية. | |||
===[[Ruby/ENV/select|<code>select</code>]]=== | |||
يعيد نسخة من البيئة (environment) تضم المدخلات التي حقَّقت شرطًا معيَّنًا. | |||
===[[Ruby/ENV/select-21|<code>select!</code>]]=== | |||
مكافئ للتابع <code>[[Ruby/ENV/keep if|keep_if]]</code> لكنه يعيد القيمة <code>nil</code> إن لم يُحدِث أي تغيير في البيئة. | |||
===[[Ruby/ENV/shift|<code>shift</code>]]=== | |||
يحذف متغير بيئة (اسم المتغير وقيمته) من البيئة <code>ENV</code> ثمَّ يعيده في مصفوفة. | |||
===[[Ruby/ENV/size|<code>size</code>]]=== | |||
يعيد عدد متغيرات البيئة. | |||
===[[Ruby/ENV/store|<code>store</code>]]=== | |||
يضبط قيمة متغير بيئة ذي اسمٍ محدَّدٍ إلى قيمة معيَّنة. | |||
===[[Ruby/ENV/to a|<code>to_a</code>]]=== | |||
يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. | |||
===[[Ruby/ENV/to h|<code>to_h</code>]]=== | |||
ينشئ جدولًا من النوع <code>[[Ruby/Hash|Hash]]</code> يحوي نسخةً من متغيرات البيئة. | |||
===[[Ruby/ENV/to hash|<code>to_hash</code>]]=== | |||
ينشئ جدولًا من النوع <code>[[Ruby/Hash|Hash]]</code> يحوي نسخةً من متغيرات البيئة. | |||
===[[Ruby/ENV/to s|<code>to_s</code>]]=== | |||
يعيد السلسلة النصية “<code>ENV</code>”. | |||
===[[Ruby/ENV/update|<code>update</code>]]=== | |||
يضيف محتويات الجدول <nowiki/>[[Ruby/Hash|<code>Hash</code>]] المعطى إلى متغيرات البيئة الحالية. | |||
===[[Ruby/ENV/value-3F|<code>?value</code>]]=== | |||
يتحقَّق إن كان هناك متغير له قيمة محدَّدة. | |||
===[[Ruby/ENV/values|<code>values</code>]]=== | |||
يعيد مصفوفة تضم جميع قيم متغيرات البيئة. | |||
===[[Ruby/ENV/values at|<code>values_at</code>]]=== | |||
يعيد مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة. | |||
==مصادر<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 في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 14:34، 12 نوفمبر 2018
يشبه الصنف ENV
الجداول Hash
كثيرًا ويُستعمل للوصول إلى متغيرات البيئة.
توابع الصنف العامة (Public Class Methods)
[]
يعيد هذا المعامل قيمة متغير بيئة محدَّد في سلسلة نصية، أو يعيد القيمة nil
في حال لم يكن ذلك المتغير موجودًا.
[]
يضبط هذا المعامل عندما يُستعمَل بالشكل ENV[name] = value
قيمة متغير البيئة ذي الاسمname
إلى القيمة value
. إذا كانت القيمة value
المعطاة تساوي nil
، فسيُحذَف متغير البيئة ذاك.
assoc
يعيد مصفوفةً تحوي اسم وقيمة متغير بيئة ذي اسم محدَّد، أو يعيد القيمة nil
في حال لم يكن ذلك المتغير موجودًا.
clear
يحذف جميع متغيرات البيئة.
delete
يحذف متغير بيئةٍ محدَّدٍ ثمَّ يعيد قيمة هذا المتغير. في حال تمرير كتلة إلى التابع، ستُستدعَى إن لم يكن ذلك المتغير موجودًا.
delete_if
يحذف كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا.
each
يجلب أسماء وقيم متغيرات البيئة بالتتابع، ويرسلها فُرادى إلى الكتلة البرمجية المعطاة.
each_key
يجلب أسماء متغيرات البيئة بالتتابع، ويرسلها فُرادَى إلى الكتلة البرمجية المعطاة.
each_pair
يجلب الزوج اسم/قيمة لكل متغير من متغيرات البيئة بالتتابع، ويرسله إلى الكتلة البرمجية المعطاة.
each_value
يجلب قيمة كل متغير من متغيرات البيئة بالتتابع، ويرسلها إلى الكتلة البرمجية المعطاة.
empty?
يتحقَّق من عدم وجود أي متغيرات بيئة.
fetch
يجلب قيمة متغير بيئة ذي اسمٍ محدَّدٍ.
?has_key
يتحقَّق إن كان هناك متغير بيئة باسم محدَّد.
?has_value
يتحقَّق إن كان هناك متغير بيئة يملك قيمة محدَّدة.
?include
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد.
index
أصبح مهملًا (Deprecated). استخدم بدلًا منه التابع key
.
inspect
يعيد محتوى البيئة (environment) في سلسلة نصية.
invert
يعكس بين أسماء وقيم متغيرات البيئة ثمَّ يعيدها في كائنٍ جديدٍ من النوع Hash
.
keep_if
يُبقِي كل متغيرات البيئة التي تحقِّق شرطًا معيَّنًا ويحذف البقية.
key
يعيد اسم متغير البيئة الذي يملك قيمة محدَّدة.
?key
يتحقَّق إن كان هنالك متغير بيئة باسم محدَّد.
keys
يعيد جميع متغيرات البيئة في مصفوفة.
length
يعيد عدد متغيرات البيئة الموجودة.
?member
يتحقَّق إن كان هناك متغير بيئة ذي اسم محدَّد.
rassoc
يعيد مصفوفة تضم اسم وقيمة متغير بيئة ذي قيمة محدَّدة، أو يعيد القيمة nil
في حال لم تكن تلك القيمة موجودة.
rehash
لا يفعل هذا التابع أي شيء، فهو موجود لأغراض التوافقية مع الصنف Hash
.
reject
مشابه للتابع delete_if
لكنه يعمل على نسخة من البيئة وليس البيئة نفسها.
reject!
مشابه للتابع delete_if
لكنه يعيد القيمة nil
إن لم يحدث أي تغيير في البيئة.
replace
يُبدِّل محتويات الجدول hash
المعطى مكان محتويات متغيرات البيئة الحالية.
select
يعيد نسخة من البيئة (environment) تضم المدخلات التي حقَّقت شرطًا معيَّنًا.
select!
مكافئ للتابع keep_if
لكنه يعيد القيمة nil
إن لم يُحدِث أي تغيير في البيئة.
shift
يحذف متغير بيئة (اسم المتغير وقيمته) من البيئة ENV
ثمَّ يعيده في مصفوفة.
size
يعيد عدد متغيرات البيئة.
store
يضبط قيمة متغير بيئة ذي اسمٍ محدَّدٍ إلى قيمة معيَّنة.
to_a
يحول متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات.
to_h
ينشئ جدولًا من النوع Hash
يحوي نسخةً من متغيرات البيئة.
to_hash
ينشئ جدولًا من النوع Hash
يحوي نسخةً من متغيرات البيئة.
to_s
يعيد السلسلة النصية “ENV
”.
update
يضيف محتويات الجدول Hash
المعطى إلى متغيرات البيئة الحالية.
?value
يتحقَّق إن كان هناك متغير له قيمة محدَّدة.
values
يعيد مصفوفة تضم جميع قيم متغيرات البيئة.
values_at
يعيد مصفوفة تضم جميع قيم متغيرات البيئة المرتبطة بالأسماء المٌعطاة.