13. УГОЛОК ТЕОРИИ. Важность документирования программы. Оператор REM
Нет языка программирования, в котором не было бы возможности вставлять комментарии в код, и Basic — не исключение. Этот последний пункт главы не имеет отношения к графическому режиму; это средство, которое можно использовать в любом месте программы, работаем ли мы в текстовом и/или графическом режиме.
Речь идёт о команде
Rem — сокращение от Remark, что означает «комментарий».
Часто (слишком часто) не придаётся значения усилиям, направленным на повышение читаемости программ, причём не только для самого программиста, но, прежде всего, для других программистов. Есть несколько инструментов и привычек, повышающих читаемость, и один из них — команда Rem, позволяющая вставлять комментарии в программу.
Когда в программе встречается
Rem, при выполнении программа игнорирует всё, что написано в этой строке: это не исполняемый код, а комментарии, предназначенные для документирования программы для тех, кто её читает. Из этого следуют некоторые выводы:
- Строка с Rem никогда не вызовет ошибку: в ней можно писать что угодно.
- Строк с Rem может быть сколько угодно, ограничений нет.
Пример небольшой программы с несколькими блоками комментариев:
Первые две строки — комментарии с
Rem, поясняющие, что делает программа и кто её автор. Можно было бы прокомментировать и другое: дату создания и т. д.
У оператора Rem есть синонимы, например строки 3–7 начинаются с // — это ещё один допустимый способ вставить комментарий, очень похожий на язык C, где для комментариев используется тот же символ //.
Ниже мы видим строку, начинающуюся с одинарной кавычки ' — это ещё один допустимый способ сделать комментарий, но с ограничением: её можно ставить только в первой колонке строки, то есть в начале. Если поставить этот апостроф в любом другом месте, возникнет ошибка. Этот апостроф использовался в Pascal для комментариев, причём в любой позиции, даже в одной строке с кодом.
Наконец, знак решётки # также служит для начала комментария, и, как и ', его можно использовать только в начале строки.
Итак, есть четыре варианта Rem:
- Сам Rem
- Двойной «слэш» //
- Одинарная кавычка '
- Решётка #
Последние два — только в начале строки.
Пустые строки, разделяющие функциональные части программы, не являются комментариями, но тоже помогают сделать её более читаемой. Они не увеличивают размер итоговой программы и не наносят никакого вреда. Использовать и комментарии, и пустые строки — хорошая привычка программирования. Когда спустя месяцы вам придётся разбираться со своим собственным творением, вы будете благодарны.
Тот же самый код, но с двумя пустыми строками-разделителями. Эта программа очень мала, и, возможно, пустые строки не были необходимы, но это для примера.
Код: Выделить всё
Rem Programa para simular un dado
Rem Autor: Perico de los palotes
// Inicializamos Tecla$ a carácter nulo ""
// para que el bucle Repeat-Until se cumpla
// al menos una vez. Sería una casualidad,
// pero podría ocurrir que Tecla$ tuviese de
// partida el calor "esc" por no haberla
// inicializado.
Tecla$=""
Clear Screen
' Repite el siguiente ciclo hasta que pulsemos tecla Escape
Repeat
Numero = Int(Ran(6)) + 1
Print "El numero es: ",Numero
Print "Pulsa una tecla para otro numero"
Tecla$ = Inkey$
Until Tecla$ = "esc"
# Hemos salido del bucle Repeat-Until porque se ha pulsado Esc
Print
Print "Hasta luego!"
Wait(3)
Clear Screen
End
Первая пустая строка отделяет верхнюю часть программы (инициализацию) от основной части. Вторая пустая строка отделяет основную часть от завершающей части — окончания программы.
У вас нет необходимых прав для просмотра вложений в этом сообщении.
