OpenSCADAWiki : Roman Savochenko / C Short All / part 1 / part 8

1.8 Препроцессор

Препроцессор это часть языка С. Препроцессор считывает исходный код, отвечает на размещенные в нем директивы и производит модифицированную версию этого исходного кода, которая передаётся компилятору. Подстановки препроцессором выполняются рекурсивно, т.е выполняется многопроходная обработка.

Определение/удаление макроса. Макрос может быть определён без значения и может использоваться в качестве проверяемого флага.


#define VAL_T 345
 #undef VAL_T
 #define VAL_T 234

Для перевода на другую строку используется ";\" :


#define FILLSCREAN(color) _AX = 0x0600;\
                           _CX = 0x0000;\
                           _DX = 0x184f;\
                           _BH = color;\
                           geninterrupt(0x10);

Использование параметров:


#define min(a,b) ((a) < (b) ? (a) : (b))
 result = min(44,uplimit);   
 // result = ((44) < (uplimit) ? (44) : (uplimit));

Для объединения формальных параметров используются символы ##:


#define var( i , j ) ( i##j )   // var( x , 6 ) = x6

Для преобразования фактического параметра в строку используется символ # который помещается перед формальным макропараметром:


#define TRACE(flag) printf(#flag "=%d\n", flag)

Вариантный макрос (...):


#define err(...) fprintf(stderr,__VA_ARGS__)
 err("%s %d\n","The error code ",48); 
 // fprintf(stderr,"%s %d\n","The error code ",48);

 #define errout(a,b,...) \
     fprintf(stderr,"File %s  Line %d\n",a,b); \
     fprintf(stderr,__VA_ARGS__)
 errout(__FILE__,__LINE__,"Unexpected termination\n");

1.8.1 Директивы Препроцессора

_Pragma
_Pragma(«GCC poison printf»)
Оператор для вызова прагмы из тела макроса (табл.7).

#define
#define ident ident1;
Заменяет все последующие определения <ident> на лексему <ident1> (совокупность лексем).

#elif, #if
#if expresion
#elif expresion1
#endif
Проверяет выражение <expresion>, связанное с директивами #if, или #elif, если выражение истинно (отличный от нуля), то выполняются следующие строки до директив условия или конца условий. Директива #elif является объединением директив #else и #if. Если имеется #else, то нижестоящие строки выполняются когда выражение в #if или #elif имеет нулевое значение. Нельзя использовать в качестве условия оператор sizeof, составные типы, float или enum типы.

defined
#if defined(VAR)
#elif !defined(NVAR)
#endif
Оператор проверки определённости, используется в паре с #if.

#else
Нижестоящие строки выполняются если выражение в #if, #ifdef, #ifndef или #elif имеет нулевое значение.

#endif
Указывает на конец условия.

#error
#error сообщение
Генерация сообщения ошибки на stderr и завершения процесса компиляции.

#ifdef
#ifdef <identifier>
Выполняет последующие строки до #endif, если <identifier> был ранее определен.

#ifndef
#ifndef <identifier>
Выполняет последующие строки до #endif, если <identifier> не был ранее определён.

#include
#include <filename>
Вставляет содержимое файла <filename> в текущий файл. Если путь к имени файла включен в двойные кавычки, то поиск осуществляется внутри текущего каталога.

#include_next
#include_next <filename>
?

#line
#line n file
Изменяет внутренний номер строки компилятора на <n>, а также изменяет внутреннее имя файла на <file>. Текущий номер строки и имя файла доступны через константы препроцессора __LINE__ и __FILE__.

#pragma
#pragma directives
Инструктирует компилятор, о выполнение машинно-специфических возможностей, определенных параметром <directives> (таблица [*]).

#undef
#undef identifier
Удаляет текущее определение <identifier>, который был предварительно определен директивой #define.

#warning
#warning сообщение
Генерация сообщения предупреждения на stderr и продолжение компиляции.

Таблица 7. Параметры директивы pragma, препроцессора

Имя	Назначение
pack	Определяет, как компилятор выравнивает данные при сохранении в памяти. Может также использоваться с, вталкиванием и выталкиванием параметров. `#pragma pack(n) #pragma pack(push, n) #pragma pack(pop)`

Таблица 8. Предопределённые символьные константы

Имя	Назначение
__BASE_FILE__	Полный путь к каталогу исходного файла.
__CHAR_UNSIGNED__	Указывает на то, что символьный тип является безнаковым.
__cplusplus	Указывает на то, что исходный код является программой на языке С++.
__DATE__	Дата компиляции исходного файла (строка).
__FILE__	Имя исходного файла (строка).
__func__	Имя текущей функции.
__FUNCTION__	Имя текущей функции.
__PRETTY_FUNCTION__	Полное имя текущей функции. Для C++ включает имена классов.
__INCLUDE_LEVEL__	Глубина включения (include) файла.
__LINE_	Номер текущей строки исходного текста (целое число).
__NO_INLINE__	Указывает на отсутствие inline-функций.
__OBJC__	Программа на языке Objective-C.
__OPTIMIZE__	Указывает на то, что назначен уровень оптимизации.
__OPTIMIZE_SIZE__	Оптимизация размера программы.
__STDC__	Компилятор соответствует правилам стандарта языка C.
__TIME__	Время компиляции исходного файла (строка).
__VERSION__	Полный номер версии.

OpenSCADAWiki: Roman Savochenko/C Short All/part1/part8 ...

1.8 Препроцессор

1.8.1 Директивы Препроцессора