![]() |
![]() ![]() ![]() ![]() ![]() |
![]() |
Boost Macro ReferenceBoost , Boost.Config , Boost.Config
|
Макро |
Раздел |
Описание |
---|---|---|
|
Compiler |
The compiler exhibits certain partial specialisation bug - probably Borland C++ Builder specific. |
< |
Compiler |
Argument dependent lookup fails if there is a using declaration
for the symbol being looked up in the current scope. For example,
using |
|
Compiler |
The compiler locates and searches namespaces that it should *not* in fact search when performing argument dependent lookup. |
|
Compiler |
Компилятор не осуществляет поиск, зависящий от аргументов (также называемый поиском Koenig); см. std::3.4.2 [basic.koenig.lookup] |
|
Standard library |
If the compiler / library supplies non-standard or broken |
|
Compiler |
Compiler has not completely implemented value-initialization. See also The Utility/Value Init docs |
< |
Platform |
Платформа не предоставляет функции для операций классификации символов< |
|
Compiler |
If template specialisations for cv-qualified types conflict with a specialisation for a cv-unqualififed type. |
|
Compiler |
Если шаблонные специализации для типов cv-void противоречат специализации для пустоты. |
|
Platform |
Платформа не предоставляет< |
|
Platform |
The Platform does not provide |
< |
Platform, Standard library |
The C standard library doesn't provide |
< |
Compiler |
The compiler fails to compile a nested class that has a dependent base class: template<typename T> struct foo : { template<typename U> struct bar : public U {}; }; |
< |
Compiler |
Template value parameters cannot have a dependent type, for example: template<class T, typename T::type value> class X { ... };
|
|
Standard Library |
Стандартная библиотека не помещает некоторые или все содержимое< |
|
Compiler |
Компилятор не поддерживает обработку исключений (эта настройка обычно требуется многими компиляторами C++ для встроенных платформ). Обратите внимание, что нет необходимости в том, чтобы библиотеки бустеров соблюдали эту настройку конфигурации - в некоторых случаях это может быть невозможно. Библиотеки, которые чтят это, как правило, прекратят, если произойдет критическая ошибка - вы были предупреждены! |
< |
Compiler |
Компилятор не выполняет упорядочение шаблонов функций или его упорядочение шаблонов функций является неправильным. <// #1 template<classT>voidf(T); // #2 template<classT,classU>voidf(T(*)(U)); voidbar(int); f(&bar);// should choose #2.> |
|
Compiler |
Compiler violates std::9.4.2/4. |
|
Compiler |
The C++ implementation does not provide |
< |
std lib |
The standard library lacks |
< |
std lib |
В стандартной библиотеке отсутствуют< |
< |
Compiler |
Компилятор C++ не поддерживает SFINAE с абстрактными типами, это охваченоCore Language DR337, но не является частью текущего стандарта. К счастью, большинство компиляторов, поддерживающих SFINAE, также поддерживают этот DR. |
|
Standard library |
Реализация C++ не обеспечивает заголовок< |
|
Standard library |
C++11 additions to |
< |
Standard library |
Constants such as |
|
Standard library |
There is no specialization for |
|
Compiler |
The compiler does not support the specialization of individual member functions of template classes. |
|
Compiler |
If the compiler supports member templates, but not the template keyword when accessing member template classes. |
< |
Compiler |
Member template friend syntax ( |
< |
Compiler |
Member template functions not fully supported. |
|
Standard library |
There is no specialization for |
< |
Compiler |
Компилятор не позволяет вложенному классу получить доступ к частным членам содержащего его класса. Возможно, Borland/CodeGear. |
|
Compiler |
Компилятор требует, чтобы унаследованные функции друга оператора определялись в области пространства имен, а затем использовались для повышения. Возможно, GCC.< |
< |
Compiler |
Компилятор неправильно обрабатывает частичные специализации, которые зависят от аргументов по умолчанию в первичном шаблоне. |
< |
Compiler |
Компилятор неправильно обрабатывает указатели на функции const-члена, предотвращая их использование в перегруженных шаблонах функций. См.< |
< |
Compiler |
Указатели для членов не работают при использовании в качестве параметров шаблона. |
< |
Compiler |
The compiler misreads 8.5.1, treating classes as non-aggregate if they contain private or protected member functions. |
|
Compiler |
The compiler may (or may not) have the typeid operator, but RTTI on the dynamic type of an object is not supported. |
|
Compiler |
The compiler does not support the "Substitution Failure Is Not An Error" meta-programming idiom. |
|
Compiler |
The compiler does not support usage of SFINAE with arbitrary expressions. |
< |
Standard library |
The C++ standard library does not provide a standards conforming
|
< |
Standard library |
Платформа не имеет соответствующей версии< |
|
Standard library |
Реализация C++ не обеспечивает класс< |
|
Standard library |
The compiler does not provide a standard compliant implementation
of |
|
Standard library |
The standard library lacks |
|
Standard library |
The standard library lacks a conforming |
< |
Standard library |
Стандартная библиотека C++ не предоставляет функции шаблонов< |
< |
Standard library |
Defined if the standard library's output iterators are not assignable. |
|
Standard library |
The <typeinfo> header declares |
< |
Standard library |
В стандартной библиотеке отсутствует соответствующая< |
< |
Standard library |
The standard library's implementation of |
< |
Standard library |
The standard library lacks |
< |
Compiler, Platform |
The contents of C++ standard headers for C library functions (the
|
|
Standard library |
The C++ implementation does not provide the |
< |
Platform |
The platform does not have a conforming version of |
|
Compiler |
Class template partial specialization (14.5.4 [temp.class.spec]) not supported. |
< |
Standard library |
The standard library does not provide templated iostream classes. |
|
Standard library |
The standard library does not provide templated iterator constructors for its containers. |
< |
Compiler |
The compiler does not support template template parameters. |
< |
Compiler |
Компилятор вообще не поддерживает оператора Typeid. |
|
Compiler |
The typename keyword cannot be used when creating a temporary of a Dependent type. |
|
Compiler |
Если возврат недостижим, то не требуется никакого заявления о возврате, однако некоторые компиляторы настаивают на этом, в то время как другие выдают кучу предупреждений, если он действительно присутствует. |
|
Compiler |
The compiler will not accept a using declaration that brings a function from a typename used as a base class into a derived class if functions of the same name are present in the derived class. |
|
Compiler |
The compiler will not accept a using declaration that imports a template class or function from another namespace. Originally a Borland specific problem with imports to/from the global namespace, extended to MSVC6 which has a specific issue with importing template classes (but not functions). |
< |
Compiler |
Компилятор не позволяет функции пустоты возвращать результат вызова другой функции пустоты. <voidf(){} voidg(){returnf();}> |
Следующие макросы описывают функции, которые не требуются стандартом C++. Макрос определяется только при наличии функции.
Макро |
Раздел |
Описание |
---|---|---|
|
Platform |
Платформа поддерживает потоки в стиле BeOS. |
|
Platform |
The platform has the POSIX API |
|
Platform |
Платформа имеет заголовок POSIX< |
|
Platform |
The platform has the functions |
< |
Compiler |
The compiler has |
|
Platform |
The platform has the Win32 API type FTIME. |
< |
Platform |
Платформа имеет API Win32 GetSystemTimeAsFileTime. |
< |
Platform |
The platform has the POSIX API |
|
Standard library |
The C++ implementation provides the (SGI) hash_set and hash_map
classes. When defined, |
< |
Compiler |
The compiler has |
|
Platform |
Платформа имеет функции< |
|
Standard library |
The standard library lacks a conforming |
< |
Compiler |
The compiler supports the |
< |
Platform |
The platform has the POSIX API nanosleep. |
|
Platform |
Платформа имеет< |
|
Compiler |
Указывается, что компилятор поддерживает названную оптимизацию обратных значений (NRVO). Используется для выбора наиболее эффективной реализации для некоторых функций. Например,< |
|
Standard Library |
Стандартная библиотека имеет частично соответствующий< |
|
Compiler |
The compiler recognizes the |
< |
Compiler |
Компилятор распознает директиву< |
< |
Platform |
The platform has the POSIX API |
|
Platform |
Платформа имеет POSIX API< |
|
Platform |
The platform has the POSIX API |
< |
Platform |
Платформа поддерживает потоки в стиле POSIX. |
|
Platform |
The platform has the POSIX API |
|
Компилятор, стандартная библиотека |
The compiler has native support for SGI style type traits. |
|
Platform |
The platform has a |
|
Standard library |
Реализация C++ обеспечивает класс списков (SGI). При определении< |
|
Standard library |
The standard library lacks a conforming |
|
Standard library |
The library has a TR1 conforming version of |
|
Standard library |
The library has a version of |
< |
Standard library |
The library has a version of |
< |
Standard library |
The library has TR1 conforming reference wrappers in |
|
Standard library |
The library has a TR1 conforming result_of template in |
|
Standard library |
The library has a TR1 conforming mem_fn function template in |
|
Standard library |
The library has a TR1 conforming bind function template in |
< |
Standard library |
Библиотека имеет шаблон TR1 в< |
< |
Standard library |
The library has a TR1 conforming hash function template in |
|
Standard library |
The library has a TR1 conforming |
|
Standard library |
The library has a TR1 conforming version of |
|
Standard library |
The library has a TR1 conforming version of |
< |
Standard library |
The library has a TR1 conforming version of |
|
Standard library |
Библиотека имеет TR1-конформную версию< |
< |
Standard library |
Библиотека имеет дополнения TR1 к< |
|
Standard library |
Библиотека имеет TR1-конформную версию< |
|
Standard library |
The library has a TR1 conforming version of |
|
Standard library |
Implies all the other |
|
Платформа, компилятор |
Defined if the compiler, in its current translation mode, supports multiple threads of execution. |
< |
Standard library |
The standard library lacks a conforming std::use_facet, but has a two argument version that does the job. This is primarily for the Rogue Wave std lib. |
|
Platform |
The Platform provides |
|
Platform |
The platform supports MS Windows style threads. |
< |
Standard library |
Microsoft's broken version of |
|
Compiler |
Microsoft Visual C++ 6.0 имеет достаточно шаблонных идиосинкразий (быть вежливым), которые< |
|
Platform |
There are no 1998 C++ Standard headers |
Следующие макросы описывают функции, которые могут быть включены в будущий стандарт ISO C++, но еще не одобрены для включения в язык.
Макро |
Описание |
---|---|
< |
The compiler supports concepts. |
Следующие макросы описывают функции стандарта ISO C++ 2011 года, ранее известного как C++0x, которые еще не поддерживаются конкретным компилятором или библиотекой.
Макро |
Описание |
---|---|
< |
The standard library header <memory> has no working std::addressof. |
< |
Компилятор не поддерживает ключевое слово< |
< |
The standard library does not provide a C++11 version of |
< |
The standard library <memory> does not support atomic smart pointer operations. |
< |
The compiler does not support type deduction for variables declared
with the |
< |
Компилятор не поддерживает вычет типа для нескольких переменных, объявленных ключевым словом< |
|
The compiler does not support type |
< |
The compiler does not support type |
< |
The compiler does not support |
|
The compiler does not support |
|
Компилятор не поддерживает расширение до< |
|
Компилятор не поддерживает удаленные (< |
|
The compiler does not support defaulted ( |
|
Компилятор не поддерживает явных операторов преобразования< |
|
The compiler does not support explicit instantiation forward declarations
for templates ( |
< |
Компилятор не поддерживает финал класс-вирт-спецификатора C++. |
< |
Компилятор не поддерживает расширение вариадного пакета параметров шаблона в шаблон, содержащий один или несколько фиксированных аргументов . |
< |
The compiler does not support default template arguments for function templates. |
< |
The standard library does not provide header <atomic>. |
< |
The standard library does not provide header <array>. |
|
The standard library does not provide header <chrono>. |
< |
Стандартная библиотека не предоставляет заголовок |
|
The standard library does not provide header <condition_variable>. |
< |
The standard library does not provide header <forward_list>. |
< |
Стандартная библиотека не предоставляет совместимую с C++11 версию |
|
Стандартная библиотека не содержит заголовка |
< |
The standard library does not provide header <initializer_list>. |
< |
Стандартная библиотека не содержит заголовка |
|
The standard library does not provide header <random>. |
|
The standard library does not provide header <ratio>. |
< |
The standard library does not provide header <regex>. |
|
The standard library does not provide header <system_error>. |
< |
The standard library does not provide header <thread>. |
|
The standard library does not provide header <tuple>. |
|
Стандартная библиотека не содержит заголовка |
|
The standard library does not provide header <type_traits>. |
< |
Стандартная библиотека не предоставляет заголовок |
< |
The standard library does not provide header <unordered_set>. |
|
The compiler does not support inline namespaces. |
< |
Компилятор не поддерживает Lambdas. |
|
Компилятор не позволяет передавать локальные классы в качестве параметров шаблона (этот макрос намеренно не контролирует прохождение неназванных типов в качестве параметров шаблона, см. такжеN2657). |
|
The compiler does not support defaulted ( |
|
The compiler does not support |
|
Компилятор не поддерживает< |
|
Заголовок стандартной библиотеки< |
< |
Компилятор не поддерживает заявления на основе диапазона. |
|
The compiler does not support raw string literals. |
|
The compiler does not support ref-qualifiers on member functions as described in N2439. |
< |
The compiler does not support r-value references. |
|
The compiler does not support scoped enumerations ( |
|
Стандартный заголовок библиотеки |
|
The compiler does not support |
|
Стандартный заголовок библиотеки |
|
The standard library does not support <unordered_map> and <unordered_set>. |
< |
The compiler does not support template aliases. |
< |
The compiler does not support the |
|
The compiler does not support the new function result type specification
syntax (e.g. |
< |
The compiler does not support Unicode ( |
|
The compiler does not support the C++11 Unified Initialization Syntax. |
< |
The compiler does not support user defined literals. |
|
Компилятор не поддерживает вариадные шаблоны. |
< |
The compiler does not support variadic macros. |
|
The compiler does not support |
Следующие макросы позволяют использовать функции C++11 даже с компиляторами, которые еще не обеспечивают совместимую поддержку C++11.
Макро |
Описание |
---|---|
|
Some compilers don't support the struct BOOST_ALIGNMENT(16) my_data { char c[16]; }; BOOST_ALIGNMENT(8) int arr[32];
|
|
Некоторые компиляторы не поддерживают использование< constexprtuple();> на: <BOOST_CONSTEXPRtuple();>. |
|
Some compilers don't support the use of static constexpr UIntType xor_mask = a; with: static BOOST_CONSTEXPR_OR_CONST UIntType xor_mask = a;
|
|
This is a shortcut for static constexpr UIntType xor_mask = a; with: BOOST_STATIC_CONSTEXPR UIntType xor_mask = a;
|
< |
This macro is intended to be used within a class definition in
order to declare a default implementation of function struct my_struct { BOOST_DEFAULTED_FUNCTION(my_struct(), {}) }; is equivalent to: struct my_struct { my_struct() = default; }; or: struct my_struct { my_struct() {} };
|
|
This macro is intended to be used within a class definition in
order to declare a deleted function struct noncopyable { BOOST_DELETED_FUNCTION(noncopyable(noncopyable const&)) BOOST_DELETED_FUNCTION(noncopyable& operator= (noncopyable const&)) }; is equivalent to: struct noncopyable { noncopyable(noncopyable const&) = delete; noncopyable& operator= (noncopyable const&) = delete; }; or: struct noncopyable { private: noncopyable(noncopyable const&); noncopyable& operator= (noncopyable const&); };
|
<BOOST_NOEXCEPT BOOST_NOEXCEPT_OR_NOTHROW BOOST_NOEXCEPT_IF(Predicate) BOOST_NOEXCEPT_EXPR(Expression)> |
If
If
|
|
Для Microsoft Visual C++ 2012 включите функции C++11, предоставленные в ноябре 2012 года Community Technology Preview. Эти функции не включаются автоматически, поскольку CTP не поддерживает альфа-код, который не рекомендуется для использования в производстве. Этот макрос должен быть определен перед включением любых заголовков Boost и должен быть определен для всех блоков перевода в программе, включая сборки библиотеки Boost. Этот макрос больше не будет иметь никакого эффекта, как только официальная версия Microsoft будет поддерживать функции CTP. |
Следующие макросы описывают функции стандарта ISO C++ 2014 года, ранее известного как C++0y, которые еще не поддерживаются конкретным компилятором или библиотекой.
Макро |
Описание |
---|---|
|
The compiler does not support member initializer for aggregates as in the following example:
|
|
The compiler does not binary literals (e.g. |
< |
The compiler does not support relaxed |
|
The compiler does not support |
< |
The compiler does not support digit separators (e.g. |
|
Компилятор не поддерживает общую лямбду (например,< |
< |
The standard library does not provide header <shared_mutex>. |
|
Компилятор не поддерживает инициализированный захват лямбды (например,< |
|
Компилятор не поддерживает вычет типа возврата для нормальных функций (например,< |
|
Компилятор не поддерживает шаблон переменных (например,< |
Следующие макросы позволяют использовать функции C++14 даже с компиляторами, которые еще не обеспечивают совместимую поддержку C++14.
Макро |
Описание |
---|---|
< |
Этот макрос работает аналогично BOOST_CONSTEXPR, но расширяется до< |
Следующие макросы являются либо простыми помощниками, либо макросами, которые обеспечивают обходные пути для дефектов компилятора / стандартной библиотеки.
Макро |
Описание |
---|---|
< |
Этот макрос используется в тех случаях, когда требуется специальный обходной путь компилятора, который не описывается другим Boost. Настройка макросов. Для использования макроса необходимо сначала использовать <#include<boost/detail/workaround.hpp>> : <#ifBOOST_WORKAROUND(MACRONAME,CONDITION) // workaround code goes here... #else // Standard conforming code goes here... #endif> , где< Макрос также может быть использован с< Например,< Примечание: Конечным источником документации для этого макроса являетсяboost/detail/workaround.hpp . |
|
Sometimes you have a function name with the same name as a C macro, for example "min" and "max" member functions, in which case one can prevent the function being expanded as a macro using: someclass.min BOOST_PREVENT_MACRO_SUBSTITUTION(arg1, arg2); The following also works in most, but not all, contexts: (someclass.max)(arg1, arg2);
|
|
Some compilers don't support the use of typename for dependent
types in deduced contexts. This macro expands to nothing on those
compilers, and typename elsewhere. For example, replace: |
< |
Заголовок для включения, чтобы получить класс SGI< |
|
The header to include to get the SGI |
|
The header to include to get the SGI |
|
The namespace used for std library extensions (hashtable classes etc). |
|
На компиляторах, которые не позволяют в классе инициализации статических интегральных постоянных членов, мы должны использовать числа в качестве обходного пути, если мы хотим, чтобы константы были доступны во время компиляции. Этот макрос дает нам удобный способ объявления таких констант. Например, вместо: <structfoo{ staticconstintvalue=2; };> используйте: <structfoo{ BOOST_STATIC_CONSTANT(int,value=2); };> |
< |
Normally evaluates to nothing, but evaluates to return x; if the compiler requires a return, even when it can never be reached. |
|
The BOOST_FALLTHROUGH macro can be used to annotate implicit fall-through between switch labels: switch (x) { case 40: case 41: if (truth_is_out_there) { ++x; BOOST_FALLTHROUGH; // Use instead of/along with annotations in // comments. } else { return x; } case 42: ... As shown in the example above, the BOOST_FALLTHROUGH macro should be followed by a semicolon. It is designed to mimic control-flow statements like 'break;', so it can be placed in most places where 'break;' can, but only if there are no statements on the execution path between it and the next switch label.
When compiled with Clang >3.2 in C++11 mode, the BOOST_FALLTHROUGH
macro is expanded to When used with unsupported compilers, the BOOST_FALLTHROUGH macro has no effect on diagnostics. In either case this macro has no effect on runtime behavior and performance of code. |
|
Some compilers silently "fold" different function template instantiations if some of the template parameters don't appear in the function parameter list. For instance: #include <iostream> #include <ostream> #include <typeinfo> template <int n> void f() { std::cout << n << ' '; } template <typename T> void g() { std::cout << typeid(T).name() << ' '; } int main() { f<1>(); f<2>(); g<int>(); g<double>(); }
incorrectly outputs template <int n> void f(BOOST_EXPLICIT_TEMPLATE_NON_TYPE(int, n)) { ... } template <typename T> void g(BOOST_EXPLICIT_TEMPLATE_TYPE(T)) { ... } Beware that they can declare (for affected compilers) a dummy defaulted parameter, so they a) should be always invoked at the end of the parameter list b) can't be used if your function template is multiply declared.
Furthermore, in order to add any needed comma separator, an |
|
Когда стандартная библиотека не имеет соответствующей< |
< |
When the standard library does not have a comforming |
< |
Member templates are supported by some compilers even though they
can't use the |
< |
Converts the parameter |
|
Эта часть макромагии объединяет два аргумента вместе, даже если один из аргументов сам по себе является макросом (см. 16.3.1 в стандарте C++). Обычно это используется для создания искажённого имени в сочетании с предопределенным макросом, таким как __LINE__. |
|
This macro can be used in place of the Usage example: template<class T> BOOST_FORCEINLINE T& f(T& t) { return t; }
Note that use of this macro can lead to cryptic error messages
with some compilers. Consider defining it to |
|
Этот макрос может быть использован вместо ключевого слова< Пример использования: <BOOST_NOINLINEvoidhandle_error(constchar*descr) { // ... }> |
< |
This macro can be used before the function declaration or definition
to instruct the compiler that the function does not return normally
(i.e. with a Usage example: BOOST_NORETURN void on_error_occurred(const char* descr) { throw std::runtime_error(descr); }
If the compiler does not support this markup, |
|
These macros communicate to the compiler that the conditional expression
The macros are intended to be used in branching statements. The additional hint they provide can be used by the compiler to arrange the compiled code of the branches more effectively. Usage example: if (BOOST_UNLIKELY(ptr == NULL)) handle_error("ptr is NULL");
|
< |
Expands to |
Следующие макросы описывают функции повышения; это, вообще говоря, единственные макросы повышения, которые должны быть протестированы в пользовательском коде.
Макро |
Заголовок |
Описание |
---|---|---|
< |
|
Describes the boost version number in XYYYZZ format such that:
|
|
|
Defined if there are no 64-bit integral types: |
|
|
Defined if |
< |
< |
Defined if the compiler is really Microsoft Visual C++, as opposed
to one of the many other compilers that also define |
|
< |
Defined to a normalised 9 digit version of _MSC_FULL_VER (which sometimes only has 8 digits), the macro has the form VVMMPPPPP where VV is the major version number, MM is the minor version number, and PPPPP is the compiler build number. |
|
< |
Defined if the compiler is really GCC, as opposed to one of the
many other compilers that also define |
< |
< |
Определенный, если компилятор является компилятором Intel, принимает то же значение, что и макрос версии компилятора. |
< |
< |
Определено до 1, если компилятором является компилятор Clang. |
|
< |
Defined if the Windows platform API is available. |
< |
< |
Defined if the dinkumware standard library is in use, takes the
same value as the Dinkumware library version macro |
|
|
Defined if the regex library does not support wide character regular expressions. |
< |
< |
Defined as a string describing the name and version number of the compiler in use. Mainly for debugging the configuration. |
< |
< |
Defined as a string describing the name and version number of the standard library in use. Mainly for debugging the configuration. |
< |
< |
Defined as a string describing the name of the platform. Mainly for debugging the configuration. |
Ниже приведены амортизационные меры; пожалуйста, используйте замену. Они будут удалены в будущей версии.
Устаревший Макро |
Замена |
Когда обесценивается |
когда удаляется |
---|---|---|---|
|
< |
Повышение на 1,50 |
|
|
|
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
|
|
Повышение на 1,50 |
|
< |
< |
Повышение на 1,50 |
|
|
|
Повышение на 1,50 |
|
< |
< |
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
< |
< |
Повышение на 1,50 |
|
|
|
Повышение на 1,50 |
|
< |
|
Повышение на 1,50 |
|
< |
< |
Повышение на 1,50 |
|
< |
|
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
< |
|
Повышение на 1,50 |
|
< |
|
Повышение на 1,50 |
|
< |
|
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
|
< |
Повышение на 1,50 |
|
< |
< |
Boost 1.51 |
|
< |
< |
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
< |
Boost 1.51 |
|
|
< |
Boost 1.51 |
|
|
< |
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
|
< |
Boost 1.51 |
|
< |
< |
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
< |
< |
Boost 1.51 |
|
< |
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
|
< |
Boost 1.51 |
|
|
|
Boost 1.51 |
|
|
|
Boost 1.51 |
|
< |
< |
Boost 1.51 |
|
|
|
Boost 1.51 |
|
|
|
Boost 1.53 |
|
|
< |
Boost 1.53 |
|
|
|
Boost 1.53 |
|
|
< |
Boost 1.53 |
|
< |
|
Boost 1.53 |
Следующие макросы и вспомогательные заголовки используются для авторов, чьи библиотеки содержат отдельный исходный код, и предназначены для решения нескольких вопросов:
См.Руководство для авторов библиотек, содержащих отдельный источник
Некоторые компиляторы поддерживают расширения C++, которые контролируют, какие символы будут экспортироваться из общих библиотек, таких как динамические общие объекты (DSO) в Unix-подобных системах или библиотеки динамических ссылок (DLL) в Windows.
Компилятор Microsoft VC++ уже давно поставляет расширения<__declspec(dllexport)
>и<__declspec(dllimport)
>для этой цели, как и практически все другие компиляторы, ориентированные на платформу Windows.
Современные версии компилятора GNU GCC предоставляют расширение<__attribute__((visibility("default")))
>, чтобы указать, что символ должен быть экспортирован. Все остальные символы могут быть скрыты с помощью переключателей компилятора<-fvisibility-hidden
>или<-fvisibility-ms-compat
>.
Boost поставляет несколько макросов, чтобы упростить управление видимостью символа таким образом, чтобы он был переносим между компиляторами и операционными системами.
Макро |
Описание |
---|---|
< |
Определяет синтаксис расширения языка C++, который указывает, что символ должен быть экспортирован из общей библиотеки. Если компилятор не имеет такого расширения, макрос определяется без замены текста. |
< |
Определяет синтаксис расширения языка C++, который указывает, что символ должен быть импортирован из общей библиотеки. Если компилятор не имеет такого расширения, макрос определяется без замены текста. |
< |
Определяет синтаксис расширения языка C++, который указывает, что символ должен быть глобально видимым. Если компилятор не имеет такого расширения, макрос определяется без замены текста. Необходим для классов, которые иначе не экспортируются, а используются РТТИ. Примеры включают класс для объектов, которые будут выброшены в виде исключений или использованы в динамических передачах, через общие границы библиотеки. Например, класс исключений только для заголовков может выглядеть так: <classBOOST_SYMBOL_VISIBLEmy_exception:publicstd::runtime_error{...};> Без BOOST_SYMBOL_VISIBLE было бы невозможно поймать мое исключение, выброшенное из общей библиотеки, составленной GCC, с опцией -fvisibility=hidden. |
< |
Компилятор имеет расширения C++< |
Типичное использование:
boost/foo/config.hpp
... #if defined(BOOST_ALL_DYN_LINK) || defined(BOOST_FOO_DYN_LINK) # if defined(BOOST_FOO_SOURCE) # define BOOST_FOO_DECL BOOST_SYMBOL_EXPORT # else # define BOOST_FOO_DECL BOOST_SYMBOL_IMPORT # endif #else # define BOOST_FOO_DECL #endif ...
boost/foo/foo.hpp
#include <boost/foo/config.hpp> ... class BOOST_FOO_DECL bar { ... }; ... void BOOST_FOO_DECL f(); ...
boost/libs/foo/src/foo.cpp
#define BOOST_FOO_SOURCE #include <boost/foo/foo.hpp> ... void BOOST_FOO_DECL f() { ... } ...
При связывании с предварительно собранной библиотекой важно, чтобы ABI, используемый компилятором при создании библиотеки, точно соответствовалABI, используемому кодом с использованием библиотеки. В этом случае ABI означает такие вещи, как используемая структура упаковки, используемая схема манглинга или размер некоторых типов (например, типов эмали). Это отдельно от таких вещей, как поддержка потоков или вариации библиотеки времени выполнения, с которыми приходится иметь дело при создании вариантов. Чтобы представить это в перспективе, есть один компилятор (Borland's), который имеет так много вариантов компилятора, которые вносят тонкие изменения в ABI, что, по крайней мере, в теории существует 3200 комбинаций, и это без учета вариаций библиотеки времени выполнения. К счастью, эти изменения могут управляться<#pragma
>, которые сообщают компилятору, что ABI использовать для типов, объявленных в вашей библиотеке. Чтобы избежать разбрызгивания<#pragma
>по всем заголовкам бустера, есть некоторые префиксы и суффиксы, которые выполняют работу. Типичным использованием является:
my_library.hpp
#ifndef MY_INCLUDE_GUARD #define MY_INCLUDE_GUARD // all includes go here:#include <boost/config.hpp>
#include <whatever>#include <boost/config/abi_prefix.hpp>
// must be the last #include namespace boost { // your code goes here }#include <boost/config/abi_suffix.hpp>
// pops abi_prefix.hpp pragmas #endif // include guard
my_library.cpp
... // nothing special need be done in the implementation file ...
Пользователь может отключить этот механизм, определив<BOOST_DISABLE_ABI_HEADERS
>, или они могут определить<BOOST_ABI_PREFIX
>и/или<BOOST_ABI_SUFFIX
>, чтобы указать на свои собственные заголовки префикса/суффикса, если они того пожелают.
Важно, чтобы пользователи ссылались на сборку библиотеки, которая была построена против той же библиотеки времени выполнения, против которой будет построено их приложение - если этого не произойдет, то библиотека не будет бинарно совместима с их собственным кодом - и существует высокая вероятность того, что их приложение будет испытывать сбои времени выполнения. Такие проблемы могут быть чрезвычайно трудоемкими и трудными для отладки, и часто приводят к разочарованию как пользователей, так и авторов (просто выбрать правильную библиотеку для ссылки не так просто, как кажется, когда их 6-8 из них на выбор, и некоторые пользователи, кажется, блаженно не знают, что для них даже доступны различные среды выполнения).
Чтобы решить эту проблему, некоторые компиляторы позволяют исходному коду содержать<#pragma
>, которые инструктируют линкера, с какой библиотекой связываться, все, что нужно пользователю, это включить заголовки, которые им нужны, поместить скомпилированные библиотеки в свой путь поиска библиотеки, а компилятор и линкер сделать все остальное. Boost.config поддерживает это через заголовок<<boost/config/auto_link.hpp>
>, прежде чем включать этот заголовок, необходимо определить один или несколько из следующих макросов:
BOOST_LIB_NAME
Требуется: Идентификатор, содержащий имя базы библиотеки, например «boost_regex».
BOOST_DYN_LINK
Необязательно: при установке ссылки на dll, а не на статическую библиотеку.
BOOST_LIB_DIAGNOSTIC
Необязательно: при установке заголовка будет распечатываться название выбранной библиотеки (полезно для отладки).
Если компилятор поддерживает этот механизм, то ему будет предложено связать с соответствующим названием библиотеки, фактический алгоритм, используемый для спутывания имени библиотеки, документируется внутри<<boost/config/auto_link.hpp>
>и должен соответствовать тому, который используется для создания библиотек через правила установки bjam.
my_library.hpp
... // // Don't include auto-linking code if the user has disabled it by // defining BOOST_ALL_NO_LIB, or BOOST_MY_LIBRARY_NO_LIB, or if this // is one of our own source files (signified by BOOST_MY_LIBRARY_SOURCE): // #if !defined(BOOST_ALL_NO_LIB) && !defined(BOOST_MY_LIBRARY_NO_LIB) && !defined(BOOST_MY_LIBRARY_SOURCE) # define BOOST_LIB_NAME boost_my_library # ifdef BOOST_MY_LIBRARY_DYN_LINK # define BOOST_DYN_LINK # endif # include <boost/config/auto_link.hpp> #endif ...
my_library.cpp
// define BOOST_MY_LIBRARY_SOURCE so that the header knows that the // library is being built (possibly exporting rather than importing code) // #define BOOST_MY_LIBRARY_SOURCE #include <boost/my_library/my_library.hpp> ...
Статья Boost Macro Reference раздела Boost.Config Boost.Config может быть полезна для разработчиков на c++ и boost.
Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.
:: Главная :: Boost.Config ::
реклама |