|
1 | 1 | # Что такое комментарии и зачем они нужны? |
2 | 2 |
|
3 | | -Возможно вы заметили, что в листингах из примеров встречается не только код программ, но и мои пояснения написанные после `//`. Это =комментарии=. |
| 3 | +Возможно, вы заметили, что в листингах из примеров встречается не только код программ, но и мои пояснения, написанные после `//`. Это =комментарии=. |
4 | 4 |
|
5 | | -Комментарии предназначены для того, чтобы пояснять какую-нибудь сложную часть вашей программы или какой-нибудь неочевидный трюк. Кроме того, иногда их используют, чтобы на время отключить какую-то часть кода. Это возможно потому, что всё, что записано в комментарии, компилятор игнорирует. Если быть точнее процесс перевода программы с языка программирования на язык, понятный компьютеру, состоит из нескольких этапов. На одном из ранних этапов все комментарии из программы удаляются. Поэтому в комментариях можно писать всё что угодно, они никак не повлияют на итоговую программу. |
| 5 | +Комментарии предназначены для того, чтобы пояснять какую-нибудь сложную часть вашей программы или какой-нибудь неочевидный трюк. Кроме того, иногда их используют, чтобы на время отключить какую-то часть кода. Это возможно потому, что всё, что записано в комментарии, компилятор игнорирует. Если быть точнее, процесс перевода программы с языка программирования на язык, понятный компьютеру, состоит из нескольких этапов. На одном из самых ранних этапов все комментарии из программы удаляются. Поэтому в комментариях можно писать всё что угодно, они никак не повлияют на итоговую программу. |
6 | 6 |
|
7 | 7 |  |
8 | 8 |
|
9 | | -В языке Си есть два вида комментариев. Первый вид тот, который я использую в коде. Такой комментарий называют =однострочным комментарием=. Он действует с того момента как появился и до конца текущей строки. |
| 9 | +В программах на Си используются два вида комментариев. Первый вид тот, который я использую в коде. Такие комментарии =однострочнымм комментариями=. Однострочный комментарий действует с того момента как появился и до конца текущей строки. |
10 | 10 |
|
11 | | -Ещё есть =многострочный комментарий=. Начало такого комментария обозначается последовательностью `/*`, а конец -- `*/`. Всё, что будет записано между этими двумя последовательностями символов, будет проигнорировано компилятором. Обычно многострочные комментарии используют для описания больших кусков кода, очень сложных для понимания функций, документирования кода, указания авторства, указания на возможные проблемы в коде, исключения большого куска кода из программы и т.д. |
| 11 | +Ещё есть =многострочный комментарий=. Начало такого комментария обозначается последовательностью `/*`, а конец -- `*/`. Всё, что будет записано между этими двумя последовательностями символов, будет проигнорировано компилятором. Обычно многострочные комментарии используют для документирования кода, указания авторства, описания возможных проблем в коде, исключения большого куска кода из программы и т.д. |
12 | 12 |
|
13 | | -Вы спросите, а зачем нужно отключать куски кода программы? Иногда это нужно для того, чтобы найти ошибку в программе или проверить как работают отдельные её части. Если просто удалить код (или вырезать в буфер обмена), то потом его придётся писать заново, а так, закомментировал на время, а потом обратно раскомментировал, когда потребовалось. Когда вы начнёте писать более-менее большие программы, тогда вы воочию убедитесь в пользе этого подхода. |
| 13 | +Вы спросите, а зачем нужно исключать куски кода программы? Иногда это нужно для того, чтобы найти ошибку в программе или проверить как работают отдельные её части. Если просто удалить код (или вырезать в буфер обмена), то потом его придётся писать заново, а так, закомментировал на время, а потом обратно раскомментировал, когда потребовалось. Когда вы начнёте писать более-менее большие программы, тогда вы воочию убедитесь в пользе этого подхода. |
14 | 14 |
|
15 | | -Комментарии пишут программисты для программистов, которые в будущем будут читать/изменять этот код. Но даже если вы пишите код сугубо в личных целях, то не рекомендую вам брезговать оставлять комментарии. По прошествию нескольких месяцев бывает очень трудно вспомнить, что же ты тут такое делал и почему именно так делал, а не иначе. |
| 15 | +Комментарии пишут программисты для программистов, которые будут читать/изменять этот код в будущем. Но даже если вы пишите код сугубо в личных целях, то я всё равно рекомендую вам оставлять комментарии. По прошествию нескольких месяцев бывает очень трудно вспомнить, что же ты тут такое делал и почему делал именно так, а не иначе. |
16 | 16 |
|
17 | 17 | Комментарии в коде могут быть как очень смешными: |
18 | 18 |
|
|
0 commit comments