10.9. Структура текста программы и комментарии

По ходу выполнения проекта неоднократно придется возвращаться к ранее написанным программам, чтобы проверять и изменять их.

Поэтому каждая программа должна быть написана таким образом, чтобы в ней легко можно было находить (причем не только ее создателю, но и другим программистам) места, в которые требуется внести те или иные изменения. Иначе говоря, текст программы должен быть написан максимально понятно для любого человека, которому впоследствии потребуется в ней разобраться, включая и самого ее автора. Эту мысль можно выразить более кратко — ваша программа должна быть "читабельна".

При написании программы надо взять за правило: для в з а и м о с в я з а н н ы х по с м ы с л у операторов использовать о д и н а к о в ы е отступы.

Приведём пример такого написания и использования комментариев:

Do ' Начало общего цикла программы

Switch = False

For i = 1 to m ' Цикл по заданному количеству циклов

If b(i) > b(i+1) then ' оператор сравнения i-го и i+1 члена

bam = b(i)

b(i) = b(i + 1)

b(i + 1) = bam

Switch = true

End if ' конец оператора сравнения

Next i ' переход к новому циклу с увеличением i

Loop ' конец общего цикла программы

Рис. 10.5. Пример правильной записи фрагмента программы с выделением операторов, принадлежащих одной группе

Здесь ярко видно, что операторы внутри конструкции If ... Then ... End If — это операторы одной группы: для них установлен один и тот же отступ. Поскольку в данной программе оператор switch = False (switch – переключатель) и структура For ... Next выполняется при каждом проходе структуры Do ... Loop, то у них другой отступ.

Это позволяет с первого взгляда четко определять саму структуру и содержащиеся в ней подчиненные операторы. Для добавления отступа в строке можно использовать клавишу пробела или клавишу <ТаЬ>.

При работе с программой также очень удобно использовать комментарии — текст, предназначенный для человека и не являющийся программным кодом и потому игнорируемый компилятором. Внесение в текст программы комментариев, словесно описывающих выполняемые в ней действия, является хорошей практикой.

В языке VBA комментарии записываются после символа апострофа «'», который можно поместить в любом месте строки (см. вышеприведённый пример программы). При этом все символы после апострофа (и до конца строки) будут восприниматься как комментарии!

Комментарии можно размещать на отдельных строках или ставить их после операторов программы. Очень важно применять комментарии при написании сложных программ, смысл которых со временем может стать непонятным. В каждой строке желательно кратко пояснять, что и как делает данная программа. Это поможет вам при отладке программы, а также при добавлении в нее новых фрагментов, когда требуется четко знать, в какой процедуре и в какое ее место следует поместить новый фрагмент.

Поскольку каждая написанная процедура может использоваться многократно, для удобства ее дальнейшего применения целесообразно в начало каждой процедуры помещать комментарии, описывающие назначение и способ использования этой процедуры. Эти же рекомендации справедливы и в отношении комментариев, помещаемых в начало модулей. Комментарии также можно использовать для описания назначения переменных.

Вот рекомендации по использованию комментариев, которые могут помочь любому:

• будьте по возможности кратки;

• грамотно составляйте предложения;

• старайтесь писать ясно и понятно;

• умеренно используйте знаки пунктуации.

• обязательно поясняйте аргументы, передаваемые между процедурами;

• отмечайте версии фрагментов программы — когда, как и зачем выполнялись изменения;

• пишите комментарии параллельно вводу текста программы, пока суть задачи еще свежа в памяти.

Тестовые задания

Ниже размещено несколько тестовых заданий. В каждом задании предлагается вопрос и несколько вариантов ответа на него, один (или несколько) из которых является правильным, а остальные — нет. Укажите правильный(е) ответ(ы).

№ п/п	Вопросы	Предлагаемые ответы
1	В языке VBA тип данных определяет следующие характеристики некоторого элемента информации:	а) назначение элемента и смысл сохраняемой в нем информации б) способ представления в памяти в) скорость выполнения операций г) набор допустимых операций д) категорию информации и ее владельца
2	Язык VBA поддерживает следующие типы числовых данных:	а) размеры в метрических и дюймовых единицах измерения; б) целочисленные; в) дата и время; г) количественные; д) с плавающей точкой е) комплексные
3	Язык VBA поддерживает следующие типы нечисловых данных:	а) строки символов фиксированной и произвольной длины б) текстовые в) графические г) логические д) валюты
4	Массивы в языке VBA могут быть следующих типов:	а) линейные и плоские б) одномерные в) статические г) переменной длины д) циклические
5	Комментарии в программу помещаются для следующих целей:	а) для повышения читабельности кода; б) для пояснения смысла выполняемых действий; в) для защиты авторских прав; г) для описания назначения переменных и функций.