Пример додавања коментара у 15 програмских језика

Хајде да сазнамо шта су коментари и зашто су важни у програмирању.

Такође покривамо две уобичајене врсте коментара и како их написати на 15 различитих програмских језика.

Шта су коментари у програмирању?

Коментари у лаичком смислу су делови текста који неће бити видљиви крајњим корисницима и намењени су људима који пишу код.

Мало формалније, коментар је опис програма о томе како функционише у једноставном читљивом формату. Они се обично користе на местима где је потребно дати додатну јасноћу програмеру који чита код. Дакле, ово помаже у побољшању читљивости кода и смањује време и комуникацију који би били потребни за преношење знања.

Компајлер/интерпретер једноставно игнорише коментаре у вашем коду и на тај начин не утиче на крајњи излаз вашег програма. Дакле, укратко, коментари су као једноставно читљиво објашњење за одређене делове кода.

Уобичајене врсте коментара

Већина програмских језика подржава 2 врсте коментара.

  • Коментар у једном реду
  • Вишелинијски коментари / блок коментари

Као што име сугерише, коментари у једном реду су корисни када треба додати мали текст у једном реду, нпр. одређено стање, константна вредност којој је потребан мали опис. Док вишелинијски раде боље када имамо већу количину информација које треба додати, попут описа функције и начина на који се може користити, итд.

Постоје и неке друге врсте коментара попут коментара на документу, али то је ван оквира овог чланка.

  Који ВПН је прави за вас?

Зашто бисте додали коментаре?

„Свака будала може да напише код који компјутер може да разуме. Добри програмери пишу код који људи могу разумети.“ – Мартин Фаулер

Главна предност додавања коментара је побољшана читљивост и боље разумевање програма. Осим овога, неке друге предности укључују –

  • Коментари олакшавају вашим колегама, па чак и другим програмерима, да схвате логику без читања дугачке документације.
  • Смањена комуникација између програмера за мале недоумице
  • Компајлер/тумачи игноришу коментаре.
  • За софтвер отвореног кода, ово је неопходно јер нећете бити ту да објасните сваку функцију милионима програмера који желе да користе тај одређени програм.

Коментари на више језика

Сјајно, сада када смо сазнали о коментарима и зашто су корисни. Хајде да истражимо како можемо да додамо коментаре на различитим програмским језицима.

Коментар у једном реду

// This is a single line comment in C/C++

Вишелинијски коментар

/* This is slightly long
multi line comment in C/C++ */

Коментар у једном реду

# This is a single line comment in Python

Вишелинијски коментар

# This is slightly long
# multi line comment in Python

Коментар у једном реду

// This is a single line comment in Java

Вишелинијски коментар

/* This is slightly long
multi line comment in Java */

Коментар у једном реду

# This is a single line comment in Ruby

Вишелинијски коментар

=begin 
This is slightly long
multi line comment in Ruby
=end

Коментар у једном реду

// This is a single line comment in Golang

Вишелинијски коментар

/* This is slightly long
multi line comment in Golang */

Коментар у једном реду

– – This is a single line comment in Haskell

Вишелинијски коментар

{- This is slightly long
multi line comment in Haskell -}

Коментар у једном реду

// This is a single line comment in Rust

Вишелинијски коментар

/* This is slightly long
multi line comment in Rust */

Коментар у једном реду

<!--  This is a single line comment in HTML -->

Вишелинијски коментар

<!-- This is slightly long
multi line comment in HTML -->

Коментар у једном реду

/* This is a single line comment in CSS */

Вишелинијски коментар

/* This is slightly long
multi line comment in CSS */

Коментар у једном реду

// This is a single line comment in Javascript

Вишелинијски коментар

/* This is slightly long
multi line comment in Javascript */

Коментар у једном реду

# This is a single line comment in R programming language

Вишелинијски коментар

  Лоотие Фрее Мистери Бок Цодес: Искористите одмах

Р не подржава коментаре у више редова.

Коментар у једном реду

% This is a single line comment in Erlang

Вишелинијски коментар

Р не подржава коментаре у више редова.

Коментар у једном реду

// This is a single line comment in PHP

Вишелинијски коментар

/* This is slightly long
multi line comment in PHP */

Коментар у једном реду

# This is a single line comment in Perl

Вишелинијски коментар

=begin 
This is slightly long
multi line comment in Perl
=end

Коментар у једном реду

// This is a single line comment in Kotlin

Вишелинијски коментар

/* This is slightly long
multi line comment in Kotlin */

Закључак

Водич је покривао основе о коментарима и 2 уобичајена типа – једноредни и вишередни. Такође сам покушао да покријем зашто су коментари корисни и треба их писати када је потребно. Надам се да сте научили нешто ново!

Наставите да истражујете. Наставити са учењем! 👨‍💻