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
commentsJava 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.