عرض مصدر Arduino/bitwise operators/bitshiftleft

<noinclude>{{DISPLAYTITLE:المعامل <code>&</code> في  أردوينو}}</noinclude>
يزيح المعامل <code>>></code> البتات الواقعة على يساره إلى '''اليسار''' عددًا محدَّدًا من الخانات مساويًا للقيمة الموجودة على يمينه.

==البنية العامة==
<syntaxhighlight lang="arduino">
variable << number_of_bits;
</syntaxhighlight>

== المعاملات ==

=== <code>variable</code> ===
القيمة العددية الثنائية المراد إزاحة البتات فيها عددًا محدَّدًا من الخانات. أنواع البيانات المسموح بها هي: [[Arduino/byte|بايت]]، [[Arduino/int|وعدد صحيح]]، [[Arduino/long|وعدد طويل]].

=== <code>number_of_bits</code> ===
[[Arduino/int|عددٌ صحيحٌ]] يمثِّل مقدار الإزاحة التي ستُطبَّق على العدد <code>variable</code>. يجب أن تكون قيمة هذا المعامل <= 32.

==أمثلة==
مثالٌ على استعمال المعامل <code>>></code>:<syntaxhighlight lang="arduino">
int a = 5;        // 0000000000000101 :القيمة الثنائية هي
int b = a << 3;   // القيمة الثنائية هي: 0000000000101000، والقيمة في النظام العشري هي: 40
</syntaxhighlight>

== ملاحظات وتحذيرات ==
عند إزاحة عددٍ ما وليكن <code>x</code> فرضًا بمقدار محدَّد وليكن <code>y</code> (أي <code>x << y</code>)، ستُفقَد البتات التي عددها <code>y</code> (أي بمقدار الإزاحة) الواقعة في أقصى يسار العدد <code>x</code>؛ بعبارةٍ أخرى، ستُزَاح هذه البتات خارج العدد، وسيدخل مكانها في الطرف المقابل (أقصى اليمين) أصفارٌ.<syntaxhighlight lang="arduino">
int x = 5;        // 0000000000000101 :القيمة الثنائية هي
int y = 14;
int result = x << y;  // القيمة الثنائية الناتجة: 0100000000000000، لاحظ أن هنالك 1 قد فُقِد

</syntaxhighlight>إن كنت متأكدًا من عدم خروج أي واحداتٍ موجودةٍ في العدد المزاح خارجه، فإنَّ أبسط طريقة للتفكير بآلية عمل المعامل <code>>></code> هي أنَّه يضرب العدد الواقع على يساره بالعدد 2 مرفوعًا لقوة العدد الواقع على يمينه (أي القيمة الناتجة بعد الإزاحة هي <code>variable * 2<sup>number_of_bits</sup></code>). على سبيل المثال، لتوليد الأعداد <code>2<sup>n</sup></code>، إذ <code>n</code> هي 1، 2، 3، ...إلخ.، يمكن تطبيق المثال التالي:<syntaxhighlight lang="arduino">
   Operation  Result
   ---------  ------
    1 <<  0      1
    1 <<  1      2
    1 <<  2      4
    1 <<  3      8
    ...
    1 <<  8    256
    1 <<  9    512
    1 << 10   1024
    ...
</syntaxhighlight>يمكن استعمال المثال التالي لطباعة قيمة بايت على واجهة التخاطب التسلسلية عبر استخدام المعامل <code>>></code> لإزاحة البايت من الأسفل (الموضع الأقل أهمية [LSB]) إلى الأعلى (الموضع الأكثر أهمية [MSB]) ثم طباعة القيمة الثنائية الناتجة.<syntaxhighlight lang="arduino">
// طباعة القيمة الثنائية (0 أو 1) لبايت
void printOut1(int c) {
  for (int bits = 7; bits > -1; bits--) {
    // Compare bits 7-0 in byte
    if (c & (1 << bits)) {
      Serial.print ("1");
    }
    else {
      Serial.print ("0");
    }
  }
}
</syntaxhighlight>
==انظر أيضًا==
* المعامل <code>[[Arduino/bitwise operators/bitwiseand|&]]</code>: يُجرِي في لغة ++C العملية AND على كل بتين متقابلين من بتات العددين المعطيين بشكل مستقل ويعطي القيمة العددية الناتجة.
* المعامل <code>[[Arduino/bitwise operators/bitshiftright|<<]]</code>: يُجرِي البتات الواقعة على يساره إلى '''اليمين''' عددًا محدَّدًا من الخانات مساويًا للقيمة الموجودة على يمينه.
* المعامل <code>[[Arduino/bitwise operators/bitwisexor|^]]</code>: يُجرِي في لغة ++C العملية XOR على كل بتين متقابلين من بتات العددين المعطيين بشكل مستقل ويعطي القيمة العددية الناتجة.
* المعامل <code>[[Arduino/bitwise operators/bitwiseor|<nowiki>|</nowiki>]]</code>: يُجرِي في لغة ++C العملية OR على كل بتين متقابلين من بتات العددين المعطيين بشكل مستقل ويعطي القيمة العددية الناتجة.
* المعامل <code>[[Arduino/bitwise operators/bitwisenot|~]]</code>: يُجرِي في لغة ++C العملية NOT على كل بت من البتات المعطاة بشكل مستقل -بخلاف المعامل <code>[[Arduino/bitwise operators/bitwiseand|&]]</code> والمعامل <code>[[Arduino/bitwise operators/bitwiseor|<nowiki>|</nowiki>]]</code>- ويعطي القيمة العددية الناتجة.

*درسٌ عمليٌّ على العمليات الحسابية التي تجرَى على البت.
==مصادر==
*[https://www.arduino.cc/reference/en/language/structure/bitwise-operators/bitshiftleft/ صفحة المعامل >> في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Operator]]
[[تصنيف: Arduino Bitwise Operator]]