Соглашения о наименовании

Переменные

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

// ПРАВИЛЬНЫЕ идентификаторы переменных:

  HashValues
  ShapesList
  MatrixRank
// НЕПРАВИЛЬНЫЕ идентификаторы переменных:

  matrix_rank
  ILOVECAPSSOMUCH

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

Идентификатор должен быть лаконичным и точным. Например, при использовании переменной-флага, сообщающей о состоянии вычислительного процесса или о результате проверки данных, не стоит использовать имена "Flag", "Stage" и подобные им. Названия вроде "RequestProcessed" или "IsRealNumber", семантическое значение которых понятно сразу, определенно лучше опишут реализуемый алгоритм.

Однобуквенные идентификаторы счетчиков циклов, как, например, i, j, k могут быть представлены как в нижнем регистре, так и в верхнем. Счетчикам, по возможности, рекомендуется давать более осмысленные названия, а смешение стилей оформления подобных идентификаторов в одном проекте нежелательно.

Существует особенность именования переменных, являющихся аргументами функций и процедур. Если их объявление не является шаблонно сгенерированным средой разработки (как, например, при использовании обработчика события компонента из библиотеки VCL), первым символом идентификатора должна быть заглавная буква A (от англ. "argument").

results matching ""

    No results matching ""