Comentarii în C
Comentariile sunt note scrise pentru oameni, nu pentru calculator: compilatorul le ignoră complet. Le folosești ca să explici codul, să îl împarți în secțiuni și să dezactivezi temporar o linie fără să o ștergi.
Ce este un comentariu
Un comentariu este text din fișierul .c pe care compilatorul îl sare. Nu apare în program și nu se afișează niciodată în consolă.
#include <stdio.h>
int main(void) {
// Acesta este un comentariu: nu se afișează
printf("Comentariile nu se afișează\n");
return 0;
}Comentariile nu se afișează
Scrie un program comentat care afișează exact Comentariile nu se afișează. Programul trebuie să conțină cel puțin un comentariu // și un comentariu /* */.
- Pune la început un comentariu /* */ care descrie programul.
- Adaugă un comentariu // deasupra instrucțiunii printf.
- Afișează exact textul cerut.
Soluția exercițiului
/* Program care arată că
comentariile sunt ignorate */
#include <stdio.h>
int main(void) {
// afișăm un singur mesaj
printf("Comentariile nu se afișează\n");
return 0;
} Vrei să afli mai mult?Comentarii pe o linie: // · Comentarii pe mai multe linii: /* */ · Comentarea temporară a codului · Ce comentarii sunt utile · Comentariile în proiecte reale
Comentarii pe o linie: //
Tot ce urmează după //, până la capătul rândului, este comentariu. Îl poți pune pe un rând separat sau la finalul unei instrucțiuni:
#include <stdio.h>
int main(void) {
// Afișăm meniul zilei
printf("Supă de legume\n"); // felul întâi
printf("Paste cu sos\n"); // felul doi
return 0;
}Supă de legume Paste cu sos
Comentarii pe mai multe linii: /* */
Tot ce se află între /* și */ este comentariu, chiar dacă se întinde pe mai multe rânduri. Este forma clasică din C și se folosește des pentru explicații mai lungi, la începutul fișierului:
/*
Program: salut
Autor: Ana Popescu
Scop: afișează un mesaj de bun venit
*/
#include <stdio.h>
int main(void) {
printf("Bun venit!\n");
return 0;
}Bun venit!
Comentariile /* */ nu se pot pune unul în altul. Primul */ întâlnit închide comentariul, iar restul textului devine cod, care de obicei produce erori.
Comentarea temporară a codului
Programatorii folosesc des comentariile ca să „oprească” o linie fără să o șteargă, de exemplu când caută o greșeală sau testează o variantă:
#include <stdio.h>
int main(void) {
printf("Pasul 1\n");
// printf("Pasul 2\n");
printf("Pasul 3\n");
return 0;
}Pasul 1 Pasul 3
Linia cu Pasul 2 este acum comentariu, deci nu se execută. Ca să o reactivezi, ștergi doar //.
În majoritatea editoarelor, combinația Ctrl + / (sau Cmd + / pe Mac) comentează sau decomentează rândul curent.
Ce comentarii sunt utile
- Explică de ce faci ceva, nu repeta ce face codul. // adăugăm 5 lei taxa de livrare e util; // afișăm deasupra unui printf nu spune nimic nou.
- Pune un comentariu scurt la începutul fișierului: ce face programul.
- Împarte programele mai lungi în secțiuni: // 1. Date, // 2. Calcule, // 3. Afișare.
- Nu lăsa la nesfârșit cod comentat: după ce ai terminat testele, șterge-l.
Comentariile în proiecte reale
Colegii înțeleg mai repede codul tău dacă explici deciziile neobișnuite.
Unelte precum Doxygen generează documentație din comentarii speciale /** */.
Comentezi temporar bucăți de cod ca să afli care dintre ele produce problema.
