Езикът за компютърно програмиране на Microsoft Visual Basic е популярен в средите за програмиране от много години. Програмистите го използват за всякакви проекти. Варианти на този език за програмиране се използват за уеб страници, а други видове програми на Visual Basic се използват за много от приложенията на Windows, които използваме всеки ден. Един от съществените елементи на Visual Basic е възможността за включване на коментари, които са бележки, вградени в кода, които нямат функционален код. Visual Basic използва специфичен протокол, за да ги разграничи от кода. Добавянето на коментари е изключително важно в повечето проекти, за да се помогне на зрителите на човешки код да прочетат кодовите модули правилно. Ако трябва да добавите коментари към Visual Basic, ето някои от основните стъпки, за да сте сигурни, че правите това правилно.
Стъпки
Стъпка 1. Определете кой тип коментар искате да добавите
Програмистите имат няколко различни основни цели за коментари, които определят точния формат и стил на това, което ще бъде включено в коментара.
- Помислете за коментарите на модула на кода. Коментарите на модула са коментари от по-високо ниво, които обикновено описват общите цели на кодовия модул, както и друга информация като авторски права, авторство и др.
- Оценете необходимостта от коментари по процедурата. Трябва да се коментират и различни процедури за функционален код. Коментарите за процедурите се отнасят до специфичните функции на кода и помагат да се предупреждават другите програмисти за точните резултати от процедурата според начина, по който е написана.
Стъпка 2. Изберете подробни категории на използване за вашите кодови коментари
Някои видове коментари, като коментари за процедури, също идват в различни форми. Разберете тези различни употреби, за да добавите правилните видове коментари към вашата програма.
- Оценете използването на целеви коментари за процедури. Те описват какво прави процедурата.
- Помислете за използването на коментари за връщане на стойност на функцията. Това ще помогне на другите да разберат какви стойности се връщат по процедура.
- Включете условни коментари. Условните коментари могат да описват възможни условия за грешка и обработка на грешки, както и условия, които трябва да бъдат изпълнени, за да работи кодът правилно.
Стъпка 3. Изберете формат за коментари
Има и въпросът как ще добавяте коментари към конкретни редове код.
- Използвайте коментари с левичари. Тези коментари започват отляво на екрана и продължават по целия път през ред. Обикновено кодерът трябва произволно да прекрати коментара близо до дясната страна на екрана, да слезе до нов ред и да продължи коментара.
- Използвайте вградени коментари. Вградените коментари имат апостроф директно след парче код и се поставят на същия ред.
Стъпка 4. Използвайте апостроф, за да отбележите началото на коментарите си
Това е ключовата стъпка за действително записване на коментари в код. Апострофът е специфичният текстов протокол, който компилаторът на Visual Basic разпознава за коментари. Без това компютърът ще се опита да прочете коментарите като код.
