تعلّم

Arduino 2D arrays, on a die drawn on an 8x8 matrix

متوسط

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: ستة أوجه للنرد في مصفوفة واحدة ثنائية الأبعادمباشر0.000 s 0.00x
اضغط «تشغيل»، ثم انقر مفتاح الإمالة عدة مرات
انقر مفتاح الإمالة لهزّه. كل وجه هو صف واحد من FACES، ثمانية بايتات لثمانية صفوف من LED.

المصفوفة ثنائية الأبعاد عبارة عن جدول. int grid[3][4]; تعني 3 صفوف من 4 أرقام في كل صف، وgrid[1][2] هو الصف 1 والعمود 2، والعدّ يبدأ من 0 في الحالتين. ولمرور على الجدول كله، ضع حلقة for داخل أخرى: الخارجية للصفوف والداخلية للأعمدة.

الدائرة أعلاه هي نرد على شاشة LED بمقاس 8x8 على لوحة Uno. يحفظ الكود الأوجه الستة كلها في const byte FACES[6][8]: ستة صفوف، واحد لكل وجه، من ثمانية بايتات، واحد لكل سطر من وحدات LED. اضغط «تشغيل» وانقر مفتاح الإمالة بضع مرات لتهزّه. يتدحرج الوجه، ويتباطأ، ثم يتوقف، ويصبح لون LED أخضر، وتطبع الشاشة التسلسلية "rolled a" مع الرقم.

أدناه جدول النرد، وإنشاء شبكة وتعبئتها، وعدّ الصفوف والأعمدة، وتمرير جدول إلى دالة، وجدول من الكلمات، وكم يكلّف جدول كبير على Uno، كل ذلك مع نتيجة تشغيل كل مثال.

ستة أوجه، ثمانية صفوف لكل منها

Here is the table from the sketch running above and the function that draws a face. FACES[n - 1] is the whole face for the number n, and FACES[n - 1][row] is one line of it, a byte whose bits are the eight LEDs across. The face for 1 is all zeros but rows 3 and 4, where 0x18 lights the two middle LEDs: the single pip.

firmware/uno/examples/kcdice (الأوجه التي تعمل أعلاه)
const byte FACES[6][8] = {
    {0x00, 0x00, 0x00, 0x18, 0x18, 0x00, 0x00, 0x00},
    {0x00, 0x06, 0x06, 0x00, 0x00, 0x60, 0x60, 0x00},
    {0xC0, 0xC0, 0x00, 0x18, 0x18, 0x00, 0x03, 0x03},
    {0x00, 0x66, 0x66, 0x00, 0x00, 0x66, 0x66, 0x00},
    {0xC3, 0xC3, 0x00, 0x18, 0x18, 0x00, 0xC3, 0xC3},
    {0x66, 0x66, 0x00, 0x66, 0x66, 0x00, 0x66, 0x66},
};

أنشئ جدولًا، عبّئه، اطبعه

كل زوج من الأقواس الداخلية يمثّل صفًا واحدًا. يطبع الكود أدناه الشبكة كجدول، صف واحد في كل سطر مع فاصل جدولة بين الأرقام، ثم grid[1][2] الذي طبع 7: الصف 1 هو الصف الثاني، والعمود 2 هو رقمه الثالث.

الكتابة تعمل مثل القراءة تمامًا: grid[row][col] = value; داخل الحلقتين نفسيهما تملأ الجدول كله، صفًا بعد صف. أبقِ الصفوف في الحلقة الخارجية والأعمدة في الداخلية، لأن هذا هو الترتيب الذي تحتله الأرقام في الذاكرة، واستخدم أسماء مثل row وcol بدلًا من i وj، حتى يبرز زوج الفهارس المتبادل عند قراءته لاحقًا.

شبكة 3 في 4
int grid[3][4] = {
  {1, 2, 3, 4},
  {5, 6, 7, 8},
  {9, 10, 11, 12},
};

void setup() {
  Serial.begin(9600);
  for (int row = 0; row < 3; row++) {
    for (int col = 0; col < 4; col++) {
      Serial.print(grid[row][col]);
      Serial.print('\t');
    }
    Serial.println();
  }
  Serial.println(grid[1][2]);
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

كم عدد الصفوف والأعمدة

sizeof(grid) هو حجم الجدول كله بالبايتات: 24 لـ 12 عددًا صحيحًا من 2 بايت. اقسمه على حجم صف واحد، sizeof(grid[0])، لتحصل على عدد الصفوف، وقد طبع 3، واقسم صفًا واحدًا على عنصر واحد، sizeof(grid[0]) / sizeof(grid[0][0])، لتحصل على الأعمدة، وقد طبع 4. الحلقات المكتوبة بهذه الطريقة تستمر في العمل عندما يكبر الجدول.

تتوضّع الأرقام في الذاكرة صفًا بعد صف. إذا قرأت بعد نهاية صف فستصل إلى بداية الصف التالي: grid[1][4] طبع 9، وهو أول رقم في الصف 2، مع تحذير فقط، array index 4 is past the end of the array (that has type 'int[4]'). أما بعد نهاية الصف الأخير فلا يوجد صف تالٍ، بل أي شيء آخر موجود في الذاكرة.

تمرير جدول إلى دالة

A function that takes a 2D array has to be told how long a row is, so it can find row 2. Only the number of rows may be left out. The sketch below adds up the grid and printed 78. Write int g[][] with both sizes left out and the build stops with array has incomplete element type 'int[]'; GCC says declaration of 'g' as multidimensional array must have bounds for all dimensions except the first.

عدد الأعمدة يوضع في المُعامِل
const int COLS = 4;

int total(int g[][COLS], int rows) {
  int sum = 0;
  for (int r = 0; r < rows; r++) {
    for (int c = 0; c < COLS; c++) {
      sum += g[r][c];
    }
  }
  return sum;
}

int grid[3][COLS] = {{1, 2, 3, 4}, {5, 6, 7, 8}, {9, 10, 11, 12}};

void setup() {
  Serial.begin(9600);
  Serial.println(total(grid, 3));
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

جدول من الكلمات

Text can be stored two ways. char words[3][6] is a real 2D array: three rows of six characters, each word padded out, 18 bytes in all, and words[1][0] is the letter g. const char *names[] is an array of pointers, each to a word of its own length. Both printed "green" and "blue" the same way.

A row must have room for the longest word and its zero byte. With rows of 5, "green" did not fit: initializer-string for char array is too long, array size is 5 but initializer has size 6 (including the null terminating character). GCC says initializer-string for 'char [5]' is too long.

طريقتان لحفظ ثلاث كلمات
const char *names[] = {"red", "green", "blue"};
char words[3][6] = {"red", "green", "blue"};

void setup() {
  Serial.begin(9600);
  Serial.println(names[1]);
  Serial.println(words[2]);
  Serial.println(words[1][0]);
  Serial.println(sizeof(words));
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

الجداول الكبيرة و2 KB من RAM

تحتوي Uno على 2048 بايت من RAM لكل المتغيّرات في الكود. int big[30][40] يريد 2400 منها، وقد توقف البناء: global variables do not fit in the 2 KB SRAM, overflowed by 538 bytes، مع احتساب المتغيّرات الأخرى التي لا يخلو منها أي كود. الجدول الذي لا يتغيّر أبدًا، مثل أوجه النرد أو أحد الخطوط، يمكن أن يعيش في الفلاش بدلًا من ذلك: أضف PROGMEM واقرأه بـ pgm_read_byte(&FACES[1][2])، وقد طبع 6 من جدول صغير. سعة الفلاش 32 KB.

افتح هذه الدائرة في المحرر. Arduino Uno: ستة أوجه نرد في مصفوفة ثنائية الأبعاد واحدة، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها من جديد.

افتح الدائرة

الأسئلة

How do I declare a 2D array in Arduino?

اكتب عدد الصفوف ثم الأعمدة: int grid[3][4]; أو عبّئها أثناء التعريف، بزوج أقواس لكل صف. يمكن ترك عدد الصفوف فارغًا إذا كُتبت كل الصفوف صراحةً.

How do I loop through a 2D array?

ضع حلقة for للأعمدة داخل حلقة for للصفوف واقرأ grid[row][col]. احسب الأعداد بـ sizeof حتى تتبع الحلقات الجدول إذا تغيّر.

How do I pass a 2D array to a function?

اكتب عدد الأعمدة في المُعامِل، int g[][4]، ومرّر عدد الصفوف كمُعامِل ثانٍ. يجوز ترك الحجم الأول فارغًا فقط.

كيف أنشئ مصفوفة من النصوص على Arduino؟

Use const char *names[] = {"red", "green"}; for fixed words, or a char array with one row per word, char words[3][6], when the words have to change. Each row needs one extra byte for the zero at the end.

ما أقصى حجم لمصفوفة على Arduino Uno؟

كل ما في RAM يجب أن يتّسع في 2048 بايت، مع ترك مساحة للمكدّس. الجدول الثابت يمكن وضعه في فلاش بسعة 32 KB باستخدام PROGMEM.

المصادر

من أين جاءت الحقائق في هذه الصفحة

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.