Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Commenti e documentazione

C++ offre commenti // che arrivano fino alla fine della riga e commenti di blocco /* ... */. Consentono di spiegare il codice e scrivere documentazione senza eseguire il loro contenuto. I commenti di blocco non possono essere annidati.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

// comment
/* comment */

Un commento // termina immediatamente prima del carattere di nuova riga successivo. Un commento /* ... */ può estendersi su più righe e termina al primo */. I commenti di blocco non si annidano: un altro /* non avvia un commento interno.

Durante la traduzione, ogni commento viene sostituito da uno spazio, mentre i caratteri di nuova riga vengono conservati. Pertanto, int/**/value separa int e value, mentre va/**/lue non forma l’identificatore value. L’unione delle righe avviene prima del riconoscimento dei commenti: un \ alla fine di una riga che contiene un commento // può far sì che il commento includa anche la riga fisica successiva. Evita questa forma.

Forme documentative come /// e /** ... */ sono normali commenti per il linguaggio; la loro interpretazione come documentazione dipende da strumenti separati. È preferibile spiegare scopo, presupposti e vincoli, anziché ripetere le istruzioni del codice. Nell’esempio, il commento /// descrive add e il commento di blocco separa i token in un’espressione.

Questa voce riguarda C++23. La fonte fornita è una bozza di lavoro in evoluzione, non un’edizione C++23 definitiva. Un’impostazione della modalità del compilatore in un repository non attesta l’ambiente di esecuzione di produzione.

Esempi

#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';
}

Risultato

5

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti