Deklarowanie zmiennych globalnych i lokalnych w VEXcode Pro V5

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.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus