عرض مصدر Ruby/control expressions

<noinclude>{{DISPLAYTITLE:تعابير التحكم في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Syntax]]
لدى لغة روبي العديد من الطرق للتحكم في مسار تنفيذ البرنامج، وكل البنى المذكورة هنا تعيد قيمةً.

في الاختبارات الشرطيّة في بنى التحكّم، تعدّ القيمة <code>nil</code> و <code>false</code> على أنّها قيم خطأ، بينما تُعدُّ القيمة <code>true</code> وأيّ كائن آخر على أنه قيم صحيحة. وفي هذا التوثيق، سنستخدم <code>true</code> للتعبير عن القيم الصحيحة و <code>false</code> للتعبير عن القيم الخطأ.
==بنية <code>If</code> الشرطية==
أبسط أشكال بنية <code>if</code> الشرطيّة يحتوي على جزأين، الاختبار الشّرطي، والجزء التّنفيذي <code>then</code>. هذه بنية <code>if</code> بسيطة:<syntaxhighlight lang="ruby">
if true then
 puts "the test resulted in a true-value"
end
</syntaxhighlight>وتكون النتيجة طباعة الناتج التالي: <syntaxhighlight lang="text">
“the test resulted in a true-value”
</syntaxhighlight>كلمة <code>then</code> اختياريّة:<syntaxhighlight lang="ruby">
if true
 puts "the test resulted in a true-value"
end
</syntaxhighlight>في هذا التّوثيق، سنحذف <code>then</code> الاختياريّة في كلّ البنى، وهذا هو الاستخدام الأكثر شيوعًا للبنية <code>if</code>.

بإمكانك ايضًا إضافة بنية <code>else</code> والتي ستنفّذ عندما لا يساوي الشرط الاختباريّ قيمة <code>true</code>:<syntaxhighlight lang="ruby">
if false
 puts "the test resulted in a true-value"
else
 puts "the test resulted in a false-value"
end
</syntaxhighlight>وستكون النتيجة طباعة: <syntaxhighlight lang="text">
“the test resulted in a false-value”
</syntaxhighlight>كما يمكنك أن تضيف أيّ عدد من الاختبارات الإضافيّة لبنية <code>if</code> باستخدام <code>elsif</code>. وكلّ شرط في <code>elsif</code> ينفّذ طالما كانت جميع الاختبارات السابقة له مساويةً إلى <code>false</code>:<syntaxhighlight lang="ruby">
a = 1
if a == 0
 puts "a is zero"
elsif a == 1
 puts "a is one"
else
 puts "a is some other value"
end
</syntaxhighlight>وتكون النتيجة “a is one” وذلك لأنّ 1 لا يساوي 0، و <code>else</code> تنفّذ فقط عندما لا يوجد ايّ اختبار محقّق فوقها.

بمجرّد أن يتحقّق أيّ اختبار سواء في <code>if</code> أو في <code>elsif</code>، تعدّ بنية <code>if</code> قد اكتملت ولن تُجرَى أيّة اختبارات أخرى. وكما هو الحال بالنّسبة للبنية <code>if</code>، يمكن للبنية <code>elsif</code> أن تتبعها <code>then</code>. 

في المثال التالي ستكون النتيجة طباعة "a is one" فقط:<syntaxhighlight lang="ruby">
a = 1
if a == 0
 puts "a is zero"
elsif a == 1
 puts "a is one"
elsif a >= 1
 puts "a is greater than or equal to one"
else
 puts "a is some other value"
end
</syntaxhighlight>الاختبارات الشرطيّة الخاصّة بالبنية <code>if</code> و <code>elsif</code> قد يكون لها تأثيرات جانبيّة، والحالة الأكثر شيوعًا هي الاحتفاظ بقيمة لمتغيّر محليّ:<syntaxhighlight lang="ruby">
if a = object.some_value
 # do something to a
end
</syntaxhighlight>القيمة النّاتجة لبنية <code>if</code> هي آخر قيمة تنفّذ في هذه البنية.
==تعبير <code>if</code> الثلاثي==
يمكنك أيضًا كتابة بنية <code>if-then-else</code> باستخدام <code>?</code> و <code>:</code> وهي ما تسمى بتعبير <code>if</code> الثلاثي:<syntaxhighlight lang="ruby">
input_type = gets =~ /hello/i ? "greeting" : "other"
</syntaxhighlight>وهي تكافئ البنية التالية:<syntaxhighlight lang="ruby">
input_type =
 if gets =~ /hello/i
   "greeting"
 else
   "other"
 end 
</syntaxhighlight>رغم أنّ تعبير <code>if</code> الثلاثيّ مختصر أكثر من الشكل الاعتيادي للبنية إلا أنّه من المفضّل لسهولة القراءة فلا يستخدم إلا للاختبارات البسيطة. تجنب أيضًا أن تُدخل أكثر من ثلاثيّ شرطي في نفس البنية كي لا يصبح الأمر مربكًا.
==بنية <code>unless</code>==
بنية <code>unless</code> هي النقيض لبنية <code>if</code> إذ أنّ الكتلة البرمجيّة فيها تنفّذ عندما يحقّق الاختبار الشرطيّ قيمة <code>false</code>:<syntaxhighlight lang="ruby">
unless true
 puts "the value is a false-value"
end
</syntaxhighlight>ولا شيء يطبع هنا إذ أنّ <code>true</code> لا تساوي القيمة <code>false</code> (أو أي قيمة خطأ). يمكنك أيضًا الاستغناء عن <code>then</code> أو كتابتها كما هو الحال في <code>if</code>.

لاحظ أنّ بنية <code>unless</code> الأخيرة تكافئ تمامًا:<syntaxhighlight lang="ruby">
if not true
 puts "the value is a false-value"
end
</syntaxhighlight>كما بإمكانك استخدام <code>else</code> أيضًا مع <code>unless</code>:<syntaxhighlight lang="ruby">
unless true
 puts "the value is false"
else
 puts "the value is true"
end
</syntaxhighlight>وتكون النتيجة طباعة “the value is true” من <code>else</code>.

ليس بإمكانك استخدام <code>elsif</code> مع بنية <code>unless</code>.

القيمة الناتجة عن بنية <code>unless</code> هي آخر قيمة تم تنفيذها في هذه البنية.

== البنيتان <code>If</code> و <code>unless</code> المعدِّلتان ==
يمكن استخدام <code>if</code> و <code>unless</code> أيضًا لتعديل تعبير برمجيّ، وحينها يصبح الجزء الأيسر هو الجزء التنفيذي <code>then</code> والجزء الأيمن هو الاختبار الشرطيّ:<syntaxhighlight lang="ruby">
a = 0
a += 1 if a.zero?
p a
</syntaxhighlight>هذا يطبع 1.<syntaxhighlight lang="ruby">
a = 0
a += 1 unless a.zero?
p a 
</syntaxhighlight>هذا يطبع 0.

صحيح أنّ <code>if</code> المعدِّلة والعاديّة لهما شرط اختباريّ وجزء تنفيذيّ، إلا أنّهما ليسا متطابقين على وجه الدّقة وذلك بسبب اختلاف ترتيب كلّ منهما في مفسّر اللغة. هذا المثال يوضّح الفرق:<syntaxhighlight lang="ruby">
p a if a = 0.zero?
</syntaxhighlight>هذا سيسبّب ظهور الخطأ: <code>[[Ruby/NameError|NameError]]</code> مع الرسالة “undefined local variable or method `a'” 

عندما يحلّل مفسّر اللغة هذا التعبير فإنّه يصادف بداية <code>a</code> ويعدّه استدعاء لتابع ضمن كتلة <code>then</code>، ولاحقًا يرى الإسناد إلى <code>a</code> في الشرط الاختباريّ ويعدّه متغيّرًا محليًّا.

يبدأ تنفيذ هذا السّطر بتنفيذ الشّرط الاختباريّ <code>?a=0.zero</code>، وبما أنّ الشّرط محقّق سينتقل التنفيذ إلى الكتلة <code>then</code> وفيها <code>p a</code>. ولمَّا كان a مسجلًا على أنَّه تابعٌ وهذا التابع غير موجود، فسيُطلق الخطأ <code>[[Ruby/NameError|NameError]]</code>.

ذات الحالة تنطبق على <code>unless</code>.
==بنية <code>case</code> ==
يمكن استخدام بنية <code>case</code> بطريقتين؛ الاستخدام الشائع لها أن توازن كائنًا ما مقابل أنماط مختلفة، وتتمّ المطابقة مع هذه الأنماط باستخدام تابع <code>+===+</code> والذي يقابله تابع <code>+==+</code> من الصنف <code>[[Ruby/Object|Object]]</code>. أما الأصناف الأخرى فعليها أن تعيد تعريف التابع ليأخذ سلوكًا ذا معنى. انظر [[Ruby/Module/3D-3D-3D|<code>Module.===‎</code>]] و <code>[[Ruby/Regexp/case equality|Regexp.===]]</code>‎ للحصول على أمثلة عملية.

هذا مثال عن استخدام <code>case</code> لموازنة [[Ruby/String|سلسلة نصية]] (string) مع [[Ruby/Regexp|نمط]]:<syntaxhighlight lang="ruby">
case "12345"
when /^1/
 puts "the string starts with one"
else
 puts "I don't know what the string starts with"
end
</syntaxhighlight>هنا توازن [[Ruby/String|السلسلة النصية]] "12345" مع [[Ruby/Regexp|النمط]] /1^/ وذلك باستدعاء ‎/^1/ === "12345"‎ والذي يعيد القيمة <code>true</code>. وكما هو الحال في بنية <code>if</code>، تنفّذ الكتلة البرمجيّة التابعة لأوّل اختبار شرطيّ يتحقّق، وكل الحالات الأخرى تُتجاهل. وفي حال عدم وجود أي نمط مطابق، تُنفّذ الكتلة <code>else</code>.

كلّ من <code>else</code> و <code>then</code> اختياريّين، بنية <code>case</code> التالية تعطي نفس النتيجة للبنية السابقة:<syntaxhighlight lang="ruby">
case "12345"
when /^1/
 puts "the string starts with one"
end
</syntaxhighlight>كما بإمكانك إدراج أكثر من شرط اختباريّ معًا ضمن <code>when</code>:<syntaxhighlight lang="ruby">
case "2"
when /^1/, "2"
 puts "the string starts with one or is '2'"
end
</syntaxhighlight>سيجرّب مفسّر روبي كل شرط على حدة وفق الترتيب، إذ بدايةً يختبر ‎<code>/^1/ === "2"</code>‎ والذي يُرجع <code>false</code>، ثمّ يختبر <code>"2" === "2"</code> والذي يعيد <code>true</code>، فيطبع  الناتج التالي في النّهاية:<syntaxhighlight lang="text">
“the string starts with one or is '2'” 
</syntaxhighlight>بإمكانك كتابة <code>then</code> على نفس السطر بعد شرط <code>when</code> مباشرة، عادة ما يُستخدم هذا الأسلوب لكتابة كتلة <code>then</code> على نفس السّطر مع الشرط الخاصّ بها:<syntaxhighlight lang="ruby">
case a
when 1, 2 then puts "a is one or two
when 3    then puts "a is three"
else           puts "I don't know what a is"
end
</syntaxhighlight>الطريقة الثانية لكتابة بنية <code>case</code> تشابه بنية <code>if-elsif</code>:<syntaxhighlight lang="ruby">
a = 2
case
when a == 1, a == 2
 puts "a is one or two"
when a == 3
 puts "a is three"
else
 puts "I don't know what a is"
end
</syntaxhighlight>وبالمثل، كل من <code>then</code> و <code>else</code> اختياريّتين.

القيمة الناتجة عن بنية <code>case</code> هي آخر قيمة تُنفّذ في البنية.
==حلقة <code>while</code> التكرارية==
تُنفّذ حلقة <code>while</code> التكراريّة طالما أنّ شرطها محقّق:<syntaxhighlight lang="ruby">
a = 0
while a < 10 do
 p a
 a += 1
end
p a
</syntaxhighlight>هذا يطبع الأرقام من 0 إلى 10، فالشرط <code>a<10</code> يُختبَر قبل دخول كل حلقة ومن ثمّ ينفّذ ما بداخلها، ومن ثمّ يختبر الشرط مجدّدًا. وعندما تكون نتيجة الاختبار <code>false</code>، يتوقف تنفيذ الحلقة التّكرارية.

الكلمة المحجوزة <code>do</code> اختياريّة، فالحلقة التالية مكافئة للحلقة السابقة:<syntaxhighlight lang="ruby">
while a < 10
 p a
 a += 1
end
</syntaxhighlight>نتيجة حلقة <code>while</code> التكرارية تساوي <code>nil</code> إلا إذا استٌخدمت الكلمة المحجوزة <code>break</code> لتزوّدها بقيمة عند الخروج منها.
==حلقة <code>until</code> التكرارية==
تنفّذ هذه الحلقة طالما أنّ شرطها غير محقّق:<syntaxhighlight lang="ruby">
a = 0
until a > 10 do
 p a
 a += 1
end
p a
</syntaxhighlight>هذا يطبع الأرقام من 0 إلى 11. وكما هو الحال في <code>while</code> فالشرط <code>a>10</code> يُختبر في كلّ مرة قبل دخول الحلقة، ومن ثمّ يٌنفّذ محتواها. إذا كان الشّرط غير محقق، فستستمرّ الحلقة بالتكرار.

وكما هو الحال في <code>while</code>، فإنّ كلمة <code>do</code> اختياريّة. وكذلك القيمة الناتجة من الحلقة تبقى <code>nil</code> إلا إذا استخدمت الكلمة <code>break</code>.
==حلقة <code>for</code> التكرارية==
حلقة <code>for</code> التكرارية تتكون من <code>for</code> متبوعةً بمتغيّر سيحتوي معامل التّكرار (iteration argument) ومن ثمّ كلمة <code>in</code> ثم القيم التي ستكرّر الحلقة وفقها. أمّا <code>do</code> فهي اختياريّة:<syntaxhighlight lang="ruby">
for value in [1, 2, 3] do
 puts value
end
</syntaxhighlight>يطبع 1 ثمّ 2 ثمّ 3 إن استخدام <code>for</code> مشابه لاستخدام <code>each</code> إلّا أنّ الأولى لا تٌنشئ نطاقًا جديدًا للمتغيّرات.

نتيجة حلقة <code>for</code> التكراريّة هي آخر قيمة تصل إليها في التّكرار، إلا إذا استُخدمت الكلمة <code>break</code> لمقاطعة الحلقة والخروج منها.

نادرًا ما تُستخدم حلقة <code>for</code> في البرامج الحديثة المكتوبة بلغة روبي.
==البنيتان <code>while</code> و <code>until</code> المعدِّلتان==
كما هو الحال في البنيتان <code>if</code> و <code>unless</code> المعدلتان، يمكن لحلقة <code>while</code> و <code>until</code> أن تكونا معدِّلتين:<syntaxhighlight lang="ruby">
a = 0
a += 1 while a < 10
p a # تطبع 10

# كمعدّلة until استخدام
a = 0
a += 1 until a > 10
p a # تطبع 11 
</syntaxhighlight>يمكنك استخدام <code>begin</code> و <code>end</code> مع حلقة <code>while</code> لتنفّذ محتوى الحلقة مرة واحدة قبل اختبار الشرط.<syntaxhighlight lang="ruby">
a = 0
begin
 a += 1
end while a < 10
p a # تطبع 10
</syntaxhighlight>إذا لم تستخدم أيًا من <code>rescue</code> أو <code>ensure</code>، فستعمل لغة روبي على تحسين أيّة شيفرة تعامل مع الاستثناءات تمرّ عليها.
==الكلمة <code>break</code> المحجوزة==
استخدم الكلمة <code>break</code> لمغادرة كتلة برمجيّة في وقت مبكر. في هذا المثال يتوقّف التكّرار على بقيّة العناصر في <code>values</code> إذا كان أحدها زوجيًّا:<syntaxhighlight lang="ruby">
values.each do |value|
 break if value.even?
 # ...
end
</syntaxhighlight>يمكنك أيضًا أن توقف تنفيذ حلقة <code>while</code> باستخدام <code>break</code>:<syntaxhighlight lang="ruby">
a = 0
while true do
 p a
 a += 1
 break if a < 10
end
p a
</syntaxhighlight>هذا يطبع العددين 0 و 1 فقط.

تقبل <code>break</code> أن تمرّر لها قيمة تعيدها كنتيجة للبنية التي تقوم بإيقافها:<syntaxhighlight lang="ruby">
result = [1, 2, 3].each do |value|
 break value * 2 if value.even?
end
p result # تطبع 4
</syntaxhighlight>
==الكلمة <code>next</code> المحجوزة==
استخدم الكلمة <code>next</code> لتتخطى ما تبقّى من الجولة الحاليّة في التكرار:<syntaxhighlight lang="ruby">
result = [1, 2, 3].map do |value|
 next if value.even?
 value * 2
end
p result # تطبع [2, nil, 6]
</syntaxhighlight>تقبل <code>next</code> أن تمرّر لها معاملًا تُرجعه كنتيجة للجولة الحاليّة من الحلقة التّكرارية:<syntaxhighlight lang="ruby">
result = [1, 2, 3].map do |value|
 next value if value.even?
 value * 2
end
p result # نطبع [2, 2, 6]
</syntaxhighlight>
==الكلمة <code>redo</code> المحجوزة==
استخدم الكلمة <code>redo</code> لإعادة تنفيذ الجولة الحاليّة:<syntaxhighlight lang="ruby">
result = []
while result.length < 10 do
 result << result.length
 redo if result.last.even?
 result << result.length + 1
end
p result
</syntaxhighlight>هذا المثال يطبع:  [0, 1, 3, 3, 5, 5, 7, 7, 9, 9, 11] 

في الإصدار 1.8 من لغة روبي، كان بإمكانك أن تستخدم <code>retry</code> في نفس الأماكن التي تستخدم فيها <code>redo</code>. لم يعد هذا متاحًا الآن، فاستخدام <code>retry</code> خارج كتلة <code>rescue</code> سيطلق الخطأ <code>[[Ruby/SyntaxError|SyntaxError]]</code>. انظر الصفحة الخاصة [[Ruby/exceptions|بالاستثناءات]] لتعرف أكثر عن الاستخدام الصحيح للكلمة <code>retry</code>.
==القلاب==
القلّاب (Flip-Flop) هو بنية تحكّم نادر الوجود والاستعمال؛ يكمن استخدامه الأساسي في معالجة النّصوص في برامج روبي ذات السّطر الواحد والمستخدمة بواسطة <code>ruby -n</code> أو <code>ruby -p</code>. 

صيغة القلّاب هي كالتالي، بداية الشّرط الذي يعبّر عن دخول القلاب حالة التفعيل (on) ومن ثمّ نقطتين متتاليتين (..) أو ثلاثة نقاط (...)، ومن ثمّ الشرط الذي يعبّر عن انتقال القلّاب إلى حالة عدم التفعيل (off). وطالما أنّ القلّاب في حالة تفعيل فسيستمرّ بإعطاء القيمة <code>true</code>، وإذا كان غير مفعلّ يعطي <code>false</code>. 

إليك مثالًا عن بنية القلاب:<syntaxhighlight lang="ruby">
selected = []
0.upto 10 do |value|
 selected << value if value==2..value==8
end
p selected # يطبع [2, 3, 4, 5, 6, 7, 8]
</syntaxhighlight>في المثال السابق نجد أنّ شرط التفعيل هو <code>value==2</code>. فالقلاب يكون ابتداءً في حالة عدم تفعيل لكل من القيمتين 0 و 1، لكنه يصبح مفعلًا عند 2 ويبقى كذلك حتى نصل إلى 8 وعندها "يقلب" حالته إلى off ويستمر كذلك لكل من 9 و 10.

يجب أن يُستخدم القلاب في بنية شرطيّة مثل <code>if</code> أو <code>while</code> أو <code>unless</code> أو <code>until</code> أو غيرها، بما في ذلك أنواعها المعدِّلة.

عندما تستخدم مجالًا متضمّنًا (..)، فإنّ شرط إلغاء التفعيل يقيّم عندما يتغيّر شرط التفعيل:<syntaxhighlight lang="ruby">
selected = []
0.upto 5 do |value|
 selected << value if value==2..value==2
end
p selected # يطبع [2]
</syntaxhighlight>هنا كلا جانبي القلاب يقيّمان بحيث يقلب إلى on و off فقط عندما تكون القيمة مساوية للقيمة 2. وطالما أنّ القلاب أصبح مفعلًا في هذه الجولة فسيرجع القيمة <code>true</code>.

أمّا عندما تستخدم مجالًا مستبعِدًا (...) فإن شرط إلغاء التفعيل يقيّم في الجولة التالية: <syntaxhighlight lang="ruby">
selected = []
0.upto 5 do |value|
 selected << value if value==2...value==2
end
p selected # يطبع [2, 3, 4, 5]
</syntaxhighlight>هنا يقلب القلاب إلى وضع التفعيل عندما تكون القيمة 2، لكنّه لا يقلب إلى وضع عدم التفعيل في ذات الجولة، فالشرط الثاني سيقيّم في الجولة التالية وستكون القيمة قد تخطت 2 بالفعل، ولن تعود إليها مرّة أخرى.
==المصادر==
*[https://ruby-doc.org/core-2.5.1/doc/syntax/control_expressions_rdoc.html صفحة Control Expressions في توثيق روبي الرسمي]