Соглашения о наименовании
Переменные
Именование переменных производится согласно стилю InfixCaps. Идентификатор переменной практически любого типа данных должен начинаться с заглавной буквы. Каждое последующее слово, входящее в идентификатор, необходимо начинать с заглавной буквы. Важно, чтобы имя переменной являлось существительным.
// ПРАВИЛЬНЫЕ идентификаторы переменных:
HashValues
ShapesList
MatrixRank
// НЕПРАВИЛЬНЫЕ идентификаторы переменных:
matrix_rank
ILOVECAPSSOMUCH
Примечание:
Использование имен переменных, не соответствующих их значению, допускается крайне редко. При объявлении переменных таких имен стоит избегать: это поможет избежать возможных сложностей при сопровождении программы.Идентификатор должен быть лаконичным и точным. Например, при использовании переменной-флага, сообщающей о состоянии вычислительного процесса или о результате проверки данных, не стоит использовать имена "Flag", "Stage" и подобные им. Названия вроде "RequestProcessed" или "IsRealNumber", семантическое значение которых понятно сразу, определенно лучше опишут реализуемый алгоритм.
Однобуквенные идентификаторы счетчиков циклов, как, например, i
, j
, k
могут быть представлены как в нижнем регистре, так и в верхнем. Счетчикам, по возможности, рекомендуется давать более осмысленные названия, а смешение стилей оформления подобных идентификаторов в одном проекте нежелательно.
Существует особенность именования переменных, являющихся аргументами функций и процедур. Если их объявление не является шаблонно сгенерированным средой разработки (как, например, при использовании обработчика события компонента из библиотеки VCL), первым символом идентификатора должна быть заглавная буква A
(от англ. "argument").