Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori