CERT C: правило PRE32-C

Не используйте директивы препроцессору в вызовах подобных функции макросов

Описание

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

Не используйте директивы препроцессору в вызовах подобных функции макросов. [1]

Примеры

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

Описание

Директива препроцессору в макро-аргументе происходит, когда вы используете директиву препроцессору в аргументе к подобному функции макросу или функции, которая может быть реализована как подобный функции макрос.

Например, оператор #ifdef происходит в аргументе с функцией memcpy. memcpy функциональная сила быть реализованным как макрос.

memcpy(dest, src,
    #ifdef PLATFORM1
      12
    #else
      24
    #endif
  );
Средство проверки отмечает подобное использование в printf и assert, который может также быть реализован как макросы.

Риск

Во время предварительной обработки подобный функции макро-вызов заменяется макро-телом, и параметры заменяются аргументами к макро-вызову (замена аргумента). Предположим, что макро-min() задан можно следующим образом.

#define min(X, Y)  ((X) < (Y) ? (X) : (Y))
Когда вы вызываете min(1,2), он заменяется телом ((X) < (Y) ? (X) : (Y)). X и Y заменяются 1 и 2.

Согласно Стандарту C11 (Секунда. 6.10.3), если список аргументов к самому подобному функции макросу имеет директивы предварительной обработки, замена аргумента во время предварительной обработки не определена.

Фиксация

Чтобы гарантировать, что замена аргумента происходит однозначным способом, используйте директивы препроцессору вне подобного функции макроса.

Например, чтобы выполнить memcpy с различными аргументами на основе директивы #ifdef, вызовите memcpy многократно в рамках направляющих ответвлений #ifdef.

#ifdef PLATFORM1
    memcpy(dest, src, 12);
#else
    memcpy(dest, src, 24);
#endif

Пример - директивы в Подобных Функции макросах

#include <stdio.h>

#define print(A) printf(#A)

void func(void) {
    print(
#ifdef SW
          "Message 1"
#else
          "Message 2"
#endif
         );
}

В этом примере директивы препроцессору #ifdef и #endif происходят в аргументе с подобным функции макро-print().

Исправление — директивы использования вне макроса

Одно возможное исправление должно использовать подобный функции макрос многократно в ответвлениях директивы #ifdef.

#include <stdio.h>

#define print(A) printf(#A)

void func(void) {
#ifdef SW
        print("Message 1");
#else  
        print("Message 2");
#endif 
}

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

Группа: правило 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". УНИВЕРСИТЕТ КАРНЕГИ-МЕЛЛОН НЕ ДАЕТ ГАРАНТИЙ НИКАКОГО ВИДА, ИЛИ ВЫРАЗИЛ ИЛИ ПОДРАЗУМЕВАЛ, ОТНОСИТЕЛЬНО ЛЮБОГО ВОПРОСА ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИЛ, ГАРАНТИЯ ПРИГОДНОСТИ ДЛЯ ЦЕЛИ ИЛИ ВЫСОКОГО СПРОСА, ИСКЛЮЧИТЕЛЬНОСТИ, ИЛИ ЗАКАНЧИВАЕТСЯ ПОЛУЧЕННЫЙ ИЗ ИСПОЛЬЗОВАНИЯ МАТЕРИАЛА. УНИВЕРСИТЕТ КАРНЕГИ-МЕЛЛОН НЕ ДАЕТ ГАРАНТИИ НИКАКОГО ВИДА ОТНОСИТЕЛЬНО СВОБОДЫ ОТ ПАТЕНТА, ТОВАРНОГО ЗНАКА ИЛИ НАРУШЕНИЯ АВТОРСКОГО ПРАВА.

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