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
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 scoreconst int MAX_SCORE = 100;/* Multi-line comment:This program calculates a student's average gradefrom three test scores and displays the result.It uses the global MAX_SCORE constant for validation.*/int main() {// Initialize three test scoresint score1 = 85;int score2 = 90;int score3 = 78;// Calculate average using integer divisionint average = (score1 + score2 + score3) / 3;// Display resultscout << "Test scores: " << score1 << ", " << score2 << ", " << score3 << endl;cout << "Average: " << average << endl;// Validate against maximumif (average > MAX_SCORE) { // Should never happencout << "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