CKTIS / C++
Komentari i dokumentacija
C++ nudi komentare // koji se protežu do kraja retka i blokovske komentare /* ... */. Oni omogućuju objašnjavanje koda i pisanje dokumentacije bez izvršavanja njihova sadržaja. Blokovski komentari ne mogu se ugnijezditi.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
// comment
/* comment */Komentar // završava neposredno prije sljedećeg znaka novog retka. Komentar /* ... */ može obuhvatiti više redaka i završava na prvom */. Blokovski komentari ne ugnježđuju se: dodatni /* ne započinje unutarnji komentar.
Tijekom prevođenja svaki se komentar zamjenjuje jednim razmakom, dok se znakovi novog retka čuvaju. Zato int/**/value razdvaja int i value, dok va/**/lue ne tvori identifikator value. Spajanje redaka odvija se prije prepoznavanja komentara: \ na kraju retka koji sadrži komentar // može uzrokovati da komentar obuhvati i sljedeći fizički redak. Izbjegavajte takav zapis.
Oblici dokumentacije kao što su /// i /** ... */ za jezik su obični komentari; njihovo tumačenje kao dokumentacije ovisi o zasebnim alatima. Radije objašnjavajte svrhu, pretpostavke i ograničenja nego da ponavljate upute iz koda. U primjeru komentar /// opisuje add, a blokovski komentar razdvaja tokene u izrazu.
Ovaj se unos odnosi na C++23. Dostavljeni izvor je radni nacrt koji se razvija, a ne zamrznuto izdanje C++23. Postavka načina rada prevoditelja u repozitoriju ne potvrđuje produkcijsko izvršno okruženje.
Primjeri
#include <iostream>
/// Return the sum of two integers.
/// Precondition: The mathematical sum of a and b is representable as int.
int add(int a, int b) {
return a /* first operand */ + b;
}
int main() {
// Print the result once.
std::cout << add(2, 3) << '\n';
}
Rezultat
5
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.