Använda kommentarblock#

Using Comment Blocks

Den här handledningen beskriver hur man använder kommentarsblock i VEXcode GO. I slutet kommer du att veta varför och hur man använder kommentarer för att dokumentera ett projekt.

Med Kommentarblock kan du lägga till anteckningar direkt i din blockstapel, som finns i kategorin Logik - Kommentarer i verktygslådan. De påverkar inte hur ditt projekt körs – de finns bara där för att hjälpa dig och andra att förstå det.

Standardkommentarblocket, nedan när det startas.#
när startad :: hat events
[comment]

Programmerare använder kommentarer för att organisera sin kod och göra den lättare att läsa och förstå, både för dem själva när de återkommer till ett projekt senare och för andra som arbetar med det. Namnet på ett enda block beskriver bara det blocket, men en kommentar kan beskriva beteendet hos en hel sektion av block samtidigt – så att du kan förstå vad en stapel av block gör med en snabb blick, utan att behöva läsa igenom varje enskilt block.

Till exempel kör det här projektet framåt tills det stöter mot något, och backar sedan undan. Som det är skrivet kräver det att man läser igenom varje block.

Ett projekt som kör på tills det träffar något, och sedan backar undan.#
när startad :: hat events
kör [framåt v]
vänta tills <[bumper v] tryckt? :: custom-led>
stoppa körning
kör [bakåt v] i (100) [mm v] ▶

Genom att lägga till en kommentar ovanför varje avsnitt beskrivs dess beteende, vilket gör projektet lättare att förstå vid en överblick.

Samma projekt, med kommentarer som beskriver varje sektions beteende.#
när startad :: hat events
[Drive forward until something is in the way.]
kör [framåt v]
vänta tills <[bumper v] tryckt? :: custom-led>
[Back away from the object.]
stoppa körning
kör [bakåt v] i (100) [mm v] ▶

Efter att du anslutit din robot till VEXcode, välj Start för att köra projektet. Roboten kommer att köra framåt, stanna och backa när den stöter på något.

Skärmdump av VEXcode GO-verktygsfältet, med Start-knappen markerad.