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.