Le persone si commentano se a loro piace qualcosa l'uno dell'altro o non amano qualcosa. Se sei mai stato su un sito Web in cui vuoi imparare qualcosa, devi aver trovato la sezione di feedback in cui l'autore ti chiede di scrivere i tuoi commenti sull'intero contenuto. In alcuni casi, fornisci i commenti e in alcuni casi, si cerca di non dare alcun commento. Proprio in questo modo, anche i linguaggi di programmazione tendono a utilizzare i commenti nello stesso file di codice. Programmatori piace usare questi commenti per aiutarsi in futuro per comprendere il programma anche se è stato recuperato dopo un decennio. Può anche aiutare nuovi studenti e se passi il tuo codice a qualcun altro, può chiedere aiuto. Questo articolo ti aiuta a capire l'uso di commenti multiline.
Esempio 1: commenti a linea singola
Prima di dare un'occhiata ai commenti multiline. I commenti a linea singola iniziano sempre con un segno a doppia barra "//" nella programmazione Java. Il commento a linea singola non ha caratteri finali specifici come "/" o "8". Il commento supera solo la fine della riga e non include la riga di codice successiva.
Pertanto, spiegheremo come aggiungere i commenti a linea singola in un programma Java per aiutare a comprendere il codice. Per questo, creiamo un nuovo file Java nel suo pacchetto "test". Questo programma inizia con l'inizializzazione della classe principale () insieme alla dichiarazione della sua funzione principale (). Esistono un totale di tre dichiarazioni println () utilizzate per visualizzare un nuovo output ogni volta nell'area di uscita della console IDE Eclipse.
Prima di ciascuna istruzione funzione println (), utilizziamo un commento a riga singola alle righe 4, 6 e 8. Tutti e tre questi commenti a linea singola iniziano con i caratteri "//" a doppia barra e non hanno caratteri finali specifici se non nel caso del terzo commento. Il nostro terzo commento spiega l'uso della sintassi dei commenti "multi-line" per la dichiarazione di un commento a linea singola. Ciò significa che è possibile utilizzare i caratteri "/*" dei commenti multi-line per dichiarare un commento a linea singola ma non è possibile utilizzare il commento a linea singola per dichiarare un commento multilinea. Per creare un commento a linea singola, dobbiamo porre fine al commento con "*/" sulla stessa riga.
Ora eseguiamo questo codice con commenti a linea singola nel metodo principale () e vediamo cosa succede. Il seguente output allegato mostra i dati di testo utilizzati in tutte e 3 le dichiarazioni di funzioni println () come Eclipse IDE, Java e Windows. Questo output è senza alcun errore o avviso perché abbiamo incluso i commenti in modo molto corretto nel programma.
Esempio 2: commenti multiline
Dopo aver dato uno sguardo profondo ai commenti a linea singola, discuteremo su come aggiungere i commenti multi-line nella programmazione Java. Per questo, creiamo un nuovo file Java chiamato "Main.Java "nel suo pacchetto" test ". Il nome di un pacchetto viene generato automaticamente alla prima riga di codice, quindi non è necessario rimuoverlo. Altrimenti, potrebbe lanciare un errore. Pertanto, iniziamo il nostro programma con una nuova creazione di classe, Main. Se si utilizza un nome di classe diverso dal nome del file, riceverai errori sullo strumento Eclipse IDE. Evita di usare nomi diversi.
Dopodiché, è il momento di aggiungere la tua funzione principale () per questo programma. Pertanto, aggiungiamo questo metodo principale () nella classe principale () di recente generazione in quanto non useremo altre classi o funzioni e eseguirà tutto all'interno del metodo principale (). Subito dopo la dichiarazione del metodo principale, iniziamo il commento multi-line con i personaggi "/*" all'inizio della sua prima riga e i personaggi "*/" alla fine di questo commento alla seconda riga.
Questo commento multilinea contiene solo 2 righe. Aggiungiamo un testo che mostra che si tratta di un commento multi-riga tra i personaggi "/*" e "*/". Dopo questo commento, utilizziamo l'istruzione funzione println () che emette alcuni messaggi di testo nella console IDE Eclipse, "Lavorando in Eclipse IDE". Dopo questo, chiudiamo la funzione principale () insieme alla sua classe, tenendo tutto questo codice. Salva questo codice ed eseguilo tramite l'icona "Esegui" Eclipse.
Dopo aver toccato l'icona "run" dell'IDE ECLIPSE, otteniamo il testo "Working in Eclipse IDE" che viene visualizzato nell'area di uscita Eclipse. Abbiamo trovato zero errori e nessun avvertimento perché abbiamo aggiunto la sintassi perfetta per i commenti multi-line insieme all'intera sintassi del codice.
Esempio 3: Commenti Javadoc
Dopo aver avuto abbastanza conoscenze sui commenti a linea singola e multipla, assicurati di imparare i commenti Javadoc almeno con un esempio. I commenti Javadoc sono i commenti automatici generati dal JDK di un ambiente che hai utilizzato e che possono essere aggiunti da un utente stesso. Per aggiungere questi commenti Javadoc da solo, devi conoscere la sintassi dei commenti Javadoc. Una cosa da ricordare sui commenti di Javadoc è l'uso di un personaggio di asterisco "*" all'inizio di ogni riga di un commento Javadoc. Questo codice visualizza la somma di due valori interi e la stessa cosa è spiegata nel suo commento. Il commento include anche le sue informazioni sui metadati, i.e. "@Informazioni sull'autore.
L'output visualizza il valore 10 come output della somma.
Conclusione
Dopo la grande spiegazione di quali sono i commenti e di come possono essere utilizzati nella vita quotidiana, nei blog e nella programmazione, abbiamo discusso dei tipi di commenti in Java. Lo scopo di usare i commenti è rendere il COD più amichevole e leggibile dall'uomo, specialmente per le nuove api della programmazione. Sebbene l'argomento di questo articolo sia di discutere i commenti multiline. Dopo questo, l'elaborazione dei commenti multi-line è coperta da un esempio Java.