الفرق بين المراجعتين ل"Arduino/include"

المراجعة الحالية بتاريخ 07:34، 7 نوفمبر 2018

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

المرجع الرئيسي لمكتبات C الخاصة بالمتحكم AVR (هو أحد متحكمات Atmel الذي بنيت عليه أردوينو) تجده هنا.

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

#include <library's name>

ملاحظة: لا تنسَ إضافة الرمز # لأنَّه ضروري.

أمثلة

يوضح المثال التالي كيفية تضمين مكتبة تُستعمَل لوضع البيانات في ذاكرة البرنامج (أي الذاكرة flash) بدلًا من الذاكرة العشوائية المتطايرة (أي الذاكرة RAM). هذا يساعد على توفير مساحة الذاكرة العشوائية لجعل عملية الحجز الديناميكي للذاكرة وإنشاء جداول البحث (lookup tables) أكثر فاعلية.

#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};

ملاحظات وتحذيرات

انتبه إلى أنَّ التعبير ‎#include يشبه التعبير ‎#define في أنَّه لا يحتاج إلى إضافة فاصلة منقوطة في نهايته. إن أضيفت واحدة، سيرمي المفسِّر أخطاء مبهمة أثناء تفسير الشيفرة وإرسالها إلى اللوحة.

انظر أيضًا

التعبير ‎#define: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج.
الرمز ;: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C.
الأقواس {}: هي جزء لا يتجزأ من لغة C وتستعمل في بُنى عديدة مثل بنى التحكم وغيرها.
استعمال التعليقات الكتلية في أردوينو.
استعمال التعليقات السطرية في أردوينو.

مصادر

صفحة التعبير ‎#include في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
-يُستعمَل التعبير ‎<code>#include</code> لتضمين مكتبات خارجية في شيفرتك. يساعد هذا المبرمج على الوصول إلى مجموعة أكبر من مكتبات C القياسية (التي هي مجموعة من الدوال المُنشَأ مسبقًا) والمكتبات التي كُتبَت خصِّيصًا لأردوينو.
+<noinclude>{{DISPLAYTITLE:التعبير <code>‎#include</code> في  أردوينو}}</noinclude>
+يُستعمَل التعبير ‎<code>#include</code> لتضمين مكتبات خارجية في شيفرتك. هذا يساعد المبرمج على الوصول إلى مجموعة أكبر من مكتبات C القياسية (التي هي مجموعة من الدوال المُنشَأ مسبقًا) والمكتبات التي كُتبَت خصِّيصًا لأردوينو.
 المرجع الرئيسي لمكتبات C الخاصة بالمتحكم AVR (هو أحد متحكمات Atmel الذي بنيت عليه أردوينو) تجده [http://www.nongnu.org/avr-libc/user-manual/modules.html هنا].
@@ سطر 6: / سطر 7: @@
 <syntaxhighlight lang="arduino">
 #include <library's name>
-</syntaxhighlight>لا تنسَ إضافة الرمز <code>#</code> لأنه ضروري.
+</syntaxhighlight>'''ملاحظة''': لا تنسَ إضافة الرمز <code>#</code> لأنَّه ضروري.
 == أمثلة ==
@@ سطر 17: / سطر 18: @@
 == ملاحظات وتحذيرات ==
-انتبه إلى أنَّ التعبير ‎<code>#include</code> يشبه التعبير [[Arduino/define|‎<code>#define</code>]] في أنه لا يحتاج إلى إضافة فاصلة منقوطة في نهايته. إن أضيفت واحدة، سيرمي المفسِّر أخطاء مبهمة أثناء تفسير الشيفرة وإرسالها إلى اللوحة.
+انتبه إلى أنَّ التعبير ‎<code>#include</code> يشبه التعبير [[Arduino/define|‎<code>#define</code>]] في أنَّه لا يحتاج إلى إضافة [[Arduino/semicolon|فاصلة منقوطة]] في نهايته. إن أضيفت واحدة، سيرمي المفسِّر أخطاء مبهمة أثناء تفسير الشيفرة وإرسالها إلى اللوحة.
 == انظر أيضًا ==
-* التعبير  <code>‎#define</code>:
+* التعبير <code>[[Arduino/define|‎#define]]</code>: هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج.
-* الرمز <code>;</code>:
+* الرمز <code>[[Arduino/semicolon|;]]</code>: يُستعمَل لإنهاء كل تعبير برمجي في لغة أردوينو C.
-* الأقواس <code>{}</code>:
+* الأقواس <code>[[Arduino/curlybraces|{}]]</code>: هي جزء لا يتجزأ من لغة C وتستعمل في بُنى عديدة مثل بنى التحكم وغيرها.
-* استعمال التعليقات الكتلية في أردوينو.
+* [[Arduino/blockcomment|استعمال التعليقات الكتلية في أردوينو.]]
-* استعمال التعليقات السطرية في أردوينو.
+* [[Arduino/singlelinecomment|استعمال التعليقات السطرية في أردوينو.]]
 == مصادر ==
 * [https://www.arduino.cc/reference/en/language/structure/further-syntax/include/ صفحة التعبير ‎#include في توثيق أردوينو الرسمي.]
+[[تصنيف: Arduino]]
+[[تصنيف: Arduino Syntax]]