Megjegyzésblokkok használata#

Using Comment Blocks

Ez az oktatóanyag bemutatja, hogyan használhatod a kommentblokkokat a VEXcode GO-ban. A végére megérted, miért és hogyan használhatod a kommenteket egy projekt dokumentálásához.

A Megjegyzés blokkokkal közvetlenül a blokkhalomhoz adhatsz megjegyzéseket, amelyek a Logika - Megjegyzések kategóriában találhatók az eszköztárban. Ezek nem befolyásolják a projekted futását – csak azért vannak ott, hogy segítsenek neked és másoknak megérteni azt.

Az alapértelmezett Megjegyzés blokk, lent, indításkor.#
amikor elindul :: hat events
[comment]

A programozók megjegyzéseket használnak a kódjuk rendszerezésére, hogy könnyebben olvasható és érthető legyen, mind a saját maguk számára, amikor később visszatérnek egy projekthez, mind a többiek számára, akik azon dolgoznak. Egyetlen blokk neve csak az adott blokkot írja le, de egy megjegyzés egyszerre egy teljes blokkszakasz viselkedését is leírhatja – így egy pillantással megértheted, hogy mit csinál egy blokkhalom anélkül, hogy minden egyes blokkot át kellene olvasnod.

Például ez a projekt addig halad előre, amíg valaminek neki nem ütközik, majd hátralép. Ahogy meg van írva, ennek megértéséhez minden egyes blokkot el kell olvasni.

Egy projekt, ami addig hajt, amíg valaminek neki nem ütközik, aztán hátrál.#
amikor elindul :: hat events
hajtás [előre v]
várakozás amíg <[bumper v] megnyomva? :: custom-led>
hajtás leállítása
hajtás [hátra v] irányba (100) [mm v] értékkel ▶

Minden egyes szakasz fölé hozzáadott megjegyzés leírja a viselkedését, így a projekt egy pillantással könnyebben megérthető.

Ugyanaz a projekt, az egyes szakaszok viselkedését leíró megjegyzésekkel.#
amikor elindul :: hat events
[Drive forward until something is in the way.]
hajtás [előre v]
várakozás amíg <[bumper v] megnyomva? :: custom-led>
[Back away from the object.]
hajtás leállítása
hajtás [hátra v] irányba (100) [mm v] értékkel ▶

Miután csatlakoztattad a robotodat a VEXcode-hoz, válaszd a Start gombot a projekt futtatásához. A robot előre fog menni, megáll, majd hátrafelé indul, ha valaminek nekiütközik.

A VEXcode GO eszköztár képernyőképe, kiemelve a Start gombot.