Комментирование кода на схеме
Я просматриваю какой-то код в Scheme
из Festival
и не могу представить комментарии. В настоящее время я могу видеть ;
, ;;
и ;;;
, используемые для указания строк комментариев. Другие источники в Интернете показывают, что некоторые из вышеперечисленных способов могут указывать многострочные комментарии. Мои вопросы:
- В чем разница между
;
, ;;
и ;;;
для комментариев?
- Когда один из них используется другим?
- Есть ли другой, IMO saner, способ прокомментировать код в
Scheme
?
Ответы
Ответ 1
Символ комментария; и все, что после этого на линии будет проигнорировано. Разница визуальная. Я часто видел сингл; используется, если комментарий находится в строке с кодом;;; если комментарий находится по одной строке, и;;; если это какой-то заголовок. Самое важное в комментариях, вероятно, будет следовать любым соглашениям, которые вы видите в коде, с которым работаете.
Ответ 2
Все три формы, которые вы упоминаете, являются однострочными комментариями. Двойная точка с запятой, возможно, первоначально возникла как реплика в наборе наборов Dorai Sitaram SLaTeX, который должен был набираться как обычный текст, а не как текст программы.
В схеме также есть многострочные комментарии.
В частности, похоже, что R6RS, например Racket, позволяет использовать #|
и |#
для начала и завершения многострочных комментариев. Кроме того, совершенно великолепная комбинация #;
комментирует полное s-выражение. Так, например, если вы пишете
#;(define (terrible-function a)
(totally-broken-code
here))
Все определение считается закомментированным.