Компилятор ccblkfn определяет макросы, предоставляющие информацию о компиляторе, исходном файле и указанных опциях командной строки (predefined macros). Эти макросы могут проверяться с помощью директивы #ifdef и других подобных, чтобы управлять процессом компиляции программы. Что-то подобное делается определением макросов в системных заголовочных файлах.

Примечание: кроме предопределенных макросов, также есть предопределенные утверждения (Predefined Assertions), см. врезку ниже.

#assert name(value)

#if #name(value)
   // какие-то действия
   ...

#else 
   // какие-то другие действия
   ...

#endif

#if #machine(adspblkfn)
   // какие-то действия
   ...

#endif

Макросы, такие как __DATE__, могут быть полезны при встраивании в текстовые строки. Оператор # в теле макроса полезен для преобразования таких символов в текстовые конструкции.

В таблице 1-41 описываются предопределенные макросы, которые создает компилятор ccblkfn. Многие опции зависят от опций командной строки компилятора, см. [2].

Таблица 1-41. Predefined Compiler Macros.

[Написание макросов препроцессора]

#define имя блок_текста

Макрос это определенное пользователем имя или строка, вместо которой препроцессор подставляет определенный пользователем блок текста. Для создания макроса используется команда препроцессора #define препроцессора. Когда определение макроса имеет аргументы, препроцессор модифицирует создаваемый блок текста, подставляя аргументы макроса.

Составные макросы. Составным макросом (Compound Macro) называют макрос, который состоит из нескольких строк. Продолжение макроса в следующей строке обеспечивается обратным слешем (\) в конце строки. Составной макрос может работать так же, как встроенная (inline) функция.

#define имя строка1  \

            строка2  \

            строка3

Замечание: при любой возможности используйте inline-функции (встраиваемые функции) вместо составных макросов. Если все-таки составной макрос необходим, определяйте составной макрос так, чтобы его можно было использовать наподобие вызовов функции. Это делает исходный код проще для чтения и поддержки.

Ниже в качестве примера определены две версии составного макроса SKIP_SPACES.

Вариант 1:

/* SKIP_SPACES, обычная реализация составного макроса *

/#define SKIP_SPACES(p, limit)  {    \

   char *lim = (limit);             \

      while (p != lim)            { \

         if (*(p)++ != ' ')       { \

            (p)--;                  \

            break;                  \

         }                          \

   }                                \

}

Вариант 2:

/* SKIP_SPACES, "закрытый" макрос *

/#define SKIP_SPACES(p, limit)   \

   do {                         \

      char *lim = (limit);      \

      while ((p) != lim)      { \

         if (*(p)++ != ' ')   { \

            (p)--;              \

            break;              \

         }                      \

      }                         \

   } while (0)

Во втором варианте тело макроса обрамлено однопроходным циклом do {...} while (0), что превращает его в один оператор, когда он обработан препроцессором. Первый вариант, в отличие от второго варианта, препроцессор разворачивает в составной оператор. С макросом, который разворачивается в составной оператор, Вы иногда можете пропустить точку с запятой после вызова макроса, и компилятор ничего не заметит, получится допустимая программа. Это приводит к необходимости помнить, что конкретно используется - функция или макрос, и нужна ли для макроса завершающая точка с запятой, или нет. Конструкция с обрамлением do {...} while (0) лишена такого недостатка, макрос можно считать функцией, и завершать его вызов точкой с запятой.

Например:

/* SKIP_SPACES, закрытый макрос, заканчивается без ';' */

if (*p != 0)
   SKIP_SPACES (p, lim);

else ...

Этот макрос развернется в следующий код:

if (*p != 0)
   do {
      ...
   } while (0);

else ...

Без конструкции do {...} while (0) преобразование макроса было бы таким:

if (*p != 0)
   {
      ...
   };  /* Скорее всего это совсем не то, что нужно было получить... */

else

[Ссылки]

1. VisualDSP++: использование предварительно определенных макросов препроцессора.
2. Опции командной строки компилятора Blackfin.