المتغيرات الساكنة في Arduino، المتغيرات العامة والنطاق
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
المتغير المُنشأ داخل دالة يبدأ من جديد في كل مرة تعمل فيها الدالة، ويختفي عند انتهائها. ضع static قبله فيُنشأ مرة واحدة، ويحتفظ بقيمته بين الاستدعاءات، ويبقى مرئيًا داخل تلك الدالة فقط. أما المتغير العام، المُنشأ خارج كل الدوال، فيحتفظ بقيمته أيضًا، لكن كل دالة في الكود تستطيع رؤيته وتغييره.
الدائرة أعلاه هي منضدة الكود، التي يطبع كودها المتغيرات العامة بأسمائها، مثل "lampCount = 3"، ثم يعرض رقمًا لا يتسع له نوعه: "32000 + 1000 in an int = -32536". المتغيرات العامة كهذه هي الطريقة المعتادة للاحتفاظ بقيمة بين مرات تشغيل loop()؛ وغالبًا ما يكون الساكن طريقة أرتب.
فيما يلي static داخل دالة وداخل loop()، والعام الذي لا يتغير أبدًا، وخطأ النطاق، وكيفية مشاركة متغير عام واحد بين التبويبات باستخدام extern.
هل تريد النسخة التفصيلية خطوة بخطوة؟ الدرس "للمتغيرات حجم" يشرح هذا كله مع نقاط تحقق.
افتح الدرسstatic يحتفظ بقيمته بين الاستدعاءات
الدالتان أدناه متطابقتان إلا عن كلمة واحدة. عند استدعاء كل منهما ثلاث مرات، طبعت countLocal() العبارة "local 1" في كل مرة، لأن n فيها تُنشأ من جديد وتُضبط على 0 عند كل استدعاء. أما countStatic() فطبعت "static 1" و"static 2" و"static 3": فقد ضُبطت n فيها على 0 مرة واحدة، في المرة الأولى، وواصلت العد.
السطر = 0 على متغير ساكن يعمل مرة واحدة. هذا هو الجزء الذي يفاجئ الناس: يبدو السطر وكأنه يعيد العداد إلى الصفر، وهو لا يفعل.
void countLocal() {
int n = 0;
n++;
Serial.print("local ");
Serial.println(n);
}
void countStatic() {
static int n = 0;
n++;
Serial.print("static ");
Serial.println(n);
}
void setup() {
Serial.begin(9600);
for (int i = 0; i < 3; i++) {
countLocal();
countStatic();
}
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
static داخل loop()
loop() دالة مثل غيرها، فالمتغير العادي فيها يضيع في نهاية كل دورة. مؤقّت millis() يحتاج إلى حفظ آخر وقت له، ولهذا تضعه الدروس التعليمية في أعلى الكود. متغير static في loop() يبقى أيضًا، ويجعل الاسم بجوار الكود الوحيد الذي يستخدمه.
الكود أدناه طبع "tick 1 at 1000" و"tick 2 at 2000" و"tick 3 at 3000". عند حذف static من السطرين، طبع "tick 1 at 1000" ثم "tick 1" مرة أخرى في كل دورة: فقيمة last تصبح 0 في كل مرة، فبعد الثانية الأولى يصبح الشرط صحيحًا دائمًا، وتبدأ ticks من 0 من جديد أيضًا.
void setup() {
Serial.begin(9600);
}
void loop() {
static unsigned long last = 0;
static int ticks = 0;
if (millis() - last >= 1000) {
last = millis();
ticks++;
Serial.print("tick ");
Serial.print(ticks);
Serial.print(" at ");
Serial.println(last);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
المتغير العام الذي لا يتغير
عندما لا يتغير متغير عام، ابحث عن متغير ثانٍ بالاسم نفسه. في الكود أدناه، السطر int total = 0; داخل addReading() ينشئ متغيرًا محليًا جديدًا باسم total يحجب العام. الدالة تضيف إلى النسخة المحلية، التي تُرمى عند انتهائها، فبعد ثلاثة استدعاءات طبع الكود "total is 0". احذف int total = 0; من داخل الدالة فطبع "total is 15".
لا clang ولا GCC يحذّران من هذا افتراضيًا. العلامة المميزة هي وجود اسم نوع قبل متغير أردت استخدامه لا إنشاءه.
int total = 0;
void addReading(int value) {
int total = 0;
total = total + value;
}
void setup() {
Serial.begin(9600);
addReading(5);
addReading(5);
addReading(5);
Serial.print("total is ");
Serial.println(total);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
النطاق: أين يمكن رؤية الاسم
المتغير المُنشأ بين قوسين معقوصين يوجد بينهما فقط. السطر int ledPin = 13; داخل setup() لا يمكن استخدامه في loop()، وتوقّف البناء مع use of undeclared identifier 'ledPin'. ويقول GCC في Arduino IDE إن 'ledPin' لم يُعرَّف في هذا النطاق (not declared in this scope). انقل السطر فوق setup()، خارج الدالتين، فيصبح مرئيًا لهما معًا.
الأمر نفسه ينطبق على متغير أُنشأ داخل if أو for: يختفي بعد القوس المعقوص المغلق. وهذا مفيد، لأن اسمًا يُستخدم في موضع واحد فقط لا يمكن تغييره بالخطأ في مكان آخر، وهو سبب تفضيل static أو متغير محلي على العام عندما تحتاج دالة واحدة فقط إلى القيمة.
متغير عام واحد عبر التبويبات: extern
الكود الذي فيه تبويب ثانٍ، counter.cpp، يحتاج إلى أن يتشارك ذلك التبويب والكود متغيرًا واحدًا. أنشئه في ملف .cpp واحد بالضبط، وصرّح عنه بـ extern في ملف رأس يتضمنه كلاهما. المشروع أدناه طبع "presses = 3".
هناك خطأان شائعان. إنشاء المتغير في ملف الرأس، `int presses = 0;`، ينشئه مرة في كل ملف يتضمنه، ويتوقف البناء عند الربط مع duplicate symbol: presses (ويقول رابط GCC: multiple definition of `presses'). أما جعله `static int presses = 0;` في ملف الرأس فيبني بنجاح، وهو أسوأ: يحصل كل ملف على نسخته الخاصة، فالعداد عدّ في أحدهما وطبع الكود الآخر "presses = 0". static على متغير عام تعني "هذا الملف فقط".
// counter.h
#pragma once
extern int presses;
void countPress();
// counter.cpp
#include "counter.h"
int presses = 0;
void countPress() {
presses++;
}
// sketch.ino
#include "counter.h"
void setup() {
Serial.begin(9600);
countPress();
countPress();
countPress();
Serial.print("presses = ");
Serial.println(presses);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
static والعام وvolatile وRAM
المتغير الذي تغيّره مقاطعة يحتاج إلى volatile أيضًا، سواء كان عامًا أو ساكنًا، ليقرأه loop() قراءة جديدة في كل مرة بدلًا من الاحتفاظ بنسخة قديمة. الساكن والعام كلاهما يعيشان طوال التشغيل في 2048 بايت من RAM على Uno، ويحتسبان ضمن رقم "Global variables use" الذي يطبع Arduino IDE بعد البناء؛ أما المحلي فلا يستخدم المكدس إلا أثناء عمل دالته. المصفوفة الكبيرة التي تحتاجها دالة واحدة فقط، وأثناء عملها فقط، أفضل أن تكون محلية.
افتح هذه الدائرة في المحرر. Arduino Uno: منضدة الكود، تطبع متغيراتها، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
الأسئلة
ماذا يعني static على متغير في Arduino؟
داخل دالة، ينشئ static المتغير مرة واحدة، ويحتفظ بقيمته بين الاستدعاءات، ويبقيه خاصًا بتلك الدالة. وخارج كل الدوال، يجعل static المتغير العام خاصًا بملفه فقط.
هل أستخدم متغيرًا ساكنًا أم متغيرًا عامًا؟
استخدم static داخل الدالة عندما تحتاج تلك الدالة وحدها إلى القيمة، مثل آخر وقت لمؤقّت في loop(). واستخدم متغيرًا عامًا عندما تحتاج عدة دوال، أو مقاطعة، إلى مشاركته.
لماذا لا يتغير متغيري العام في Arduino؟
غالبًا يحجبه متغير محلي بالاسم نفسه: اسم نوع قبله، مثل int total = 0; داخل دالة، ينشئ متغيرًا جديدًا. احذف اسم النوع لتستخدم العام. وإذا كانت مقاطعة تغيّره، فاجعله volatile أيضًا.
Does static int n = 0; reset n to zero each time?
لا. القيمة بعد = تُضبط مرة واحدة، في المرة الأولى التي تعمل فيها الدالة. وكل استدعاء لاحق يكمل من آخر قيمة.
كيف أستخدم متغيرًا عامًّا في تبويب آخر؟
أنشئه في ملف .cpp واحد، int presses = 0;، وضع extern int presses; في ملف رأس يتضمنه كل تبويب يستخدمه.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.