next up previous
Next: Объявления функций Up: style Previous: Однострочный комментарий

Объявления переменных

Глобальные объявления начинаются с первой колонки. Имена глобальных переменных должны начинаться с префикса 'g_'. Внешние переменные объявляются с квалификатором extern. При объявлении внешних массивов с фиксированным числом элементов их длина также указывается. Значения переменных, которые не будут изменять свое значение должны быть объявлены с квалификатором const. Имена должны отображать смысл переменной и явно отличаться друг от друга.
Например 1, I, l могут быть плохо отличимы.
/* Global debug flag. */
extern int g_debug;

Части имен переменных, составленных из нескольких слов разделяются символом '_'. Так как имена вида the_russian_olimpic_team_score читаются легче, чем имена вида therussianolimpicteamscore.

Названия макросов и констант определенных с помощью #define - в верхнем регистре. Все параметры макроса должны быть в скобках.

#define MAX_STRING_LEN  256
#define MAX( a, b ) ( ( a ) > ( b ) ? ( a ) : ( b ) )

Объявлять указатели следует так:

char *s, *t, *u;
вместо
char* s, t, u;
Группировать переменные на одной строке можно только в том случае, если они выполняют совершенно идентичные функции. Например - счетчики. По возможности каждое объявление должно быть прокомментировано.

Если начальное значение переменной важно, оно должно быть явно установлено:

    const double pi = 3.14159;



Aleks Sherikov 2006-06-01