Соглашение об именовании
Соглашения об именованиях используются для облегчения чтения кода человеком и устранения конфликтов между разными частями программы. Особенно соглашение важно, когда ведется командная разработка.
Базовое соглашение об именовании в И++ предназначено для минимизации конфликтов идентификаторов, вводимых платформой и разработчиками программ И++.
Имена, начинающиеся с подчеркивания
Идентификаторы, начинающие с символа подчеркивания "_", не должны объявляться разработчиками в исходном тексте. Такие идентификаторы зарезервированы для использования платформой в своих целях. Например, при автоматической генерации исходных текстов редактором форм и объектом КАЛЬКУЛЯТОР.
Также идентификаторы, начинающие с символа подчеркивания, могут использоваться платформой при реализации типов времени выполнения. Это связано с тем, что имена потенциальных полей заранее неизвестны, а фиксированные поля не должны с ними конфликтовать. Например, фиксированное поле "_код" типа АНАЛИТИКА не будет конфликтовать с именами свойств, которые не начинаются с подчеркивания.
Объявления в модулях
Модули объявляют идентификаторы в соответствии со следующими правилами:
- В общем случае, имена объявляются всеми заглавными буквами, с использованием символа подчеркивания для разделения слов. Например, ДАТА_ТЕК.
- Поля объявляются всеми прописными буквами, с использованием символа подчеркивания для разделения слов. Например, ФОРМА.период_таймера.
- Интерфейсы объявляются всеми заглавными буквами, с использованием символа подчеркивания для разделения слов и приставки И_ в начале имени. Например, И_СТАТУС_СЕТЕВОЙ_ОПЕРАЦИИ.
- Синонимы контейнерых типов объявляются всеми заглавными буквами, с использованием символа подчеркивания для разделения слов и символа подчеркивания в конце имени. Если контейнерный тип ассоциирован с объектным типом, имя контейнерного типа образуется добавленим символа подчеркивания к имени объектного типа. Например, для объектного типа МАССИВ, тип его поля "эл" МАССИВ_.
- Синонимы типов функций объявляются всеми заглавными буквами, с использованием символа подчеркивания для разделения слов и символа подчеркивания в конце имени. Если тип функции используется для объявления поля, то его имя комбинируется из имени объектного типа и имени поля. Например, для поля ФОРМА.открытие синоним типа функции объявляется с именем ФОРМА_ОТКРЫТИЕ_.