Komentarze Java: dlaczego i jak ich używać?

W tym samouczku dowiesz się o komentarzach Java, dlaczego ich używamy i jak używać komentarzy we właściwy sposób.

W programowaniu komputerowym komentarze są częścią programu, która jest całkowicie ignorowana przez kompilatory języka Java. Służą głównie do pomocy programistom w zrozumieniu kodu. Na przykład,

 // declare and initialize two variables int a =1; int b = 3; // print the output System.out.println("This is output"); 

Tutaj użyliśmy następujących komentarzy,

  • zadeklaruj i zainicjalizuj dwie zmienne
  • wydrukować wynik

Rodzaje komentarzy w Javie

W Javie istnieją dwa typy komentarzy:

  • komentarz jednowierszowy
  • komentarz wielowierszowy

Komentarz jednowierszowy

Komentarz jednowierszowy zaczyna się i kończy w tym samym wierszu. Aby napisać komentarz jednowierszowy, możemy użyć //symbolu. Na przykład,

 // "Hello, World!" program example class Main ( public static void main(String() args) ( ( // prints "Hello, World!" System.out.println("Hello, World!"); ) ) 

Wyjście :

 Witaj świecie! 

Tutaj użyliśmy dwóch jednowierszowych komentarzy:

  • "Witaj świecie!" przykład programu
  • wyświetla "Hello World!"

Kompilator Java ignoruje wszystko od //końca wiersza. Dlatego jest również znany jako komentarz końca wiersza .

Komentarz wielowierszowy

Kiedy chcemy pisać komentarze w wielu wierszach, możemy użyć komentarza wieloliniowego. Aby pisać komentarze wielowierszowe, możemy użyć symbolu / *…. * /. Na przykład,

 /* This is an example of multi-line comment. * The program prints "Hello, World!" to the standard output. */ class HelloWorld ( public static void main(String() args) ( ( System.out.println("Hello, World!"); ) ) 

Wyjście :

 Witaj świecie! 

Tutaj użyliśmy komentarza wielowierszowego:

 /* This is an example of multi-line comment. * The program prints "Hello, World!" to the standard output. */ 

Ten typ komentarza jest również nazywany komentarzem tradycyjnym . W tego typu komentarzach kompilator Java ignoruje wszystko od /*do */.

Używaj komentarzy we właściwy sposób

Należy zawsze wziąć pod uwagę, że komentarze nie powinny zastępować sposobu na wyjaśnienie źle napisanego kodu w języku angielskim. Zawsze powinieneś pisać dobrze zorganizowany i zrozumiały kod. A następnie użyj komentarzy.

Niektórzy uważają, że kod powinien być samoopisujący, a komentarze powinny być rzadko używane. Jednak moim zdaniem nie ma nic złego w używaniu komentarzy. Możemy użyć komentarzy, aby wyjaśnić złożone algorytmy, wyrażenia regularne lub scenariusze, w których musimy wybrać jedną technikę spośród różnych technik rozwiązywania problemów.

Uwaga : w większości przypadków zawsze używaj komentarzy, aby wyjaśnić „ dlaczego ”, a nie „ jak ”, i dobrze jest zacząć.

Interesujące artykuły...