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

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

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

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

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

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

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

Обработка массивов

На рис. 94 и 95 даны примеры программ, в которых имеются операции с массивами.

Описание данных размещается на нижнем этаже иконы “полка”.

Запись

МАССИВ ВЕЩ Вес.кролика [100]

означает, что задан одномерный массив с именем “Вес.кролика”, содержащий 100 элементов, каждый из которых является вещественным числом.

О

от k= 1 до 100

сновным элементом обеих программ служит циклДЛЯ. Рассмотрим правила оформления цикла. В иконе “начало циклаДЛЯ” в верхней строке пишут слово “Цикл” и после пробела односимвольный алиас, обозначающий переменную цикла (букваkна рис. 94, 95). В нижней строке указывают диапазон ее изменения, например,

Но что обозначает буква k? Каков физический смысл переменнойцикла в данной прикладной программе? Авторы многих программ забывают (или не считают нужным) ответить на этот вопрос, в результате чего программа нередко превращается в ребус. Чтобы этого не случилось, в средней строке следует написать формализованный комментарий, например

k ≡ Номер.кроличьей.клетки

Знак тождественного равенства ≡ показывает, что после него следует имя-комментарий, т. е. комментарий, который пишется по правилам записи идентификаторов.

Эргономический “навар” формализованного комментария включает два преимущества. Во-первых, он позволяет устранить традиционную “забывчивость” программистов и по-человечески объяснить читателю смысл абстрактного идентификатора: дескать, k — это номер кроличьей клетки. Во-вторых, что немаловажно, объяснение размещается на поле чертежа именно там, где нужно (в иконе “начало циклаДЛЯ”), по принципу “дорого яичко ко Христову дню”. Это значит, что читатель получает ответ моментально — в ту самую секунду, когда он впервые увидел алиас k и в его голове забрезжил вопрос: а что такоеk?

В иконе “конец цикла ДЛЯ” делают запись

Конец цикла <переменная цикла>

Смысл операторов, организующих обработку массивов, ясен из рис. 94 и 95 и не требует пояснений.