Komentář (programování)

Technology

12 hours ago

Author

Komentáře jsou v informatice součásti syntaktických pravidel zápisu programu v mnoha programovacích jazycích. Komentář se vkládá před nebo za část zdrojového kódu (např. příkaz), jehož funkci nebo význam je potřeba vysvětlit. Používání komentáře není povinné, umožňuje však napomoci k pochopení činnosti programu. Komentář nemá popisovat, co program dělá (protože to vyplývá ze zápisu programu), ale proč to dělá. Při zpracování zdrojového kódu preprocesor komentáře vypouští (ignoruje je), ale pro programátora mohou být velice důležité. Komentáře obecně mohou velmi usnadnit pochopení činnosti programu, mohou mít samodokumentující charakter a obecně vzato by měly usnadňovat přenositelnost tvorby programů z člověka na člověka, tedy z jednoho programátora na jiného programátora.

Syntaxe a pravidla pro přidávání komentářů se v jednotlivých programovacích jazycích liší a jsou definovány ve specifikaci konkrétního programovacího jazyka.

Pomocí speciálních nástrojů (generátorů dokumentace) lze z okomentovaného zdrojového kódu vygenerovat přehlednou dokumentaci k programu.

Komentáře tedy nemají žádný vliv na výsledný algoritmus programu, jsou zde uvedeny pouze jako pomůcka pro snadnější orientaci ve zdrojovém textu programu. Překladač komentáře nijak nepřekládá respektive ignoruje je.

Stručný přehled

Komentáře se dělí zpravidla na blokové komentáře a řádkové komentáře.

Blokové komentáře vymezují oblast zdrojového kódu, která může obsahovat více než jeden řádek. Tato oblast je ohraničena počátečním a koncovým oddělovačem. +more Vše mezi počátečním a koncovým oddělovačem je bráno jako komentář.

Řádkové komentáře mají jen počáteční oddělovač a vše za oddělovačem až na konec řádku je bráno jako komentář.

Některé programovací jazyky umožňují používání jak blokových, tak řádkových komentářů (např. JAVA, C++). +more Naproti tomu některé programovací jazyky umožňují užití jen řádkových komentářů (např. Perl, Ada).

Styly

Existuje několik stylistických alternativ jak by se měly komentáře ve zdrojovém kódu objevovat. U větších projektů na kterých pracuje skupina programátorů jsou styly komentářů předem dohodnuty podle konvence a podle toho jak se bude projekt rozrůstat. +more Zpravidla dávají programátoři přednost stylům komentářů, které jsou svým vzhledem celistvé a snadno editovatelné.

Následující části kódů v programovacím jazyce JAVA ukazují jen malou část toho, jak lze komentáře různě stylizovat, zatímco obsah komentáře je stále stejný.

Blokový komentář

/* Toto je blokový komentář. Varianta jedna. */

/**********************************\ * * * Toto je blokový komentář. * * Varianta dva. * * * \**********************************/

Řádkový komentář

//Toto je řádkový komentář. //------------------------- //Varianta tři. //------------------------

Softwarový konzultant Allen Holub je jeden z expertů, který prosazuje sjednocení stylu komentářů. Jím prosazovaný styl je zápis komentářových oddělovačů na levou stranu.

/* Toto je blokový komentář zapsaný stylem, * který prosazuje Allen Holub. */

Pro různé části zdrojového kódu lze použít různé styly komentáře. Lze použít řádkové komentáře pro drobné komentáře a dočasné zakomentování jednoho funkčního řádku kódu a blokové komentáře pro rozsáhlé komentáře s vyšší mírou abstrakce a dočasné zakomentování rozsáhlé funkční části zdrojového kódu.

Některé projekty se dokonce snaží prosazovat taková pravidla, jako je vkládání komentáře každých 10 řádků zdrojového kódu. Tyto pravidla mohou být ale někdy poněkud kontraproduktivní, ale i přes to některým programátorům pracujícím v týmech taková pravidla vyhovují.