О главе

Язык Си

chrns

«Си для встраиваемых систем»

Это онлайн версия книги «Си для встраиваемых систем». В печатном формате её можно приобрести у нас в магазине, а в виде файла epub/mobi/pdf на площадке LeanPub.

Прежде чем приступать к изучению синтаксиса языка, необходимо обратить внимание на то, как следует писать код. Он может быть как абсолютно непонятным, нечитаемым, так и выглядеть как «рассказ» — код, на который будет приятно смотреть, и происходящее там будет ясно не только разработчику, но и другим людям. Читаемость кода — очень важная вещь. Если вы, находясь в контексте задачи, напишете что-то такое:

for (int i = 0; i < n; i++) if (k % 2 == 0) a++; else b++;

то какова вероятность того, что вы поймете, что делает этот код, месяц спустя? А что насчет вашего коллеги, которому придется доделывать ваш проект? Такой код следует привести к более читаемому виду.

for (int month = 0; month < latest_month; month++) {
    if (month % 2 == 0)
        even_month++;
    else
        odd_month++;
}

Переменным стоит давать понятные и осмысленные названия. В таком случае разъяснять в комментариях сам код даже не придется. Другой очевидный совет — нужно соблюдать общепринятое (или принятое в компании) форматирование кода. Хорошим примером стиля написания для языка С++ является Code Style Guide от компании Google.


Изменено: