Основы программирования на языке Turbo Pascal. Беляева И.В. - 102 стр.

UptoLike

Составители:

Рубрика:

102

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

функции, глобальные переменные, глобальные константы, модули, имена

программ, имена файлов и т.п. – обязательно должны быть достаточно

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

имя, тем больше оно должно содержать символов.

Локальные имена должны быть осмысленными. Существует ряд имен,

использование которых общепринято: счетчики цикла – i, j, k …, сумма – s

(или sum), координаты – x, y и т.п. Для переменных нестандартных нужны

понятные «мнемонические» имена – например, имя isDifferent (является

отличным) из последнего примера.

Необходимо избегать как коротких, так и длинных непонятных имен,

типа: w, t, gg, h123, m22, DlinnoeMnemonicheskoeImia01,

DlinnoeMnemonicheskoeImia02...

Правила написания комментариев в тексте программы

Комментарии следует писать:

При объявлении пользовательских типов данных каждый тип

поясняется отдельно.

При объявлении глобальных переменных каждая переменная

комментируется отдельно.

При объявлении глобальных констант – по мере надобности.

При определении процедур и функций – перед каждой процедурой и

функцией. При этом указывается назначение подпрограммы, получаемые

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

«Нестандартные» локальные переменные – по мере надобности.

Сложные места в программе – сложные алгоритмы или какие-то

программистские хитрости.