Používání bloků komentářů

Using Comment Blocks

Tento tutoriál se zabývá používáním bloků komentářů ve VEXcode GO. Na konci budete vědět proč a jak používat komentáře k dokumentaci projektu.

Bloky Komentáře vám umožňují přidávat poznámky přímo do vaší sady bloků, kterou najdete v kategorii Logika - Komentáře v sadě nástrojů. Neovlivňují běh vašeho projektu – slouží pouze k tomu, aby vám a ostatním pomohly projektu porozumět.

Výchozí blok komentářů, níže při spuštění.

při spuštění :: hat events
[comment]

Programátoři používají komentáře k organizaci svého kódu a usnadnění jeho čtení a pochopení, a to jak pro ně samotné, kteří se k projektu později vrátí, tak i pro ostatní, kteří na něm pracují. Název jednoho bloku popisuje pouze tento jeden blok, ale komentář může popsat chování celé sekce bloků najednou – takže na první pohled pochopíte, co bloková sekce dělá, aniž byste museli číst každý jednotlivý blok.

Například tento projekt se pohybuje vpřed, dokud do něčeho nenarazí, a pak couvne. Jak je napsáno, pochopení toho vyžaduje čtení každého bloku.

Projekt, který jede, dokud do něčeho nenarazí, a pak couvne.

při spuštění :: hat events
jet [dopředu v]
čekat dokud <[bumper v] stisknuto? :: custom-led>
zastavit jízdu
jet [zpět v] na (100) [mm v] ▶

Přidání komentáře nad každou sekci popisuje její chování, což usnadňuje pochopení projektu na první pohled.

Stejný projekt s komentáři popisujícími chování každé sekce.

při spuštění :: hat events
[Drive forward until something is in the way.]
jet [dopředu v]
čekat dokud <[bumper v] stisknuto? :: custom-led>
[Back away from the object.]
zastavit jízdu
jet [zpět v] na (100) [mm v] ▶

Po připojení robota k VEXcode spusťte projekt výběrem možnosti Start. Robot se po nárazu do něčeho pohne dopředu, zastaví se a couvne.