Основы офисного программирования и язык VBA

       

Правила именования


Есть несколько простых правил, которые следует выполнять, чтобы быть цивилизованным программистом. Заметьте, можно быть умным, грамотным, но хорошо бы еще быть и цивилизованным. Многим из нас, я это отношу и к себе, не хватает цивилизации. Правила, о которых мы сейчас поговорим, касаются оформления текста программ. Большинство из них достаточно просто и по ходу дела мы о них неоднократно говорили. Вот основные:

  • Используйте комментарии.
  • Соблюдайте правила именования.
  • Структурируйте текст.
  • Стройте программы из модулей "подъемного" размера.

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

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

Разработчики от Microsoft рекомендуют придерживаться более строгих правил. Имя должно отражать не только смысл, но и тип переменной и ее область действия. Поэтому имя должно состоять из префикса и собственного имени. Префикс также является составным, две его части отражают область действия и тип переменной. В идущих ниже таблицах показаны возможные значения префикса:

Таблица 3.2. Префикс, задающий область действия

Первая часть префиксаОбласть действия
g Global - Весь проект
m Module - Для Private переменных модуля отсутствует
p Procedure - Для локальных переменных

Таблица 3.3. Префикс, задающий тип переменной

Вторая часть префиксаТип переменной
str String
int Integer
byt Byte
lng Long
sng Single
dbl Double
cur Currency
var Variant
obj Object
bln Boolean


Вот несколько примеров правильно построенных имен: gstrOneWord, mintNumberOne, strAnswer, curSalary. Также как по значению константы можно восстановить ее тип, по правильно построенным именам можно однозначно восстановить их объявление. Сделаем это в нашем примере:

Public gstrOneWord As String Private mintNumberOne As Integer Dim strAnswer As String Dim curSalary As Currency

Согласно этим же рекомендациям имена констант следует строить только из заглавных букв. Если имя константы состоит из нескольких слов, то для их объединения используется знак подчеркивания, например: MY_DIRECTORY_PATH. Обратите внимание, при построении констант Office 2000 используется префикс, указывающий, какому из приложений принадлежит константа.

Таблица 3.4. Префиксы констант Office 2000 ПриложениеПрефикс констант
Accessac
Excelxl
FrontPagefp
Officemso
OfficeBinderbind
Outlook ol
Power Point pp
Wordwd
VBAvb
Префиксы следует использовать и при именовании объектов, для форм обычно используется префикс frm, для командных кнопок - cmd и так далее. Следует понимать, что, если уж пользоваться префиксами, то обще употребительными, не следует заниматься самодеятельностью в этом вопросе. Мы закончим призывом, - "будьте цивилизованными".


Содержание раздела