Kommenttilohkojen käyttö#

Using Comment Blocks

Tämä tutoriaali käsittelee kommenttilohkojen käyttöä VEXcode GO:ssa. Loppujen lopuksi tiedät miksi ja miten kommentteja käytetään projektin dokumentointiin.

Kommentti-lohkojen avulla voit lisätä muistiinpanoja suoraan lohkopinoon, joka löytyy työkalupakin Logiikka - Kommentit-kategoriasta. Ne eivät vaikuta projektisi toimintaan – ne ovat vain auttamassa sinua ja muita ymmärtämään sitä.

Oletusarvoinen kommenttilohko, alla käynnistettäessä.#
kun käynnistetään :: hat events
[comment]

Ohjelmoijat käyttävät kommentteja koodinsa järjestämiseen ja sen lukemisen ja ymmärtämisen helpottamiseen sekä itselleen palatessaan projektiin myöhemmin että muille sen parissa työskenteleville. Yhden lohkon nimi kuvaa vain kyseistä yhtä lohkoa, mutta kommentti voi kuvata kokonaisen lohkojen osan toiminnan kerralla – joten voit ymmärtää lohkojen pinon toiminnan yhdellä silmäyksellä lukematta jokaista yksittäistä lohkoa läpi.

Esimerkiksi tässä projektissa ajetaan eteenpäin, kunnes se törmää johonkin ja peruutetaan sitten. Kuten kirjoitettu, tämän ymmärtäminen vaatii jokaisen lohkon läpi lukemista.

Projekti, joka etenee, kunnes se törmää johonkin, ja sitten peruuttaa.#
kun käynnistetään :: hat events
aja [eteenpäin v]
odota kunnes <[bumper v] painettu? :: custom-led>
pysäytä ajaminen
aja [taaksepäin v] (100) [mm v] ▶

Kunkin osion yläpuolelle lisättävä kommentti kuvaa sen toimintaa, mikä helpottaa projektin ymmärtämistä yhdellä silmäyksellä.

Sama projekti, kommenteilla, jotka kuvaavat kunkin osion toimintaa.#
kun käynnistetään :: hat events
[Drive forward until something is in the way.]
aja [eteenpäin v]
odota kunnes <[bumper v] painettu? :: custom-led>
[Back away from the object.]
pysäytä ajaminen
aja [taaksepäin v] (100) [mm v] ▶

Kun olet yhdistänyt robottisi VEXcodeen, valitse Käynnistä projektin suorittamiseksi. Robotti ajaa eteenpäin, pysähtyy ja peruuttaa, kun se törmää johonkin.

Kuvakaappaus VEXcode GO -työkalurivistä, jossa Käynnistä-painike on korostettuna.