عرض مصدر Arduino/arithmetic operators/remainder

<noinclude>{{DISPLAYTITLE:المعامل <code>%</code> في  أردوينو}}</noinclude>
يحسب المعامل <code>%</code> باقي قسمة عددين أحدهما على الآخر. إحدى فوائد استعمال هذا المعامل هي إبقاء قيمة متغير ضمن مجال محدد (مثل حجم مصفوفة).
==البنية العامة==
<syntaxhighlight lang="arduino">
remainder = dividend % divisor;
</syntaxhighlight>
==المعاملات==
===<code>remainder</code>===
متغير. الأنواع المسموح بها هي: [[Arduino/int|عدد صحيح]]، أو [[Arduino/float|عدد عشري]]، أو [[Arduino/double|عدد عشري مضاعف]].
===<code>dividend</code>===
متغير أو ثابت يمثل المقسوم. الأنواع المسموح بها هي: [[Arduino/int|عدد صحيح]].
===<code>divisor</code>===
متغير أو ثابت يمثل المقسوم عليه. الأنواع المسموح بها هي: [[Arduino/int|عدد صحيح]].
==أمثلة==
مثالٌ على استعمال المعامل <code>%</code>:<syntaxhighlight lang="arduino">
int x = 0;
x = 7 % 5;    // 2
x = 9 % 5;    // 4
x = 5 % 5;    // 0
x = 4 % 5;    // 4
x = -4 % 5;   // -4
x = 4 % -5;   // 4
</syntaxhighlight>مثالٌ آخر يوضِّح كيفية تحديث قيم عناصر مصفوفة لتُخزَّن فيها القيم المقروءة من حساس عبر حلقة تكرار:<syntaxhighlight lang="arduino">
int values[10];
int i = 0;

void setup() {}

void loop()
{
  values[i] = analogRead(0);
  i = (i + 1) % 10;   // يبقي معامل القسمة المتغير ضمن مجال المصفوفة 

</syntaxhighlight>
==ملاحظات وتحذيرات==
*لا يعمل المعامل <code>%</code> مع [[Arduino/float|الأعداد العشرية]].
*إن كانت قيمة المقسوم سالبةً، فستكون القيمة الناتجة عن عملية باقي القسمة سالبة (أو صفرية). بناءً على ذلك، لن تكون قيمة <code>x % 10</code> ضمن المجال 0 و 9 دومًا إن كانت قيمة <code>x</code> سالبةً.
==انظر أيضًا==
* المعامل <code>[[Arduino/multiplication|*]]</code>: يحسب ناتج ضرب عددين ببعضهما بعضًا.
* المعامل <code>[[Arduino/addition|+]]</code>: يحسب ناتج جمع عددين مع بعضهما بعضًا.
* المعامل <code>[[Arduino/subtraction|-]]</code>: يحسب ناتج طرح عددين من أحدهما من الآخر.
* المعامل <code>[[Arduino/division|/]]</code>: يحسب ناتج قسمة عددين أحدهما على الآخر.
* المعامل <code>[[Arduino/assignment|=]]</code>: يسند قيمة أو تعبير معين في متغير.

==مصادر==
*[https://www.arduino.cc/reference/en/language/structure/arithmetic-operators/remainder/ صفحة المعامل % في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Operator]]
[[تصنيف: Arduino Arithmetic Operator]]