Программирование на языке си ( с ) | C Sharp (Си шарп) с нуля. Сортировки | Массивы | Функции

Стили программирования — правильные и понятные имена переменных в си

Приходилось ли вам когда-нибудь:

  • использовать слишком сложную структуру данных?
  • долго искать ошибку, которую можно было исправить за минуту?
  • пытаться понять и разобрать чужую программу?
  • не понимать, что означает та или иная переменная или функция?
  • спустя некоторое время, переделывать программу полностью, так как забыли, что обозначал тот или иной кусок?

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

Главный принцип при написании кода - это простота и понятность: имена переменных должны быть правильные и понятные в языке си; каждые непонятные участки кода закомментированы таким образом, что б прочитав его, вы сразу уловили его суть; очевидная логика; писать программу нужно так, что б любой человек смог прочитать программу, т.е. нужно соблюдать стилевое единство; не нужно использовать различные хитрые трюки, которые многие просто не смогут понять.

   Имена переменных в си

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

Переменные глобального масштаба должны быть длинными, так как они могут использоваться в любом месте программы и всегда напоминать программисту о своем предназначении:

int npending = 0;

Функции, структуры, обобщения и классы так же должны иметь осмысленные имена, что б программист по названию мог определять назначение:

int lenString (char* str)
{
 ...
}

class Complex
{
   double x, y;
};

В си локальным переменным имена большой длины ни к чему:

int len;
char temp;

Мы совсем забыли про константы, а они играют отнюдь не последнюю роль. В языке Си константы принято писать полностью с заглавных букв:

#define SIZE 15

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

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

При копировании ( использовании ) материала размещайте ссылку на сайт www.mir-koda.ru