C-keele eeltöötleja ja makrod (Preprocessor and Macros)

#include – teekide ja päisefailide lisamine

Käsku #include kasutatakse selleks, et lisada programmi teeke (ingliskeeles library) või enda loodud päisefaile.

Teegid sisaldavad valmis kirjutatud koodi, mida saame oma programmis kasutada. Nii ei pea me kõiki funktsioone ise nullist kirjutama.

Näide:

#include 
#include "VL53L1X.h"

Esimene rida lisab standardse I2C rääkimiskanali ja teine rida lisab VL53L1X kaugusanduri teegi (koodi). Nende dokumentasioon on leitav:

Wire.h - https://docs.arduino.cc/language-reference/en/functions/communication/wire/

VL53L1.h - https://docs.arduino.cc/libraries/vl53l1x/

#define – makro defineerimine

Makro on nimi, mis tähistab mingit väärtust või koodiosa. Makro loomiseks kasutatakse käsku #define.

Näiteks:

#define VASAK_MOOTOR 23

See tähendab, et iga kord, kui programmis esineb VASAK_MOOTOR, asendatakse see enne programmi kompileerimist arvuga 23.

Näide:

#define VASAK_MOOTOR 23

void setup() {
  pinMode(VASAK_MOOTOR, OUTPUT); 
}

Ehk siis pinMode(23, OUTPUT);

Antud näites kasutame numbri 23 asemel nime VASAK_MOOTOR.

Selline lähenemine teeb programmi paremini loetavaks. Kui hiljem otsustame mootori teise pin'i külge ühendada, piisab ainult #define real oleva numbri muutmisest. (PCB peal enam juhet ümber tõsta ei saa, aga hea teada tulevikuks)

NB! Erinevalt tavalistest C++ käskudest ei kirjutata #define rea lõppu semikoolonit (;).