Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Komentari i dokumentacija u Javi

Komentari i dokumentacija u Javi: Java prepoznaje retčane komentare //, blokovske /* ... */ i dokumentacijske /** ... */; javadoc tumači oznake i iz doc comments stvara API dokumentaciju.

Verzija: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaksa

comments

Java prepoznaje retčane komentare //, blokovske /* ... / i dokumentacijske /* ... */; javadoc tumači oznake i iz doc comments stvara API dokumentaciju.

Koristi Javadoc za ugovor javnog API-ja s @param, @return i @throws te {@code ...} za siguran prikaz identifikatora i ulomaka koda.

Blokovski komentari ne mogu se ugnijezditi, pa kod koji sadrži */ prerano zatvara komentar; zastarjeli komentar gori je od preciznog naziva.

Unicode escapes obrađuju se prije tokenizacije: \u000a unutar // može postati kraj retka i uzrokovati prevođenje sljedećeg teksta kao koda.

Komentari // i /* ... */ ne mijenjaju izvođenje int value = 7; jedini redak stdouta 7 potvrđuje da se obrađuju kao komentari.

Primjeri

public class Main {
    public static void main(String[] args) {
        int value = 7; // this comment does not change the expression
        /* A block comment can span lines. */
        System.out.println(value);
    }
}

Rezultat

7

Komentari // i /* ... */ ne mijenjaju izvođenje int value = 7; jedini redak stdouta 7 potvrđuje da se obrađuju kao komentari.

Izvori