Dla zmiennych globalnych
Klucz: Unikaj używania global.
Niewłaściwe użycie zmiennych globalnych spowoduje zły projekt programu. Oto niektóre niekorzystne skutki uboczne wynikające z niewłaściwego użycia zmiennych globalnych:
- Przełamać modułowość
- Błędne kody
- Niechlujny i bardzo zagmatwany kod – aka kod spaghetti
- Trudne do debugowania i konserwacji
- Podatne na błędy
Oto kilka dobrych zmiennych globalnych:
int LeftEyePort = PORT1;
int RightEyePort = PORT2;
pływak Średnica koła = 10,25;
pływak EncPerCM = 360,0 / (Średnica koła * PI);
int main( ) {
....
}
O ile robot nie może zmienić średnicy koła lub rodzaju urządzeń podłączonych do portów podczas pracy, sensowne jest zadeklarowanie ich jako zmiennych globalnych const.
Na przykład:
const int LeftEyePort = PORT1; stała int RightEyePort = PORT2; stała pływakowa średnica koła = 10,25; const float EncPerCM = 360,0 / (Średnica koła * PI);
Dla zmiennych lokalnych
- Spróbuj ograniczyć użycie pojedynczej litery w przypadku „zlokalizowanego” prostego licznika.
np
for ( int i=0 ; i< 10; i++) {
....
}
Nie używaj „i” do reprezentowania czegoś z ważnym kontekstem innym niż zwykły licznik.
np. nie używaj „e” do reprezentowania wartości kodera.
- Powinien odnosić się do tego, co reprezentuje; np. użyj „totalEncoder” do przedstawienia całkowitej wartości kodera zamiast np. X.
- Poprzedź zmienną typem danych, np.:
int iWartość; float fWartość; podwójna wartość d;
- Nie używaj początkowego „_”. Zgodnie z konwencją zmienne poprzedzone „_” są używane do bardzo specjalnych celów, takich jak „dyrektywy”. Konstrukcja dyrektywy służy do określenia, w jaki sposób kompilator powinien przetwarzać dane wejściowe. Zostanie to omówione w innym artykule. Jeśli nie jesteś zaznajomiony z dyrektywami, zaleca się, aby „nie” używać początkowego „_” jako części nazw zmiennych.
- Maksymalizuj czytelność:
- W przypadku długich nazw używaj stylu Camel, np. encoderPerCM, encPerRotation. Niektórzy programiści lubią używać „_”, na przykład encoder_per_cm.