Оглавление
V2623. MISRA. Macro identifiers should be distinct.
Данное диагностическое правило основано на руководстве MISRA (Motor Industry Software Reliability Association) по разработке программного обеспечения.
Данное диагностическое правило актуально только для C. Имя макроса должно быть различимо от имён уже ранее определённых макросов. Также имя параметра макроса должно быть различимо как от имени самого макроса, так и от всех других параметров.
Минимальное требование по различимости имён макросов и их параметров зависит от версии стандарта:
- C90 — первый 31 символ.
- C99 — первые 63 символа.
В реальности компиляторы дают большие лимиты. Но правило требует, чтобы имена макросов были различимы в рамках ограничений, налагаемых стандартом.
Нижеперечисленные примеры будут касаться C90.
Пример некорректного кода с именем макроса:
// 1234567890123456789012345678901
#define average_winter_air_temperature_monday awt_m
#define average_winter_air_temperature_tuesday awt_tИмя первого макроса неотличимо от второго, если брать первые 31 символ. Корректный код:
// 1234567890123456789012345678901
#define average_winter_air_temp_monday awt_m
#define average_winter_air_temp_tuesday awt_tПример некорректного кода с неразличимыми именем макроса и его параметрами:
#define average_winter_air_temp(average_winter_air_temp) awt_mКорректный код:
#define average_winter_air_temp(winter_air_temp) awt_mПример некорректного кода с неразличимыми именами параметров макроса:
#define air_temp(winter_air_temp, winter_air_temp) awt_mКорректный код:
#define air_temp(average_winter_air_temp, winter_air_temp) awt_mДанная диагностика классифицируется как:
|
Была ли полезна эта страница документации?
