CERT C: Rec. PRE01-C

Используйте круглые скобки в макросах вокруг названий параметра

Описание

Управляйте определением

Используйте круглые скобки в макросах вокруг параметра names.[1]

Реализация Polyspace

Это средство проверки проверяет на Макро-параметры, не заключенные в круглые скобки.

Примеры

развернуть все

Проблема

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

Если макро-параметр не содержит выражение, то круглые скобки не необходимы.

Риск

Если вы не заключаете макро-параметры, содержащие выражения в круглых скобках, когда замена параметра происходит, приоритет оператора не может дать результаты, которые вы хотите.

Фиксация

Если макро-параметр содержит выражение, заключите параметр в круглую скобку в макроопределении или макро-использовании.

Пример - макро-выражения
#define mac1(x, y) (x * y)
#define mac2(x, y) ((x) * (y))

void foo(void){
    int r;

    r = mac1(1 + 2, 3 + 4);       /* Non-compliant */
    r = mac1((1 + 2), (3 + 4));   /* Compliant */

    r = mac2(1 + 2, 3 + 4);       /* Compliant */
}

В этом примере, mac1 и mac2 макросы, которые, по-видимому, реализуют то же определение.

  • Определение mac1 не заключает макро-параметры в круглые скобки. В несовместимом выражении макрос расширяется до r = (1 + 2 * 3 + 4); Намеченным выражением может быть (1 + (2 * 3) + 4) или (1 + 2) * (3 + 4). Однако без круглых скобок, разработчик или рецензент кода не могут знать намерение выражения. Последующее совместимое выражение заключает макро-параметры в круглые скобки, таким образом, намеченным макрорасширением является ясно (1 + 2) * (3 + 4).

  • Определение mac2 заключает параметры в круглые скобки. Выражение, включающее mac2 расширяется до (1 + 2) * (3 + 4) и выполняет правило.

Проверяйте информацию

Группа: Rec. 01. Препроцессор (PRE)
Введенный в R2019a

[1]  Это программное обеспечение было создано MathWorks, включающим фрагменты: “Веб-сайт SEI CERT-C”, © 2017 Carnegie Mellon University, веб-сайт SEI CERT-C © 2017 Carnegie Mellon University”, CERT SEI C Кодирование Стандарта – Правил для Разработки безопасных, Надежных и Защищенных систем – 2 016 Выпусков”, © 2016 Carnegie Mellon University, and “CERT SEI Стандарт Кодирования C++ – Правил для Разработки безопасных, Надежных и Защищенных систем на C++ – 2 016 Выпусков” © 2016 Carnegie Mellon University, со специальным разрешением от его Института программной инженерии.

ЛЮБОЙ МАТЕРИАЛ УНИВЕРСИТЕТА КАРНЕГИ-МЕЛЛОН И/ИЛИ ЕГО ИНСТИТУТА ПРОГРАММНОЙ ИНЖЕНЕРИИ СОДЕРЖАЛ, ЗДЕСЬ ПРЕДОСТАВЛЯЕТСЯ НА БАЗИСЕ "ASIS". УНИВЕРСИТЕТ КАРНЕГИ-МЕЛЛОН НЕ ДАЕТ ГАРАНТИЙ НИКАКОГО ВИДА, ИЛИ ОПИСАЛ ИЛИ ПОДРАЗУМЕВАЛ, ОТНОСИТЕЛЬНО ЛЮБОГО ВОПРОСА ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИЛ, ГАРАНТИЯ ПРИГОДНОСТИ ДЛЯ ЦЕЛИ ИЛИ ВЫСОКОГО СПРОСА, ИСКЛЮЧИТЕЛЬНОСТИ, ИЛИ ЗАКАНЧИВАЕТСЯ ПОЛУЧЕННЫЙ ИЗ ИСПОЛЬЗОВАНИЯ МАТЕРИАЛА. УНИВЕРСИТЕТ КАРНЕГИ-МЕЛЛОН НЕ ДАЕТ ГАРАНТИИ НИКАКОГО ВИДА ОТНОСИТЕЛЬНО СВОБОДЫ ОТ ПАТЕНТА, ТОВАРНОГО ЗНАКА ИЛИ НАРУШЕНИЯ АВТОРСКОГО ПРАВА.

Это программное обеспечение и сопоставленная документация не были рассмотрены, ни являются подтвержденным Университетом Карнеги-Меллон или его Институтом программной инженерии.