OpenSCADAWiki : Roman Savochenko / C Short All / part 1 / part 8 (edit)

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

* Определение/удаление макроса. Макрос может быть определён без значения и может использоваться в качестве проверяемого флага. 
  %%(php) #define VAL_T 345
 #undef VAL_T
 #define VAL_T 234%%

* Для перевода на другую строку используется  ";\" : 
  %%(php)#define FILLSCREAN(color) _AX = 0x0600;\
                           _CX = 0x0000;\
                           _DX = 0x184f;\
                           _BH = color;\
                           geninterrupt(0x10);%%

* Использование параметров:
  %%(php) #define min(a,b) ((a) < (b) ? (a) : (b))
 result = min(44,uplimit);   
 // result = ((44) < (uplimit) ? (44) : (uplimit));%%

* Для объединения формальных параметров используются символы ##: 
  %%(php)#define var( i , j ) ( i##j )   // var( x , 6 ) = x6%%

* Для преобразования фактического параметра в строку используется символ # который помещается перед формальным макропараметром:
  %%(php)#define TRACE(flag) printf(#flag "=%d\n", flag)%%
 
  * Вариантный макрос (...):
  %%(php) #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>. Текущий номер строки и имя файла доступны через константы препроцессора &#95;&#95;LINE&#95;&#95; и &#95;&#95;FILE&#95;&#95;. 
 
**#pragma**
//#pragma directives//
Инструктирует компилятор, о выполнение машинно-специфических возможностей, определенных параметром <directives> (таблица [*]). 
 
**#undef**
//#undef identifier//
Удаляет текущее определение <identifier>, который был предварительно определен директивой #define. 
 
**#warning**
//#warning сообщение//
Генерация сообщения предупреждения на stderr и продолжение компиляции.

Таблица 7. **Параметры директивы pragma, препроцессора**
#|
||%%(wacko wrapper=text wrapper_align=center)**Имя**%%|%%(wacko wrapper=text wrapper_align=center)**Назначение**%%||
||pack|Определяет, как компилятор выравнивает данные при сохранении в памяти. Может также использоваться с, вталкиванием и выталкиванием параметров.
%%(php)#pragma pack(n) 
#pragma pack(push, n) 
#pragma pack(pop)%%||
|#

Таблица 8. **Предопределённые символьные константы**
#|
||%%(wacko wrapper=text wrapper_align=center)**Имя**%%|%%(wacko wrapper=text wrapper_align=center)**Назначение**%%||
||&#95;&#95;BASE_FILE&#95;&#95;|Полный путь к каталогу исходного файла.||
||&#95;&#95;CHAR_UNSIGNED&#95;&#95;|Указывает на то, что символьный тип является безнаковым.||
||&#95;&#95;cplusplus|Указывает на то, что исходный код является программой на языке С++.||
||&#95;&#95;DATE&#95;&#95;|Дата компиляции исходного файла (строка).||
||&#95;&#95;FILE&#95;&#95;|Имя исходного файла (строка).||
||&#95;&#95;func&#95;&#95;|Имя текущей функции.||
||&#95;&#95;FUNCTION&#95;&#95;|Имя текущей функции.||
||&#95;&#95;PRETTY_FUNCTION&#95;&#95;|Полное имя текущей функции. Для C++ включает имена классов.||
||&#95;&#95;INCLUDE_LEVEL&#95;&#95;| Глубина включения (include) файла.||
||&#95;&#95;LINE&#95;|Номер текущей строки исходного текста (целое число).||
||&#95;&#95;NO_INLINE&#95;&#95;|Указывает на отсутствие inline-функций.||
||&#95;&#95;OBJC&#95;&#95;|Программа на языке Objective-C.||
||&#95;&#95;OPTIMIZE&#95;&#95;|Указывает на то, что назначен уровень оптимизации.||
||&#95;&#95;OPTIMIZE_SIZE&#95;&#95;|Оптимизация размера программы.||
||&#95;&#95;STDC&#95;&#95;|Компилятор соответствует правилам стандарта языка C.||
||&#95;&#95;TIME&#95;&#95;|Время компиляции исходного файла (строка).||
||&#95;&#95;VERSION&#95;&#95;|Полный номер версии.||
|#

Please type the word you read in the image:

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