Интерфейсы периферийных устройств. Ключев А.О - 279 стр.

UptoLike

ВУЗ: 

Университет ИТМО | Санкт-Петербург

Составители: 

Рубрика: 

278
Приложение Г. Требования к оформлению программ на
языке Си
Г.1 Соглашения по идентификаторам
Г.1.1 Подбор идентификаторов
А. Все идентификаторы должны выбираться из соображений читаемости и
максимальной семантической нагрузки.
Например:
const float Eps = 0.0001; // точность
unsigned short Sum; // сумма
unsigned char Message[ 20 ]; // сообщение
Неудачными можно считать идентификаторы:
const float UU = 0.0001; // точность
unsigned short Kk; // сумма
unsigned char Zz[ 20 ]; // сообщение
Б. Идентификаторы рекомендуется подбирать из слов английского языка.
Например:
// выдает звуковой сигнал заданной частоты и длительности
void Beep( unsigned short Hertz, unsigned short MSec );
// выдает True (1), если файл с именем FName существует
unsigned char ExistFile( unsigned char* FName );
// признак окончания работы с программой
unsigned char Done;
// размеры изделия (ширина, высота)
unsigned short Width, Height;
Не очень удачными можно считать идентификаторы:
// выдает звуковой сигнал заданной частоты и длительности
void Zvuk(unsigned short Chast, unsigned short Dlit );
// выдает True (1), если файл с именем Im существует
unsigned char EstFile(unsigned char* Im );
// признак окончания работы с программой
unsigned char Konec;
// размеры изделия (ширина, высота)
unsigned short Shirina, Vysota;
Г.1.2 Написание идентификаторов
Существует два основных способа написания идентификаторов.
А. В любых идентификаторах каждое слово, входящее в идентификатор,
писать, начиная с большой буквы, остальные буквы – маленькие.
Например:
float NextX, LastX; // следующая и предыдущая итерация
char BeepOnError; // подавать ли звуковой сигнал при
// неправильном вводе пользователя?
unsigned char FileName[ 20 ];
// стандартная функция модуля Graph; выдает описание

Страницы