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

المراجعة الحالية بتاريخ 05:31، 9 أكتوبر 2018

تقاطع الكلمة return المفتاحية تنفيذ أيَّ دالةٍ وتعيد قيمةً من الدالة إلى من استدعاها إن حدُّدت.

البنية العامة

return;

return value; // value في هذه الصياغة، ستعاد القيمة

يمكن أن تكون القيمة value المعادة أيُّ نوعٍ من أنواع المتغيرات أو الثوابت المراد إعادته إلى من استدعى الدالة.

أمثلة

يوضح المثال التالي كيفية إنشاء دالة توازن القيمة المقاسة من حساس مع عتبة معينة:

int checkSensor(){
    if (analogRead(0) > 400) {
        return 1;
    }
    else{
        return 0;
    }
}

يوضح المثال التالي كيفية استعمال الكلمة return المفتاحية في فحص جزءٍ من الشيفرة دون اللجوء إلى أسلوب التعليق:

void loop(){

// يسيُفحَص هذا الجزء من الشيفرة  

return;

// ولن يُنفَّذ الجزء الواقع هنا الذي 
// من المحتمل أن يكون الخطأ ضمنه
}

انظر أيضًا

الكلمة المفتاحية break: تُستعمَل للخروج من الحلقات التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها.
الكلمة المفتاحية continue: تتخطى الشيفرة التي تليها في حلقة التكرار إلى عملية التحقق من التعبير الشرطي لتلك الحلقة ثم يُستأنَف عمل حلقة التكرار بشكل طبيعي.
الحلقة do...while: تعمل بنفس الطريقة التي تعمل بها الحلقة while باستثناء أنه يُتحقق من الشرط في نهاية الحلقة وليس في بدايتها.
الكلمة المفتاحية else: يسمح بالتحكم بشكل أوسع بتسلسل عملية التحقق من عدة شروط معينة عند تنفيذ الشيفرة عوضًا عن التحقق من شرط وحيد عند استعمال التعبير if.
الحلقة for: تُستعمَل لتكرار كتلة برمجية معينة من الشيفرة عددًا محدَّدًا من المرات.
الكلمة المفتاحية goto: ينقل البرنامج إلى موضع معين ضمن الشيفرة.
التعبير الشرطي if: يتحقَّق من شرط معيَّن وينفِّذ الكتلة البرمجية المكتوبة ضمنه إن كان محقَّقًا (أي كانت قيمته true).
التعبير switch...case: يتحقَّق -كما في if- من قيمة محدَّدة بطريقة تسمح للمبرمج بتحديد عدة شيفرات تُنفَّذ إحداها بناءً على تلك القيمة المفحوصة.
الحلقة while: تكرِّر تنفيذ الكتلة البرمجية التي ضمنها بشكل مستمر ولا نهائي ما دامت قيمة الشرط المنطقي المعطى هي true ومتى ما أصبحت قيمة الشرط المنطقي false، تتوقف الحلقة وتخرج.

مصادر

صفحة الكلمة المفتاحية return في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
+<noinclude>{{DISPLAYTITLE:الكلمة <code>return</code> المفتاحية في  أردوينو}}</noinclude>
 تقاطع الكلمة <code>return</code> المفتاحية تنفيذ أيَّ دالةٍ وتعيد قيمةً من الدالة إلى من استدعاها إن حدُّدت.
@@ سطر 6: / سطر 7: @@
 return value; // value في هذه الصياغة، ستعاد القيمة
-</syntaxhighlight>
+</syntaxhighlight>يمكن أن تكون القيمة <code>value</code> المعادة أيُّ نوعٍ من أنواع المتغيرات أو الثوابت المراد إعادته إلى من استدعى الدالة.
-== المعاملات ==
-=== <code>value</code> ===
-أيُّ نوعٍ من أنواع المتغيرات أو الثوابت المراد إعادته إلى من استدعى الدالة.
 ==أمثلة==
@@ سطر 35: / سطر 31: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-*الكلمة المفتاحية <code>[[Arduino/break|break]]</code>: تُستعمَل للخروج من الحلقات التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها.
+*الكلمة المفتاحية <code>[[Arduino/break|break]]</code>: تُستعمَل للخروج من الحلقات التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها.
-*الحلقة <code>do...while</code>:
+*الكلمة المفتاحية <code>[[Arduino/continue|continue]]</code>: تتخطى الشيفرة التي تليها في حلقة التكرار إلى عملية التحقق من التعبير الشرطي لتلك الحلقة ثم يُستأنَف عمل حلقة التكرار بشكل طبيعي.
-*التعبير <code>[[Arduino/else|else]]</code>:
+*الحلقة <code>[[Arduino/dowhile|do...while]]</code>: تعمل بنفس الطريقة التي تعمل بها الحلقة <code>[[Arduino/while|while]]</code> باستثناء أنه يُتحقق من الشرط في نهاية الحلقة وليس في بدايتها.
-*الحلقة <code>[[Arduino/for|for]]</code>:
+*الكلمة المفتاحية <code>[[Arduino/else|else]]</code>: يسمح بالتحكم بشكل أوسع بتسلسل عملية التحقق من عدة شروط معينة عند تنفيذ الشيفرة عوضًا عن التحقق من شرط وحيد عند استعمال التعبير <code>[[Arduino/if|if]]</code>.
-*الكلمة المفتاحية <code>[[Arduino/goto|goto]]</code>:
+*الحلقة <code>[[Arduino/for|for]]</code>: تُستعمَل لتكرار كتلة برمجية معينة من الشيفرة عددًا محدَّدًا من المرات.
-*الحلقة <code>if...else</code>:
+*الكلمة المفتاحية <code>[[Arduino/goto|goto]]</code>: ينقل البرنامج إلى موضع معين ضمن الشيفرة.
-*الكلمة المفتاحية <code>[[Arduino/return|return]]</code>:
+*التعبير الشرطي <code>[[Arduino/if|if]]</code>: يتحقَّق من شرط معيَّن وينفِّذ الكتلة البرمجية المكتوبة ضمنه إن كان محقَّقًا (أي كانت قيمته <code>true</code>).
-*التعبير <code>[[Arduino/switch|switch...case]]</code>:
+*التعبير <code>[[Arduino/switchcase|switch...case]]</code>: يتحقَّق -كما في <code>[[Arduino/if|if]]</code>- من قيمة محدَّدة بطريقة تسمح للمبرمج بتحديد عدة شيفرات تُنفَّذ إحداها بناءً على تلك القيمة المفحوصة.
-*الحلقة <code>[[Arduino/while|while]]</code>:
+*الحلقة <code>[[Arduino/while|while]]</code>: تكرِّر تنفيذ الكتلة البرمجية التي ضمنها بشكل مستمر ولا نهائي ما دامت قيمة الشرط المنطقي المعطى هي <code>true</code> ومتى ما أصبحت قيمة الشرط المنطقي <code>false</code>، تتوقف الحلقة وتخرج.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/structure/control-structure/return/ صفحة الكلمة المفتاحية return في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Control Structure]]