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

/ ! \ Небольшое предупреждение: существует множество способов именования объектов, переменных и т. д., и это также во многом зависит от языка. Я буду говорить только о методах именования C и C++, потому что не хочу делать это слишком длинным, чтобы новички могли попробовать и применить их при изучении C или C++. Начнем!

NB: Эти правила могут быть нарушены, если вы категорически не согласны с одним из них или если это повышает читабельность в определенных случаях.

ПЕРЕМЕННЫЕ

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

Правила :
- Должны быть смешаны строчные и прописные буквы, начиная со строчной буквы, не со специального символа, не с цифры и должны быть строчными
- Слова начинаются с заглавными буквами и не разделены символом подчеркивания «_»
- Переменные с большой областью действия должны иметь длинные имена, а переменные с короткой областью действия должны иметь короткие имена
- Переменные итератора должны называться i, j, k, …
— переменная закрытого класса должна заканчиваться символом «_».

Префиксы и суффиксы:
– префикс _n_ следует использовать для переменных, представляющих количество объектов
– суффикс _No_ следует использовать для переменных, представляющих номер объекта
– следует использовать префикс _is_ для логических переменных и методов
— следует избегать префикса «p» для указателей (и вообще следует избегать конкретных имен для указателей)

КОНСТАНТЫ
- Все прописные буквы и слова разделяются символом подчеркивания «_»

ФУНКЦИИ

Правильно называть функции ОЧЕНЬ важно, потому что понять назначение сложной функции намного сложнее, чем понять назначение простой переменной. Более того, когда вам придется повторно использовать функцию, которую вы написали давным-давно, вы поблагодарите себя за правильное название (и не забудьте прокомментировать свой код!).

Правила :
- Должны быть глаголы
- Должен быть смешанный регистр, начинающийся со строчной буквы
- Должна быть определенная логика и последовательность: например. все функции, которые принимают ввод от пользователя, начинаются с «получить», и между «получить», «ввод» и «спросить» нет смеси. Выберите один и придерживайтесь его.

ОБЩИЕ
 – Аббревиатуры, содержащиеся в именах, не должны быть в верхнем регистре, это может привести к путанице.

ПОСЛЕДНЕЕ ПРАВИЛО: ВСЕ ДОЛЖНО БЫТЬ НАПИСАНО НА АНГЛИЙСКОМ ЯЗЫКЕ

Кажется, я перечислил все самые основные правила именования вещей в C и C++. Очевидно, что существует гораздо больше правил и передовых практик, которые вы можете применить, чтобы улучшить читаемость вашего кода, особенно при работе с классами и другими, более сложными понятиями кодирования, особенно на C++. Я знаю, что это было очень коротко, но цель здесь не в том, чтобы сделать ваш код идеальным, а просто в том, чтобы сделать его немного более читабельным.

Спасибо за прочтение, надеюсь, вам понравилось!
Получайте удовольствие от программирования!