Replacing text macros

Материал из cppreference.com

This page has been machine-translated from the English version of the wiki using Google Translate.

The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

Click here for the English version of this page

Препроцессор поддерживает замену текста макроса. Функция-как текст макроса замены Также поддерживается.

[править] Синтаксис


`#define` identifier replacement-list	(1)

`#define` identifier`(` parameters `)` replacement-list	(2)

`#define` identifier`(` parameters`, ... )` replacement-list	(3)

`#define` identifier`( ... )` replacement-list	(4)

`#undef` identifier	(5)

[править] Объяснение

[править] Ǌ директивы

#define директивы определяют identifier как макро, то есть указать компилятору, чтобы заменить все последовательные вхождения identifier с replacement-list, который опционально может быть дополнительно обработаны. Если идентификатор уже определен как любой тип макросов, программа плохо сформированных.

[править] Объекта, как макросы

Объект типа макросов заменить каждое вхождение определенных identifier с replacement-list. Версия (1), #define директива ведет себя именно так.

[править] Функция подобных макросов

Функция подобных макросов заменить каждое вхождение определенных identifier с replacement-list, дополнительно принимает ряд аргументов, которые затем заменить соответствующие вхождения любого из parameters в replacement-list. Число аргументов должно быть таким же, как количество аргументов в определении макроса (parameters) или программа плохо сформированные. Если идентификатор не находится в функциональной нотации, т.е. не имеют скобках после себя, она не заменяется на всех.

Версия (2) из #define директива определяет простую функцию, как макро.

Версии (3) из #define директива определяет функцию, как макрос с переменным числом аргументов. Дополнительных аргументов можно получить с помощью __VA_ARGS__ идентификатор, который затем заменили аргументы, поставляемых с идентификатором быть заменены.

Версия (4), #define директива определяет функцию, как макрос с переменным числом аргументов, но не регулярные аргументы. Аргументы могут быть доступны только с __VA_ARGS__ идентификатор, который затем заменили аргументы, поставляется с идентификатором быть заменены.

[править] Ǌ и Ǌ операторов

В функции подобных макросов, # оператора до идентификатор в replacement-list работает идентификатор через параметр замены и охватывает результат в кавычки, фактически создав строковый литерал. Кроме того, препроцессор добавляет backslahes, чтобы избежать кавычки вокруг встроенные строковые литералы, если таковые имеются, и удваивает обратную косую черту в строке по мере необходимости. Все начальные и конечные пробелы удаляются, и любая последовательность пробелов в середине текста (но не внутри встроенных литералов строка) рухнул на одном пространстве. Эта операция называется "стрингификации". Если результат стрингификации не является допустимым строковый литерал, поведение не определено.

## оператора между любыми двумя последовательными идентификаторы в replacement-list работает параметров замены на двух идентификаторов, а затем объединяет результаты. Эта операция называется "объединение" или "знак вставки". Только жетоны, которые образуют действительный маркер вместе, могут быть вставлены: идентификаторы, которые формируют более идентификатор, цифры, которые образуют число, или операторы + и =, что форма +=. Комментарий не может быть создано путем вставки / и *, потому что комментарии будут удалены из текста перед макроподстановки считается. Если в результате объединения не является допустимым маркером, поведение не определено.

[править] Ǌ директивы

#undef директивы undefines identifier, который отменяет предыдущее определение identifier по #define директивы. Если идентификатор не были связаны макроса, директива игнорируется.

[править] Предопределенные макросы

Следующие имена макросов являются предопределенными в любой единице трансляции.


__cplusplus	расширяется до значения 199711L(до C++11) или 201103L(начиная с C++11) Original: expands to value 199711L(до C++11) or 201103L(начиная с C++11) The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDC_HOSTED__ (C++11)	расширяется до целочисленной константы 1, если реализация размещается (работает под ОС), если автономные 0 (работает без ОС) Original: expands to the integer constant 1 if the implementation is hosted (runs under an OS), 0 if freestanding (runs without an OS) The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__FILE__	расширяется в имя текущего файла, а строковый литерал Original: expands to the name of the current file, as a character string literal The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__LINE__	расширяется до строки исходного файла, целая константа Original: expands to the source file line number, an integer constant The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__DATE__	расширяется до даты перевода, строковый литерал в форме "Ммм дд гггг". Название месяца, как если бы порожденный std::asctime() Original: expands to the date of translation, a character string literal of the form "Mmm dd yyyy". The name of the month is as if generated by std::asctime() The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__TIME__	расширяется до момента перевода, строковый литерал в форме "чч: мм: сс" Original: expands to the time of translation, a character string literal of the form "hh:mm:ss" The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

Следующие дополнительные имена макросов может быть предопределен реализации.


__STDC__	осуществление определенного значения, если они присутствуют Original: implementation-defined value, if present The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDC_VERSION__ (C++11)	осуществление определенного значения, если они присутствуют Original: implementation-defined value, if present The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDC_ISO_10646__ (C++11)	расширяется до целого числа постоянных вид `yyyymmL`, если wchar_t использует Unicode, дата указывает на последнюю версию Unicode поддерживается Original: expands to an integer constant of the form `yyyymmL`, if wchar_t uses Unicode, the date indicates the latest revision of Unicode supported The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDC_MB_MIGHT_NEQ_WC__ (C++11)	расширяется до 1 если широкая кодировку основного набора символов может не совпадать своих узких кодирования Original: expands to 1 if wide character encoding of the basic character set may not equal their narrow encoding The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDCPP_STRICT_POINTER_SAFETY__ (C++11)	расширяется до 1, если реализация имеет строгие std::pointer_safety Original: expands to 1 if the implementation has strict std::pointer_safety The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

__STDCPP_THREADS__ (C++11)	расширяется до 1 если программа может иметь более одного потока исполнения Original: expands to 1 if the program can have more than one thread of execution The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (константа-макрос)

Значения этих макросов (за исключением __FILE__ и __LINE__) остаются постоянными на протяжении всего ЕП. Попытки пересмотреть или неопределенное этих макросов приведет к неопределенному поведению.

Примечание: в комплект каждой функции тела, есть специальная функция-местный предопределенных переменная с именем __func__(начиная с C++11), определяется как статический массив символов проведение имя функции в реализации определенного формата. Это не макрос препроцессора, но она используется вместе с __FILE__ и __LINE__, например, по assert.

[править] Пример

#include <iostream>
 
//make function factory and use it
#define FUNCTION(name, a) int fun_##name() { return a;}
 
FUNCTION(abcd, 12);
FUNCTION(fff, 2);
FUNCTION(kkk, 23);
 
#undef FUNCTION
#define FUNCTION 34
#define OUTPUT(a) std::cout << #a << '\n'
 
int main()
{
    std::cout << "abcd: " << fun_abcd() << '\n';
    std::cout << "fff: " << fun_fff() << '\n';
    std::cout << "kkk: " << fun_kkk() << '\n';
    std::cout << FUNCTION << '\n';
    OUTPUT(million);               //note the lack of quotes
}

Вывод:

abcd: 12
fff: 2
kkk: 23
34
million

Язык
Понятия (концепции)
Утилиты
Строки
Контейнеры
Алгоритмы
Итераторы
Работа с числами
Ввод / вывод
Локализация
Регулярные выражения (C++11)
Атомарные примитивы (C++11)
Потоки (C++11)

cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Replacing text macros

Содержание

[править] Синтаксис

[править] Объяснение

[править] Ǌ директивы

[править] Объекта, как макросы

[править] Функция подобных макросов

[править] Ǌ и Ǌ операторов

[править] Ǌ директивы

[править] Предопределенные макросы

[править] Пример

Навигация

Инструменты