Идентификаторы

Приведем правила записи идентификаторов.

! Длина идентификатора 1...32 символа.

! Разрешается использовать любые русские и латинские буквы, цифры, точку и, возможно, специальные символы.

! Первый символ должен быть буквой (не цифрой и не точкой).

! Внутри идентификатора запрещается использовать пробелы.

! Слова следует разделять точками, чтобы облегчить чтение.

! Запрещается использовать сокращение слов, если длина идентификатора меньше 32 символов.

! Если длина идентификатора больше 32 символов, надо заменить некоторые слова сокращениями или уменьшить число слов.

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

Примеры правильных идентификаторов

Номер.вагона.скорого.поезда
Номер.вагона.пассажир.поезда
Цена.билета.поездом.до.Магадана
Цена.билета.самолет.до.Магадана

Примеры неправильных идентификаторов

Номер.вагона.пассажирского.поезда (здесь 33 символа,
а можно не более 32)

Число.вагонов товарного поезда (используются пробелы)

3-й.запуск.аварийного.насоса (здесь две ошибки:
первый символ — цифра;
кроме того, есть дефис)

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

Предположим, нужно создать идентификатор для следующего понятия: “Радиус-вектор центра Земли в центре взлетно-посадочной полосы в посадочной системе координат”. Словесное описание понятия содержит 92 символа. Задача состоит в том, чтобы сократить 92-символьное описание до 32-символьного, сохранив по возможности ясный смысл понятия.

Сокращение проведем по следующему плану:

! “Радиус-вектор центра Земли” заменим на “Радиус.земли”.

! Вместо “В центре взлетно-посадочной полосы” напишем “на.полосе”.

! “В посадочной системе координат” заменим на ПСК, поскольку такое сокращение является общеупотребительным в коллективе разработчиков данной системы.

В итоге получим 26-символьный идентификатор

который сохраняет почти все опорные слова исходного понятия и обеспечивает довольно высокую понимаемость.

Правила записи арифметических выражений
в операторах присваивания

Следует различать два случая. Если выражение простое, рекомендуется использовать 32-символьные идентификаторы и “вертикальную” запись математических формул, как показано на рис. 94 и 95.

Однако если речь идет о сложных математических вычислениях, описанный способ не годится, поскольку “вертикальные” формулы с 32-символьными идентификаторами не позволяют читателю увидеть математическую структуру вычислений, отвлекая его внимание на чтение длинных идентификаторов, которые парадоксальным образом превращаются из полезной подсказки в свою противоположность и начинают играть негативную роль визуальной помехи. Таким образом, возникает эргономический тупик: короткие идентификаторы не позволяют быстро уяснить смысл понятий, а длинные — затемняют структуру сложных формул.

В качестве одного из возможных подходов к развязыванию этого гордиева узла можно предложить план из трех пунктов.

! Для каждого математического понятия предусматриваются два идентификатора: длинный (32-символьный) и короткий (алиас).

! В арифметических выражениях используются только алиасы, что делает структуру формул прозрачной.

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

Дата добавления: 2015-08-21