Poznaj C++ w$ godziny0034

18 Godzina 2

Listing 2.2. hello . CPP, demonstracja komentarzy

1:    #include <iostream.h>

2:

3:    int main()

4:    <

5:    /* to    jest komentarz

6:    cały ten tekst jest pomijany aż do znaku

7:    końca    */

8:    cout « "Hello World!\n";

9:    // ten komentarz kończy się wraz z końcem linii

10:    cout « "Koniec komentarza!";

11:

12:    // komentarz "//" może być sam w linii

13:    /* podobnie jak ten komentarz */

14:    return 0;

15:    }

EFEKT DZIAŁANIA:

Hello World!

Koniec komentarza!

ANALIZA:

Komentarze w liniach od 5 do 7 są pomijane przez kompilator, podobnie jak komentarze w liniach 9, 12, i 13. Komentarz w linii 9 kończy się wraz końcem tej hnii. Komentarze z linii 5 i 13 wymagają znaku końca komentarza.

Używanie komentarzy

Pisanie dobrych komentarzy to wielka sztuka. Zapamiętaj zatem prostą regułę: Każdy może przeczytać twój program, ale nikt nie jest w stanie przeczytać twoich myśli. Pozwól programowi mówić do czego on służy i po co jest napisany.

ZAWSZE	NIGDY
Zawsze dodawaj komentarze do swoich programów. Zawsze uaktualniaj komentarze -niech faktycznie opisują program. Zawsze używaj komentarzy do informowania co dany fragment kodu robi.	Nigdy nie używaj komentarzy do kodu, który mówi sam za siebie. Nigdy nie należy przesadzać.

Listing 2.2. HELLO.CPP, demonstracja komentarzy

1:    finclude <iostream.h>

2:

3:    int main    ()

4:    (

5:    /* to jest komentarz

6:    cały ten    tekst jest pomijany aż do znaku

1:    końca */

8:    cout « "Hello World!\n";

9:    // ten komentarz kończy się wraz z końcem linii

10:    cout « "Koniec komentarza!";

11:

12:    // komentarz "//“ może być sam w linii

13:    /* podobnie jak ten komentarz */

14:    return 0;

15:    }

Hello World!

Koniec komentarza!

ANALIZA:

Komentarze w liniach od 5 do 7 są pomijane przez kompilator, podobnie jak komentarze w liniach 9, 12, i 13. Komentarz w linii 9 kończy się wraz końcem tej linii. Komentarze z Unii 5 i 13 wymagają znaku końca komentarza.

Używanie komentarzy

Pisanie dobrych komentarzy to wielka sztuka. Zapamiętaj zatem prostą regułę: Każdy może przeczytać twój program, ale nikt nie jest w stanie przeczytać twoich myśli. Pozwól programowi mówić do czego on służy i po co jest napisany.

ZAWSZE	NIGDY
Zawsze dodawaj komentarze do swoich programów. Zawsze uaktualniaj komentarze -niech faktycznie opisują program. Zawsze używaj komentarzy do informowania co dany fragment kodu robi.	Nigdy nie używaj komentarzy do kodu, który mówi sam za siebie. Nigdy nie należy przesadzać.