capypad
0 Tage Serie
cpp / beginner
Snippet

Code-Kommentare für Klarheit

Kommentare sind Anmerkungen im Code, die vom Compiler ignoriert werden, aber Programmierern helfen, die Logik zu verstehen. Einzeilige Kommentare verwenden // und kommentieren alles danach auf dieser Zeile aus. Mehrzeilige Kommentare verwenden /* zum Starten und */ zum Beenden, was Text über mehrere Zeilen erlaubt. Gut platzierte Kommentare erklären, warum Code etwas tut, nicht was - der Code selbst sollte für das Was selbsterklärend sein.

snippet.cpp
cpp
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
#include <iostream>
using namespace std;
 
// Global constant for maximum score
const int MAX_SCORE = 100;
 
/* Multi-line comment:
This program calculates a student's average grade
from three test scores and displays the result.
It uses the global MAX_SCORE constant for validation.
*/
 
int main() {
// Initialize three test scores
int score1 = 85;
int score2 = 90;
int score3 = 78;
// Calculate average using integer division
int average = (score1 + score2 + score3) / 3;
// Display results
cout << "Test scores: " << score1 << ", " << score2 << ", " << score3 << endl;
cout << "Average: " << average << endl;
// Validate against maximum
if (average > MAX_SCORE) { // Should never happen
cout << "Error: Average exceeds maximum!" << endl;
}
return 0; // Exit program successfully
}
Erklärung
1
// Global constant for maximum score
Einzeiliger Kommentar, der den Zweck der folgenden Konstantendeklaration erklärt
2
/* Multi-line comment: ... */
Blockkommentar über mehrere Zeilen für detaillierte Programmdokumentation
3
// Initialize three test scores
Kommentar, der die Initialisierung von Variablen am Anfang von main beschreibt
4
// Should never happen
Kommentar in Zeile mit Code, der erklärt, warum eine Bedingung nie ausgelöst werden sollte