Dla zmiennych globalnych
Klucz: Unikaj używania globalnych.
Niewłaściwe użycie zmiennych globalnych spowoduje kiepski projekt programu. Oto kilka słabych skutków ubocznych wynikających z niewłaściwego użycia zmiennych globalnych:
- Przełam modułowość
- Kody błędów
- Brudny i bardzo mylący kod – aka kod spaghetti
- Trudne do debugowania i utrzymania
- Podatne na błędy
Oto kilka dobrych zmiennych globalnych:
int LeftEyePort = PORT1;
int RightEyePort = PORT2;
float Średnica koła = 10,25;
float EncPerCM = 360,0 / (WheelDiameter * PI);
int main() {
....
}
O ile twój robot nie może zmienić średnicy koła lub typu urządzeń podłączonych do portów podczas pracy, sensowne jest zadeklarowanie ich jako stałych zmiennych globalnych.
Na przykład:
const int LeftEyePort = PORT1; const int RightEyePort = PORT2; const float Średnica koła = 10,25; const float EncPerCM = 360,0 / (WheelDiameter * PI);
Dla zmiennych lokalnych
- Spróbuj ograniczyć użycie jednej litery do „zlokalizowanego” prostego licznika.
np.
for ( int i=0 ; i< 10; i++) {
....
}
Nie używaj „i”, aby przedstawić coś z ważnym kontekstem innym niż prosty licznik.
np. nie używaj „e” do reprezentowania wartości enkodera.
- Powinien odnosić się do tego, co reprezentuje; np. użyj „totalEncoder”, aby przedstawić całkowitą wartość kodera zamiast np. , X.
- Poprzedź zmienną typem danych, na przykład:
int iValue; float fValue; podwójna wartość dValue;
- Nie używaj początkowego „_”. Zgodnie z konwencją, zmienne poprzedzone przedrostkiem „_” są używane do pewnych bardzo specjalnych celów, takich jak „dyrektywy”. Konstrukcja dyrektywy służy do określenia, w jaki sposób kompilator powinien przetwarzać swoje dane wejściowe. Zostanie to omówione w innym artykule. Jeśli nie znasz dyrektyw, zaleca się, aby „nie” używać początkowego „_” jako części nazw zmiennych.
- Maksymalizuj czytelność:
- Użyj stylu Camel dla długich nazw, np. encoderPerCM, encPerRotation. Niektórzy programiści lubią używać „_”, na przykład encoder_per_cm.