Belajar

Arduino static variable, global variable dan scope

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: meja kerja kode, mencetak variabelnyalive0.000 s 0.00x
Klik untuk membukanya di editor
Setiap variabel yang dicetak sketch ini adalah global. Pindahkan salah satunya ke loop() dan lihat apa kata compiler.

Variabel yang dibuat di dalam sebuah fungsi dibuat ulang setiap kali fungsi itu berjalan, dan hilang saat fungsi itu berakhir. Tambahkan static di depannya dan ia dibuat sekali, menyimpan nilainya antar pemanggilan, dan tetap hanya bisa dilihat di dalam fungsi itu. Variabel global, yang dibuat di luar semua fungsi, juga menyimpan nilainya, tapi semua fungsi di sketch bisa melihat dan mengubahnya.

Rangkaian di atas adalah meja kerja kode, yang sketch-nya mencetak variabel globalnya berdasarkan nama, seperti "lampCount = 3", lalu menunjukkan angka yang tidak muat di tipenya: "32000 + 1000 in an int = -32536". Global seperti ini adalah cara biasa menyimpan nilai antar putaran loop(); static sering kali lebih rapi.

Di bawah ini ada static di dalam sebuah fungsi dan di dalam loop(), global yang tidak pernah berubah, error scope, dan bagaimana satu global dibagi antar tab dengan extern.

Mau versi langkah demi langkah? Pelajaran "Variabel punya ukuran" membahas ini dengan checkpoint.

Buka pelajaran

static menyimpan nilainya antar pemanggilan

Dua fungsi di bawah sama kecuali satu kata. Dipanggil tiga kali masing-masing, countLocal() mencetak "local 1" setiap kali, karena n-nya dibuat baru dan diset ke 0 pada setiap pemanggilan. countStatic() mencetak "static 1", "static 2" dan "static 3": n-nya diset ke 0 sekali saja, pada pemanggilan pertama, lalu terus menghitung.

= 0 pada static hanya berjalan sekali. Ini bagian yang mengejutkan orang: barisnya tampak seperti me-reset hitungan, padahal tidak.

Penghitung local dan static
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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

static di dalam loop()

loop() adalah fungsi seperti fungsi lain, jadi variabel biasa di dalamnya hilang di akhir setiap putaran. Timer millis() butuh waktu terakhirnya untuk bertahan, itu sebabnya tutorial menaruhnya di bagian atas sketch. Static di dalam loop() juga bertahan, dan menjaga nama variabelnya dekat dengan satu-satunya kode yang memakainya.

Sketch di bawah mencetak "tick 1 at 1000", "tick 2 at 2000" dan "tick 3 at 3000". Dengan static dihapus dari kedua baris, ia mencetak "tick 1 at 1000" lalu "tick 1" lagi di setiap putaran: last kembali 0 setiap kali, jadi setelah detik pertama tesnya selalu benar, dan ticks mulai dari 0 lagi juga.

Timer yang menyimpan sendiri waktu terakhirnya
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);
  }
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Variabel global yang tidak pernah berubah

Saat sebuah global tidak berubah, cari variabel kedua dengan nama yang sama. Pada sketch di bawah, int total = 0; di dalam addReading() membuat total lokal baru yang menutupi globalnya. Fungsi itu menambah ke salinan lokal, yang dibuang saat ia berakhir, jadi setelah tiga pemanggilan sketch mencetak "total is 0". Hapus int total = 0; di dalam fungsi itu dan ia mencetak "total is 15".

Baik clang maupun GCC tidak memperingatkan ini secara bawaan. Cirinya adalah ada nama tipe di depan variabel yang sebenarnya ingin kamu pakai, bukan buat.

Lokal yang menutupi global
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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Scope: di mana sebuah nama bisa dilihat

Variabel yang dibuat di antara dua kurung kurawal hanya ada di antara keduanya. int ledPin = 13; di dalam setup() tidak bisa dipakai di loop(), dan build berhenti dengan use of undeclared identifier 'ledPin'. GCC Arduino IDE bilang 'ledPin' was not declared in this scope. Pindahkan barisnya ke atas setup(), di luar kedua fungsi, dan keduanya bisa melihatnya.

Hal yang sama berlaku untuk variabel yang dibuat di dalam if atau for: ia hilang setelah kurung kurawal penutup. Itu berguna, karena nama yang dipakai di satu tempat saja tidak bisa berubah tak sengaja di tempat lain, dan itulah alasan memilih static atau lokal daripada global saat hanya satu fungsi yang butuh nilainya.

Satu global lintas tab: extern

Sketch dengan tab kedua, counter.cpp, butuh tab itu dan sketch berbagi satu variabel. Buatlah di tepat satu file .cpp, dan deklarasikan dengan extern di header yang keduanya sertakan. Proyek di bawah mencetak "presses = 3".

Dua kesalahan umum. Membuat variabel di header, `int presses = 0;`, membuatnya sekali di setiap file yang menyertainya, dan build berhenti saat link dengan duplicate symbol: presses (linker GCC bilang multiple definition of `presses'). Membuatnya `static int presses = 0;` di header berhasil dibuild, dan lebih buruk: setiap file punya salinan privatnya sendiri, jadi penghitung menghitung di satu file dan sketch mencetak yang lain, "presses = 0". static pada global berarti "hanya file ini".

counter.h, counter.cpp dan sketch-nya
// 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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

static, global, volatile dan RAM

Variabel yang diubah interrupt butuh volatile juga, global maupun static, agar loop() membacanya segar setiap kali alih-alih menyimpan salinan lama. Static dan global sama-sama tinggal di 2048 byte RAM Uno selama program berjalan, dan dihitung dalam angka "Global variables use" yang dicetak Arduino IDE setelah build; lokal hanya memakai stack selama fungsinya berjalan. Array besar yang hanya dibutuhkan satu fungsi, hanya saat fungsi itu berjalan, lebih baik lokal.

Buka rangkaian ini di editor. Arduino Uno: meja kerja kode, mencetak variabelnya, dirangkai seperti saat berjalan di bagian atas halaman ini. Ubah sebuah komponen atau nilai dan jalankan lagi.

Pertanyaan

Apa arti static pada variabel Arduino?

Di dalam fungsi, static membuat variabel sekali, menyimpan nilainya antar pemanggilan, dan menjadikannya privat untuk fungsi itu. Di luar semua fungsi, static membuat global privat untuk file-nya sendiri.

Harus pakai variabel static atau global?

Pakai static di dalam fungsi saat hanya fungsi itu yang butuh nilainya, misalnya waktu terakhir timer di loop(). Pakai global saat beberapa fungsi, atau sebuah interrupt, perlu berbagi nilainya.

Kenapa variabel global Arduino saya tidak berubah?

Biasanya variabel lokal dengan nama yang sama menutupinya: nama tipe di depan, seperti int total = 0; di dalam fungsi, membuat variabel baru. Hapus tipenya untuk memakai global. Jika sebuah interrupt mengubahnya, buat volatile juga.

Does static int n = 0; reset n to zero each time?

Tidak. Nilai setelah = diset sekali, saat fungsi pertama kali berjalan. Setiap pemanggilan berikutnya melanjutkan dari nilai terakhir.

Bagaimana cara memakai variabel global di tab lain?

Buatlah di satu file .cpp, int presses = 0;, dan taruh extern int presses; di header yang disertakan oleh setiap tab yang memakainya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.