CERT C: Rule PRE32-C

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

Описание

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

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

Реализация Polyspace

Это средство проверки проверяет на Директиву препроцессору в макро-аргументе.

Примеры

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

Проблема

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

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

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