عرض مصدر Arduino/include

<noinclude>{{DISPLAYTITLE:التعبير <code>‎#include</code> في  أردوينو}}</noinclude>
يُستعمَل التعبير ‎<code>#include</code> لتضمين مكتبات خارجية في شيفرتك. هذا يساعد المبرمج على الوصول إلى مجموعة أكبر من مكتبات C القياسية (التي هي مجموعة من الدوال المُنشَأ مسبقًا) والمكتبات التي كُتبَت خصِّيصًا لأردوينو.

المرجع الرئيسي لمكتبات C الخاصة بالمتحكم AVR (هو أحد متحكمات Atmel الذي بنيت عليه أردوينو) تجده [http://www.nongnu.org/avr-libc/user-manual/modules.html هنا].

== البنية العامة ==
<syntaxhighlight lang="arduino">
#include <library's name>
</syntaxhighlight>'''ملاحظة''': لا تنسَ إضافة الرمز <code>#</code> لأنَّه ضروري.

== أمثلة ==
يوضح المثال التالي كيفية تضمين مكتبة تُستعمَل لوضع البيانات في ذاكرة البرنامج (أي الذاكرة flash) بدلًا من الذاكرة العشوائية المتطايرة (أي الذاكرة RAM). هذا يساعد على توفير مساحة الذاكرة العشوائية لجعل عملية الحجز الديناميكي للذاكرة وإنشاء جداول البحث (lookup tables) أكثر فاعلية.<syntaxhighlight lang="arduino">
#include <avr/pgmspace.h>

prog_uint16_t myConstants[] PROGMEM = {0, 21140, 702  , 9128,  0, 25764, 8456,
0,0,0,0,0,0,0,0,29810,8968,29762,29762,4500};
</syntaxhighlight>

== ملاحظات وتحذيرات ==
انتبه إلى أنَّ التعبير ‎<code>#include</code> يشبه التعبير [[Arduino/define|‎<code>#define</code>]] في أنَّه لا يحتاج إلى إضافة [[Arduino/semicolon|فاصلة منقوطة]] في نهايته. إن أضيفت واحدة، سيرمي المفسِّر أخطاء مبهمة أثناء تفسير الشيفرة وإرسالها إلى اللوحة.

== انظر أيضًا ==
* التعبير <code>[[Arduino/define|‎#define]]</code>: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج.
* الرمز <code>[[Arduino/semicolon|;]]</code>: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C.
* الأقواس <code>[[Arduino/curlybraces|{}]]</code>: هي جزء لا يتجزأ من لغة C وتستعمل في بُنى عديدة مثل بنى التحكم وغيرها.
* [[Arduino/blockcomment|استعمال التعليقات الكتلية في أردوينو.]]
* [[Arduino/singlelinecomment|استعمال التعليقات السطرية في أردوينو.]]

== مصادر ==
* [https://www.arduino.cc/reference/en/language/structure/further-syntax/include/ صفحة التعبير ‎#include في توثيق أردوينو الرسمي.]
[[تصنيف: Arduino]]
[[تصنيف: Arduino Syntax]]