INF.04Języki i Składnia Programowania
Komentarze w językach programowania
Niewykonywane fragmenty kodu źródłowego ignorowane przez kompilator i interpreter, służące do opisu działania programu, dokumentacji API lub tymczasowego wyłączania instrukcji.
Składnia komentarzy w popularnych językach:
| Język programowania | Komentarz jednoliniowy | Komentarz wieloliniowy | Komentarz dokumentacyjny |
|---|---|---|---|
| C# | // komentarz | /* blok */ | /// <summary>opis</summary> (XML Doc) |
| C++ | // komentarz | /* blok */ | /** Doxygen */ |
| Java | // komentarz | /* blok */ | /** Javadoc */ |
| JavaScript / TypeScript | // komentarz | /* blok */ | /** JSDoc */ |
| Python | # komentarz | """ blok """ lub ''' blok ''' | """ Docstrings """ |
| PHP | // komentarz lub # komentarz | /* blok */ | /** PHPDoc */ |
| HTML | <!-- komentarz --> | <!-- blok --> | Brak |
| CSS | Brak (tylko wieloliniowy) | /* blok */ | Brak |
| SQL | -- komentarz lub # | /* blok */ | Brak |
Zastosowanie komentarzy:
- Wyjaśnianie trudnej logiki biznesowej: Opisanie dlaczego kod został napisany w dany sposób.
- Generowanie dokumentacji: Narzędzia (Swagger, Javadoc, Doxygen) automatycznie generują dokumentację techniczną z komentarzy dokumentacyjnych.
- Debugowanie: 'Zakomentowanie' fragmentu kodu w celu zdiagnozowania usterki.
Pułapki na egzaminie INF.04:
- Python: Jednoliniowy komentarz oznacza się znakiem
#(kratka/hash). - SQL: Standardowy komentarz jednoliniowy rozpoczyna się od dwóch kresek
--(wymagana spacja po myślnikach). - CSS: Nie posiada komentarza jednoliniowego
//– jedynym poprawnym zapisem w CSS jest/* komentarz */.
Chcesz sprawdzić to pojęcie w praktyce?
Przeszukaj pytania z oficjalnych arkuszy CKE powiązane z hasłem Komentarze w językach programowania lub rozpocznij trening.