...
← Curs C++: toate lecțiile
Lecția 4 · Afișare

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.

Exercițiul tău

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ță.
O linie care începe cu // nu se execută, chiar dacă arată ca o instrucțiune corectă.

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;
}
Excelent! Continuă cu lecția următoare →
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ă!
Atenție

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 //.

Bine de știut

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 bunComentariu 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

Lucru în echipă

Colegii înțeleg mai repede codul tău când explici deciziile importante.

Documentație

Unelte precum Doxygen generează documentație din comentariile din cod.

Depanare

Dezactivezi temporar linii suspecte fără să le pierzi.

main.cppC++
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Fundamente C++ Lecția 4 · Comentarii în C++
Progres 0% 0 din 17
Lecția curentă 4 / 15 Afișare