Comentarii în cod
Codul nu este scris doar pentru calculator, ci și pentru oameni: colegii tăi și tu, peste câteva luni. Comentariile sunt note pe care compilatorul le ignoră complet. În această lecție înveți cele două feluri de comentarii din Kotlin și cum să „oprești” temporar o linie de cod.
Ce este un comentariu?
Un comentariu este un text din cod pe care compilatorul nu îl citește. Nu se execută și nu apare în consolă. Îl scrii ca să explici *de ce* ai făcut ceva sau ca să lași o notă pentru mai târziu.
În Kotlin, tot ce urmează după // până la finalul rândului este comentariu:
fun main() {
// Acest program salută utilizatorul
println("Bună ziua!") // afișează salutul
}Bună ziua!
Comentariul poate sta pe un rând separat sau la finalul unei instrucțiuni. În ambele cazuri, de la // încolo totul este ignorat.
Starter-ul afișează trei rânduri. Comentează instrucțiunea care afișează Linia 2, astfel încât în consolă să apară doar Linia 1 și Linia 3.
- Nu șterge rândul cu Linia 2: pune // în fața lui.
- Lasă neschimbate celelalte două instrucțiuni.
- Rulează și verifică faptul că apar doar două rânduri.
Soluția exercițiului
fun main() {
println("Linia 1")
// println("Linia 2")
println("Linia 3")
} Vrei să afli mai mult?Comentarii pe mai multe rânduri · De ce comentăm? · Comentarea temporară a unei linii · Greșeli frecvente · Comentariile în proiecte reale
Comentarii pe mai multe rânduri
Când ai de scris o explicație mai lungă, folosește /* pentru început și */ pentru sfârșit. Tot ce este între ele, oricâte rânduri ar avea, e ignorat:
fun main() {
/*
Program: mesajul de bun venit
Autor: echipa Academiei
Afișează două rânduri în consolă.
*/
println("Bun venit!")
println("Spor la învățat!")
}Bun venit! Spor la învățat!
Fiecare /* trebuie închis cu */. Dacă uiți închiderea, tot restul fișierului devine comentariu, iar compilatorul se plânge că lipsesc acolade.
De ce comentăm?
- Explici intenția: // livrarea e gratuită peste 200 lei spune de ce există o regulă, nu doar ce face codul.
- Lași note pentru echipă: într-o aplicație reală lucrează mai mulți programatori pe același cod.
- Îți ajuți memoria: peste trei luni nu vei mai ține minte de ce ai ales o anumită valoare.
Un comentariu bun nu repetă codul. println("Salut") // afișează Salut nu aduce nimic nou; // mesajul apare la prima deschidere a aplicației explică un context pe care codul nu îl arată.
Comentarea temporară a unei linii
Programatorii folosesc des comentariile ca să „oprească” o instrucțiune fără să o șteargă. Pui // în fața ei, iar linia nu se mai execută:
fun main() {
println("Pasul 1: pregătim comanda")
// println("Pasul 2: trimitem un SMS de test")
println("Pasul 3: comanda a fost trimisă")
}Pasul 1: pregătim comanda Pasul 3: comanda a fost trimisă
Rândul cu Pasul 2 este încă în fișier, dar compilatorul îl ignoră. Când vrei să-l folosești din nou, ștergi // din fața lui.
În majoritatea editoarelor (inclusiv Android Studio), Ctrl + / (pe Mac Cmd + /) comentează sau decomentează rândul pe care se află cursorul.
Greșeli frecvente
- **Un singur /**: / comentariu nu este comentariu, ci o eroare de sintaxă.
- Comentariu închis greșit: /* text /* nu se închide; închiderea este */.
- Comentarii învechite: dacă schimbi codul, actualizează și comentariul, altfel acesta minte.
- **// în interiorul unui text**: în println("http://site.ro") cele două bare fac parte din text, nu încep un comentariu.
Comentariile în proiecte reale
Într-o aplicație de livrări, comentariile explică regulile de business: de ce comanda minimă e 30 de lei sau de ce o reducere se aplică doar luni.
Când cauți o greșeală, comentezi pe rând câte o instrucțiune ca să vezi care dintre ele produce problema.
Comentariile speciale /** ... */ (KDoc) generează automat documentația bibliotecilor Kotlin și Android.
