Računalni programski jezik Microsoft Visual Basic već je godinama popularan u programskim krugovima. Programeri ga koriste za sve vrste projekata. Varijante ovog programskog jezika koriste se za web stranice, a druge vrste programa Visual Basic koriste se za mnoge Windows aplikacije koje svakodnevno koristimo. Jedan od bitnih elemenata Visual Basica je mogućnost uključivanja komentara, koji su bilješke ugrađene u kôd koje nemaju svrhu funkcionalnog koda. Visual Basic koristi posebne protokole kako bi ih razlikovao od koda. Dodavanje komentara iznimno je važno u većini projekata kako bi se gledateljima ljudskog koda pomoglo da pravilno pročitaju module koda. Ako trebate dodati komentare u Visual Basic, evo nekoliko temeljnih koraka kako biste bili sigurni da to radite ispravno.
Koraci
Korak 1. Odredite koju vrstu komentara želite dodati
Programeri imaju nekoliko različitih svrha za komentare koji određuju točan format i stil onoga što će biti uključeno u komentar.
- Uzmite u obzir komentare modula koda. Komentari modula su komentari više razine koji obično opisuju cjelokupnu svrhu modula koda, kao i druge informacije poput autorskih prava, autorstva itd.
- Procijenite potrebu za komentarima procedure. Također je potrebno komentirati različite postupke funkcionalnog koda. Komentari procedura odnose se na posebne funkcije koda i pomažu upozoriti druge programere o točnim rezultatima postupka prema načinu na koji je napisan.
Korak 2. Odaberite detaljne kategorije uporabe za komentare koda
Neke vrste komentara, poput komentara procedure, također dolaze u različitim oblicima. Shvatite ove različite namjene kako biste svom programu dodali prave vrste komentara.
- Procijenite korištenje komentara svrhe za postupke. Oni opisuju što postupak čini.
- Razmislite o upotrebi komentara povratne vrijednosti funkcije. To će drugima pomoći da razumiju koje se vrijednosti vraćaju procedurom.
- Uključite uvjetne komentare. Uvjetni komentari mogu opisati moguće uvjete pogrešaka i postupanje s pogreškama, kao i uvjete koji moraju biti ispunjeni da bi kôd ispravno radio.
Korak 3. Odaberite format komentara
Postoji i pitanje kako ćete dodati komentare u određene retke koda.
- Koristite komentare ljevorukih. Ovi komentari počinju s lijeve strane ekrana i nastavljaju se cijelim putem preko crte. Uobičajeno, koder mora proizvoljno završiti komentar blizu desne strane ekrana, spustiti se na novi redak i nastaviti komentar.
- Koristite ugrađene komentare. Ugrađeni komentari imaju apostrof izravno iza dijela koda i stavljaju se u isti redak.
Korak 4. Upotrijebite apostrof za označavanje početka svojih komentara
Ovo je ključni korak za pisanje komentara u kod. Apostrof je specifični tekstualni protokol koji prevoditelj Visual Basic prepoznaje radi komentara. Bez toga će računalo pokušati pročitati komentare kao kôd.