Il linguaggio di programmazione per computer Microsoft Visual Basic è stato popolare negli ambienti di programmazione per molti anni. I programmatori lo usano per tutti i tipi di progetti. Varianti di questo linguaggio di programmazione vengono utilizzate per le pagine Web e altri tipi di programmi Visual Basic vengono utilizzati per molte delle applicazioni Windows che usiamo ogni giorno. Uno degli elementi essenziali di Visual Basic è la possibilità di includere commenti, che sono note incorporate nel codice che non hanno uno scopo funzionale al codice. Visual Basic utilizza un protocollo specifico per distinguerli dal codice. L'aggiunta di commenti è estremamente importante nella maggior parte dei progetti per aiutare i visualizzatori di codice umano a leggere correttamente i moduli di codice. Se hai bisogno di aggiungere commenti a Visual Basic, ecco alcuni dei passaggi fondamentali per assicurarti di farlo correttamente.
Passi
Passaggio 1. Determina quale tipo di commento desideri aggiungere
I programmatori hanno diversi scopi principali per i commenti che determinano il formato e lo stile esatti di ciò che verrà incluso nel commento.
- Considera i commenti del modulo di codice. I commenti del modulo sono commenti di livello superiore che di solito descrivono gli scopi generali del modulo di codice, nonché altre informazioni come copyright, paternità e altro.
- Valutare la necessità di commenti sulla procedura. Vanno inoltre commentate varie procedure del codice funzionale. I commenti alla procedura si riferiscono alle funzioni specifiche del codice e aiutano ad avvisare altri programmatori sui risultati esatti di una procedura in base a come è scritta.
Passaggio 2. Scegli categorie dettagliate di utilizzo per i tuoi commenti sul codice
Alcuni tipi di commenti, come i commenti di procedura, sono disponibili anche in forme diverse. Comprendi questi diversi usi per aggiungere i giusti tipi di commenti al tuo programma.
- Valutare l'uso dei commenti di scopo per le procedure. Questi descrivono cosa fa la procedura.
- Considerare l'uso di commenti sui valori restituiti dalla funzione. Questi aiuteranno gli altri a capire quali valori vengono restituiti dalla procedura.
- Includi commenti condizionali. I commenti condizionali possono descrivere le possibili condizioni di errore e la gestione degli errori, nonché le condizioni che devono essere soddisfatte affinché il codice funzioni correttamente.
Passaggio 3. Scegli un formato per i commenti
C'è anche il problema di come aggiungere commenti a specifiche righe di codice.
- Utilizza commenti per mancini. Questi commenti iniziano a sinistra dello schermo e continuano lungo una linea. Comunemente, il programmatore deve terminare arbitrariamente il commento vicino al lato destro dello schermo, scendere su una nuova riga e continuare il commento.
- Usa i commenti in linea. I commenti in linea hanno un apostrofo subito dopo una parte di codice e sono posizionati sulla stessa riga.
Passaggio 4. Utilizzare un apostrofo per contrassegnare l'inizio dei commenti
Questo è il passaggio chiave per scrivere effettivamente i commenti nel codice. L'apostrofo è il protocollo di testo specifico che il compilatore Visual Basic riconosce per i commenti. Senza questo, il computer proverà a leggere i commenti come codice.
