Comentarii în C++
Comentariile sunt note pentru oameni, scrise direct în cod. Compilatorul le ignoră complet. Un cod bine comentat este ușor de înțeles de colegi și de tine, peste câteva luni.
Comentariul pe o linie: //
Tot ce urmează după //, până la sfârșitul rândului, este un comentariu. Poate sta pe un rând separat sau la finalul unei instrucțiuni:
#include <iostream>
using namespace std;
int main() {
// Afișăm un mesaj de bun venit
cout << "Bun venit!" << endl; // apare în consolă
return 0;
}
Bun venit!
În consolă apare doar mesajul. Comentariile nu ajung niciodată în programul executat.
Scrie un program care conține un comentariu pe o linie (//), un comentariu pe mai multe linii (/* */) și o linie de afișare dezactivată cu //. Programul trebuie să afișeze doar: Comentariile nu se văd!
- Adaugă un comentariu /* ... */ care descrie programul.
- Afișează Comentariile nu se văd! și pune un comentariu // pe acel rând sau deasupra.
- Adaugă o linie cout << "Nu apar" << endl; dezactivată cu // în față.
Soluția exercițiului
#include <iostream>
using namespace std;
int main() {
/*
Primul meu program cu comentarii.
Afișează un singur mesaj.
*/
cout << "Comentariile nu se văd!" << endl; // mesajul afișat
// cout << "Nu apar" << endl;
return 0;
} Vrei să afli mai mult?Comentariul pe mai multe linii: /* */ · Comentarea temporară a unei linii · Ce scriem în comentarii · Greșeli frecvente · Comentariile în proiectele reale
Comentariul pe mai multe linii: /* */
Pentru explicații mai lungi, folosești /* la început și */ la sfârșit. Tot ce e între ele, pe oricâte rânduri, este ignorat:
#include <iostream>
using namespace std;
int main() {
/*
Program: magazin online
Autor: Ana
Afișează mesajul de pe prima pagină.
*/
cout << "Reduceri de toamnă!" << endl;
return 0;
}
Reduceri de toamnă!
Comentariile /* */ nu pot fi puse unul în altul. Primul */ întâlnit închide comentariul, iar restul textului devine cod, ceea ce produce erori.
Comentarea temporară a unei linii
Programatorii folosesc des comentariile ca să „oprească” o linie fără să o șteargă. Pui // în fața ei și compilatorul o sare:
#include <iostream>
using namespace std;
int main() {
cout << "Pasul 1" << endl;
// cout << "Pasul 2" << endl;
cout << "Pasul 3" << endl;
return 0;
}
Pasul 1 Pasul 3
Linia cu Pasul 2 există încă în fișier, dar nu se mai execută. Când vrei să o readuci, ștergi //.
Această tehnică este foarte utilă când cauți o greșeală: dezactivezi pe rând bucăți de cod până găsești linia care produce problema.
Ce scriem în comentarii
| Comentariu bun | Comentariu inutil |
|---|---|
| // prețul include TVA de 21% | // afișăm, înaintea unui cout evident |
| // ordinea contează: întâi verificăm stocul | // asta e o linie de cod |
| /* calculul urmează formula băncii */ | comentarii vechi care nu mai corespund codului |
Regula de aur: comentariul explică de ce faci ceva, nu repetă ce face codul, pentru că asta se vede deja din cod.
Greșeli frecvente
- / comentariu cu o singură bară: nu este comentariu, compilatorul dă eroare.
- /* fără */: tot restul fișierului devine comentariu, iar compilatorul se plânge că lipsește sfârșitul lui main.
- // în interiorul ghilimelelor: "http://site.ro" se afișează normal, acolo // face parte din text.
Comentariile în proiectele reale
Colegii înțeleg mai repede codul tău când explici deciziile importante.
Unelte precum Doxygen generează documentație din comentariile din cod.
Dezactivezi temporar linii suspecte fără să le pierzi.
