مصفوفات Arduino: قائمة من القيم تحت اسم واحد
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
المصفوفة قائمة من القيم من النوع نفسه تحت اسم واحد. int pins[] = {13, 12, 11}; تنشئ قائمة من ثلاثة أعداد، وpins[0] هو أولها، وحلقة for تستطيع المرور على القائمة كلها. المصفوفات هي طريقة الكود في الاحتفاظ بصف أطراف LED، أو لحن موسيقي، أو مجموعة أنماط إضاءة، أو آخر عشر قراءات من حساس.
الدائرة أعلاه تحفظ ثمانية أنماط إضاءة في مصفوفة وتعرضها على ثمانية مصابيح عبر مسجل إزاحة. اضغط «تشغيل». ستطبع الشاشة التسلسلية "patterns in the list: 8"، ثم "step 0 = 1" و "step 1 = 11" وصولًا إلى "step 7 = 11111111" بينما يمتلئ الشريط مصباحًا بعد مصباح. كل خطوة هي عنصر واحد من القائمة.
فيما يلي كيفية إنشاء مصفوفة وعدّ عناصرها، ولماذا يكون العنصر الأول رقمه 0، والخطآن الأكثر كلفة في الوقت: القراءة أو الكتابة بعد نهاية المصفوفة، وسؤال دالة عن حجم مصفوفة.
تريد النسخة خطوة بخطوة؟ الدرس "حلقة فوق قائمة" يشرح ذلك مع نقاط تحقق.
افتح الدرسأنشئ واحدة، وابدأ العد من الصفر
اكتب النوع والاسم والأقواس المربعة والقيم داخل الأقواس المعقوفة. اترك الأقواس المربعة فارغة ويعدّ المترجم القيم لك. تُرقَّم العناصر من 0، فمصفوفة من ثمانية عناصر فيها من PATTERNS[0] إلى PATTERNS[7]، ولا وجود لـ PATTERNS[8].
You can also give the size and fill it in later: int readings[10]; makes ten ints. A global array like that starts as all zeros. One made inside a function starts with whatever was in memory, so fill it before you read it.
const byte PATTERNS[] = {
0b00000001,
0b00000011,
0b00000111,
0b00001111,
0b00011111,
0b00111111,
0b01111111,
0b11111111,
};
const int COUNT = (int)(sizeof(PATTERNS) / sizeof(PATTERNS[0]));كم العدد: sizeof
تعطي sizeof حجم الشيء بالبايتات لا عدد العناصر. فالعدد هو حجم المصفوفة كاملة مقسومًا على حجم عنصر واحد. لخمسة أعداد int على لوحة Uno، طبع sizeof(scores) القيمة 10، لأن int هناك يساوي 2 بايت. والكود نفسه على ESP32-C3 طبع 20، لأن int هناك يساوي 4. وبعد القسمة على حجم عنصر واحد، أعطى كلاهما 5.
احسب العدد بهذه الطريقة بدلًا من كتابة 8 يدويًا. أضف نمطًا تاسعًا إلى القائمة أعلاه واضغط «تشغيل»: يصبح السطر الأول "patterns in the list: 9"، وتعمل الحلقة تسع خطوات، ولم تلمس سوى القائمة.
int scores[5] = {10, 20, 30, 40, 50};
void setup() {
Serial.begin(9600);
Serial.println(sizeof(scores));
Serial.println(sizeof(scores) / sizeof(scores[0]));
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
مصفوفة من الأطراف
أكثر المصفوفات فائدة على Arduino هي قائمة الأطراف. ضع أرقام الأطراف في مصفوفة فتُعدّها حلقة واحدة كلها، وتضيئتها حلقة أخرى بالتتابع. الكود أدناه يعمل على المصابيح الثلاثة في منضدة الكود (الأطراف 13 و12 و11) وطبع "pin 13 on" ثم "pin 12 on" ثم "pin 11 on" بالترتيب. أضف طرفًا إلى القائمة، ووصّل LED أخرى، وستنضم إليها.
Arrays of text work the same way. const char *names[] = {"red", "yellow", "green"}; is a list of three words, and names[1] is "yellow". The random numbers page uses one to make a magic eight ball.
ويمكن للمصفوفة أن تحمل صفوفًا أيضًا. const byte GRID[2][3] = {{1, 2, 3}, {4, 5, 6}}; هي صفان من ثلاثة عناصر، وGRID[1][0] طبع 4، وsizeof(GRID) طبع 6، أي صفان من ثلاثة بايتات. وحلقتا for، واحدة داخل الأخرى، تمرّان على كل عنصر، وهكذا يحفظ الكود نقاط مصفوفة LED أو مفاتيح لوحة أرقام.
const int LAMPS[] = {13, 12, 11};
const int COUNT = sizeof(LAMPS) / sizeof(LAMPS[0]);
void setup() {
Serial.begin(9600);
for (int i = 0; i < COUNT; i++) {
pinMode(LAMPS[i], OUTPUT);
}
}
void loop() {
for (int i = 0; i < COUNT; i++) {
digitalWrite(LAMPS[i], HIGH);
Serial.print("pin ");
Serial.print(LAMPS[i]);
Serial.println(" on");
delay(300);
digitalWrite(LAMPS[i], LOW);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
بعد النهاية: لا خطأ، بل أجوبة خاطئة
Nothing checks an index while the sketch runs. Ask for entry 5 of a five-entry array and the board does not stop or complain; it reads whatever two bytes come next in memory. Our a[5] printed 280, a number that was never in the list. The build tab did warn about that one, because the 5 was written right there in the code: array index 5 is past the end of the array (that has type 'int[5]').
الكتابة بعد النهاية أسوأ، وعادة لا تحصل على أي تحذير على الإطلاق، لأن الفهرس هو عدّاد حلقة. ملأنا مصفوفة من خمسة عناصر بحلقة تقول i <= 5، فتغيّر متغيّر اسمه other، معرّف في السطر التالي، من 99 إلى 0. لم يُطبع شيء ولم يحدث أي انهيار. الكود الذي يفعل هذا يخطئ في مكان آخر تمامًا، ولهذا يصعب إيجاد الخطأ كثيرًا. استخدم < مع العدد، في كل مرة.
int a[5] = {10, 20, 30, 40, 50};
int other = 99;
void setup() {
Serial.begin(9600);
for (int i = 0; i <= 5; i++) a[i] = 0;
Serial.println(other);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
تمرير مصفوفة إلى دالة
المصفوفة التي تُسلَّم إلى دالة تصل على شكل عنوان أول عنصر فيها، لا كنسخة من القائمة. لهذا أثران. الدالة يمكنها تغيير مصفوفة المُستدعي، وهذا غالبًا ما تريده. وداخل الدالة، لم يعد sizeof يعرف طولها: نفس scores التي كان حجمها 10 بايتات في setup() صار حجمها 2 داخل الدالة، وهو حجم العنوان على لوحة Uno. حذّرت لوحة البناء: sizeof on array function parameter will return size of 'int *' instead of 'int[]'.
لذا مرِّر العدد مع المصفوفة، كما في average(scores, 5)، أو احسبه بـ sizeof في المكان الذي عُرِّفت فيه المصفوفة ثم مرِّره. كل مكتبة Arduino تستقبل مخزنًا مؤقتًا تفعل ذلك بهذه الطريقة.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno: ثمانية أنماط في مصفوفة، على ثمانية مصابيح، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم شغّلها مرة أخرى.
الأسئلة
هل تبدأ مصفوفات Arduino من 0 أم من 1؟
من 0. أول عنصر في المصفوفة هو name[0] وآخر عنصر في مصفوفة من ثمانية هو name[7]. الحلقة عليها تكون for (int i = 0; i < 8; i++).
كيف أجد طول مصفوفة في Arduino؟
اقسم حجمها بالبايتات على حجم عنصر واحد: sizeof(list) / sizeof(list[0]). هذا يعمل فقط في المكان الذي عُرِّفت فيه المصفوفة؛ أما داخل دالة أُسلِّمت لها المصفوفة، فيعطي sizeof حجم عنوان بدلًا من ذلك.
هل يمكنني تغيير حجم مصفوفة؟
لا. حجمها ثابت عند بناء الكود. اجعلها بالحجم الذي ستحتاجه واحتفظ بعدد منفصل يخبرك كم عنصرًا مستخدمًا.
ماذا يحدث إذا تجاوزت نهاية المصفوفة؟
لا شيء يوقفك. القراءة بعد النهاية تعطيك ما يليها في الذاكرة، والكتابة بعد النهاية تغيّر متغيّرًا آخر. في اختبارنا، كتابة عنصر واحد زيادة حوّلت متغيّرًا مجاورًا من 99 إلى 0 دون أي خطأ.
هل يمكن أن تحتفظ المصفوفة بنص؟
Yes. const char *names[] = {"red", "yellow", "green"}; is an array of three strings, and names[0] is "red". A single piece of text is itself an array of char, ending in a zero byte.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.