The VEX Visual Studio Code Extension has replaced VEXcode Pro V5, which is now end-of-life.
VEXcode Blocks and VEXcode Text remain actively developed and supported for all VEX platforms.
Globaalit muuttujat
Avain: Vältä globaalia käyttöä.
Globaalien muuttujien virheellinen käyttö johtaa huonoon ohjelman suunnitteluun. Tässä on joitain huonoista sivuvaikutuksista, jotka johtuvat globaalien muuttujien virheellisestä käytöstä:
- Riko modulaarisuus
- Bugiset koodit
- Sotkuinen ja erittäin hämmentävä koodi – alias spagettikoodi
- Vaikea korjata ja ylläpitää
- Virheille altis
Tässä on joitain hyviä globaaleja muuttujia:
int LeftEyePort = PORTTI1; int RightEyePort = PORTTI2; kelluvan pyörän halkaisija = 10,25; float EncPerCM = 360,0 / (pyörän halkaisija * PI); int main( ) { .... }
Ellei robotti voi muuttaa pyörän halkaisijaa tai portteihin kytkettyjen laitteiden tyyppiä sen ollessa käynnissä, on järkevää ilmoittaa ne const globaaleiksi muuttujiksi.
Esimerkiksi:
const int LeftEyePort = PORTTI1; const int RightEyePort = PORTTI2; vakio kelluva pyörän halkaisija = 10,25; const float EncPerCM = 360,0 / (pyörän halkaisija * PI);
Paikallisille muuttujille
- Yritä rajoittaa yhden kirjaimen käyttöä "lokalisoidussa" yksinkertaisessa laskurissa.
esim
for ( int i=0 ; i< 10; i++) { .... }
Älä käytä i-kirjainta edustamaan jotain, jolla on muu tärkeä asiayhteys kuin yksinkertainen laskuri.
esim. älä käytä "e" edustamaan kooderin arvoa.
- Pitäisi liittyä siihen, mitä se edustaa; esim. käytä "totalEncoder" edustamaan kooderin kokonaisarvoa esim. X:n sijaan.
- Liitä muuttujan eteen tietotyyppi, kuten:
int iValue; float fArvo; double dValue;
- Älä käytä alkukirjainta _. Sopimuksen mukaan muuttujia, joiden etuliitteenä on "_", käytetään joihinkin hyvin erityisiin tarkoituksiin, kuten "direktiiveihin". Direktiivirakennetta käytetään määrittämään, kuinka kääntäjän tulee käsitellä syöttönsä. Tästä keskustellaan toisessa artikkelissa. Jos et ole perehtynyt ohjeisiin, suosittelemme, että et käytä alkukirjainta _ osana muuttujien nimiä.
- Maksimoi luettavuus:
- Käytä Camel-tyyliä pitkille nimille, esim. encoderPerCM, encPerRotation. Jotkut ohjelmoijat haluavat käyttää "_", kuten encoder_per_cm.