1 // Boost config.hpp configuration header file ------------------------------//
3 // (C) Copyright John Maddock 2001 - 2003.
4 // (C) Copyright Darin Adler 2001.
5 // (C) Copyright Peter Dimov 2001.
6 // (C) Copyright Bill Kempf 2002.
7 // (C) Copyright Jens Maurer 2002.
8 // (C) Copyright David Abrahams 2002 - 2003.
9 // (C) Copyright Gennaro Prota 2003.
10 // (C) Copyright Eric Friedman 2003.
11 // Use, modification and distribution are subject to the
12 // Boost Software License, Version 1.0. (See accompanying file
13 // LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
15 // See http://www.boost.org for most recent version.
17 // Boost config.hpp policy and rationale documentation has been moved to
18 // http://www.boost.org/libs/config
20 // This file is intended to be stable, and relatively unchanging.
21 // It should contain boilerplate code only - no compiler specific
22 // code unless it is unavoidable - no changes unless unavoidable.
24 #ifndef BOOST_CONFIG_SUFFIX_HPP
25 #define BOOST_CONFIG_SUFFIX_HPP
28 // look for long long by looking for the appropriate macros in <limits.h>.
29 // Note that we use limits.h rather than climits for maximal portability,
30 // remember that since these just declare a bunch of macros, there should be
31 // no namespace issues from this.
34 # if !defined(BOOST_HAS_LONG_LONG) \
35 && !(defined(BOOST_MSVC) && BOOST_MSVC <=1300) && !defined(__BORLANDC__) \
36 && (defined(ULLONG_MAX) || defined(ULONG_LONG_MAX) || defined(ULONGLONG_MAX))
37 # define BOOST_HAS_LONG_LONG
39 #if !defined(BOOST_HAS_LONG_LONG) && !defined(BOOST_NO_INTEGRAL_INT64_T)
40 # define BOOST_NO_INTEGRAL_INT64_T
43 // GCC 3.x will clean up all of those nasty macro definitions that
44 // BOOST_NO_CTYPE_FUNCTIONS is intended to help work around, so undefine
46 #if defined(__GNUC__) && (__GNUC__ >= 3) && defined(BOOST_NO_CTYPE_FUNCTIONS)
47 # undef BOOST_NO_CTYPE_FUNCTIONS
52 // Assume any extensions are in namespace std:: unless stated otherwise:
54 # ifndef BOOST_STD_EXTENSION_NAMESPACE
55 # define BOOST_STD_EXTENSION_NAMESPACE std
59 // If cv-qualified specializations are not allowed, then neither are cv-void ones:
61 # if defined(BOOST_NO_CV_SPECIALIZATIONS) \
62 && !defined(BOOST_NO_CV_VOID_SPECIALIZATIONS)
63 # define BOOST_NO_CV_VOID_SPECIALIZATIONS
67 // If there is no numeric_limits template, then it can't have any compile time
70 # if defined(BOOST_NO_LIMITS) \
71 && !defined(BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS)
72 # define BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS
73 # define BOOST_NO_MS_INT64_NUMERIC_LIMITS
74 # define BOOST_NO_LONG_LONG_NUMERIC_LIMITS
78 // if there is no long long then there is no specialisation
79 // for numeric_limits<long long> either:
81 #if !defined(BOOST_HAS_LONG_LONG) && !defined(BOOST_NO_LONG_LONG_NUMERIC_LIMITS)
82 # define BOOST_NO_LONG_LONG_NUMERIC_LIMITS
86 // if there is no __int64 then there is no specialisation
87 // for numeric_limits<__int64> either:
89 #if !defined(BOOST_HAS_MS_INT64) && !defined(BOOST_NO_MS_INT64_NUMERIC_LIMITS)
90 # define BOOST_NO_MS_INT64_NUMERIC_LIMITS
94 // if member templates are supported then so is the
95 // VC6 subset of member templates:
97 # if !defined(BOOST_NO_MEMBER_TEMPLATES) \
98 && !defined(BOOST_MSVC6_MEMBER_TEMPLATES)
99 # define BOOST_MSVC6_MEMBER_TEMPLATES
103 // Without partial specialization, can't test for partial specialisation bugs:
105 # if defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) \
106 && !defined(BOOST_BCB_PARTIAL_SPECIALIZATION_BUG)
107 # define BOOST_BCB_PARTIAL_SPECIALIZATION_BUG
111 // Without partial specialization, we can't have array-type partial specialisations:
113 # if defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) \
114 && !defined(BOOST_NO_ARRAY_TYPE_SPECIALIZATIONS)
115 # define BOOST_NO_ARRAY_TYPE_SPECIALIZATIONS
119 // Without partial specialization, std::iterator_traits can't work:
121 # if defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) \
122 && !defined(BOOST_NO_STD_ITERATOR_TRAITS)
123 # define BOOST_NO_STD_ITERATOR_TRAITS
127 // Without member template support, we can't have template constructors
128 // in the standard library either:
130 # if defined(BOOST_NO_MEMBER_TEMPLATES) \
131 && !defined(BOOST_MSVC6_MEMBER_TEMPLATES) \
132 && !defined(BOOST_NO_TEMPLATED_ITERATOR_CONSTRUCTORS)
133 # define BOOST_NO_TEMPLATED_ITERATOR_CONSTRUCTORS
137 // Without member template support, we can't have a conforming
138 // std::allocator template either:
140 # if defined(BOOST_NO_MEMBER_TEMPLATES) \
141 && !defined(BOOST_MSVC6_MEMBER_TEMPLATES) \
142 && !defined(BOOST_NO_STD_ALLOCATOR)
143 # define BOOST_NO_STD_ALLOCATOR
147 // without ADL support then using declarations will break ADL as well:
149 #if defined(BOOST_NO_ARGUMENT_DEPENDENT_LOOKUP) && !defined(BOOST_FUNCTION_SCOPE_USING_DECLARATION_BREAKS_ADL)
150 # define BOOST_FUNCTION_SCOPE_USING_DECLARATION_BREAKS_ADL
154 // If we have a standard allocator, then we have a partial one as well:
156 #if !defined(BOOST_NO_STD_ALLOCATOR)
157 # define BOOST_HAS_PARTIAL_STD_ALLOCATOR
161 // We can't have a working std::use_facet if there is no std::locale:
163 # if defined(BOOST_NO_STD_LOCALE) && !defined(BOOST_NO_STD_USE_FACET)
164 # define BOOST_NO_STD_USE_FACET
168 // We can't have a std::messages facet if there is no std::locale:
170 # if defined(BOOST_NO_STD_LOCALE) && !defined(BOOST_NO_STD_MESSAGES)
171 # define BOOST_NO_STD_MESSAGES
175 // We can't have a working std::wstreambuf if there is no std::locale:
177 # if defined(BOOST_NO_STD_LOCALE) && !defined(BOOST_NO_STD_WSTREAMBUF)
178 # define BOOST_NO_STD_WSTREAMBUF
182 // We can't have a <cwctype> if there is no <cwchar>:
184 # if defined(BOOST_NO_CWCHAR) && !defined(BOOST_NO_CWCTYPE)
185 # define BOOST_NO_CWCTYPE
189 // We can't have a swprintf if there is no <cwchar>:
191 # if defined(BOOST_NO_CWCHAR) && !defined(BOOST_NO_SWPRINTF)
192 # define BOOST_NO_SWPRINTF
196 // If Win32 support is turned off, then we must turn off
197 // threading support also, unless there is some other
198 // thread API enabled:
200 #if defined(BOOST_DISABLE_WIN32) && defined(_WIN32) \
201 && !defined(BOOST_DISABLE_THREADS) && !defined(BOOST_HAS_PTHREADS)
202 # define BOOST_DISABLE_THREADS
206 // Turn on threading support if the compiler thinks that it's in
207 // multithreaded mode. We put this here because there are only a
208 // limited number of macros that identify this (if there's any missing
209 // from here then add to the appropriate compiler section):
211 #if (defined(__MT__) || defined(_MT) || defined(_REENTRANT) \
212 || defined(_PTHREADS)) && !defined(BOOST_HAS_THREADS)
213 # define BOOST_HAS_THREADS
217 // Turn threading support off if BOOST_DISABLE_THREADS is defined:
219 #if defined(BOOST_DISABLE_THREADS) && defined(BOOST_HAS_THREADS)
220 # undef BOOST_HAS_THREADS
224 // Turn threading support off if we don't recognise the threading API:
226 #if defined(BOOST_HAS_THREADS) && !defined(BOOST_HAS_PTHREADS)\
227 && !defined(BOOST_HAS_WINTHREADS) && !defined(BOOST_HAS_BETHREADS)\
228 && !defined(BOOST_HAS_MPTASKS)
229 # undef BOOST_HAS_THREADS
233 // Turn threading detail macros off if we don't (want to) use threading
235 #ifndef BOOST_HAS_THREADS
236 # undef BOOST_HAS_PTHREADS
237 # undef BOOST_HAS_PTHREAD_MUTEXATTR_SETTYPE
238 # undef BOOST_HAS_WINTHREADS
239 # undef BOOST_HAS_BETHREADS
240 # undef BOOST_HAS_MPTASKS
244 // If the compiler claims to be C99 conformant, then it had better
245 // have a <stdint.h>:
247 # if defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901)
248 # define BOOST_HAS_STDINT_H
252 // Define BOOST_NO_SLIST and BOOST_NO_HASH if required.
253 // Note that this is for backwards compatibility only.
255 # ifndef BOOST_HAS_SLIST
256 # define BOOST_NO_SLIST
259 # ifndef BOOST_HAS_HASH
260 # define BOOST_NO_HASH
263 // BOOST_HAS_ABI_HEADERS
264 // This macro gets set if we have headers that fix the ABI,
265 // and prevent ODR violations when linking to external libraries:
266 #if defined(BOOST_ABI_PREFIX) && defined(BOOST_ABI_SUFFIX) && !defined(BOOST_HAS_ABI_HEADERS)
267 # define BOOST_HAS_ABI_HEADERS
270 #if defined(BOOST_HAS_ABI_HEADERS) && defined(BOOST_DISABLE_ABI_HEADERS)
271 # undef BOOST_HAS_ABI_HEADERS
274 // BOOST_NO_STDC_NAMESPACE workaround --------------------------------------//
275 // Because std::size_t usage is so common, even in boost headers which do not
276 // otherwise use the C library, the <cstddef> workaround is included here so
277 // that ugly workaround code need not appear in many other boost headers.
278 // NOTE WELL: This is a workaround for non-conforming compilers; <cstddef>
279 // must still be #included in the usual places so that <cstddef> inclusion
280 // works as expected with standard conforming compilers. The resulting
281 // double inclusion of <cstddef> is harmless.
283 # ifdef BOOST_NO_STDC_NAMESPACE
285 namespace std { using ::ptrdiff_t; using ::size_t; }
288 // BOOST_NO_STD_MIN_MAX workaround -----------------------------------------//
290 # ifdef BOOST_NO_STD_MIN_MAX
294 inline const _Tp& min(const _Tp& __a, const _Tp& __b) {
295 return __b < __a ? __b : __a;
298 inline const _Tp& max(const _Tp& __a, const _Tp& __b) {
299 return __a < __b ? __b : __a;
305 // BOOST_STATIC_CONSTANT workaround --------------------------------------- //
306 // On compilers which don't allow in-class initialization of static integral
307 // constant members, we must use enums as a workaround if we want the constants
308 // to be available at compile-time. This macro gives us a convenient way to
309 // declare such constants.
311 # ifdef BOOST_NO_INCLASS_MEMBER_INITIALIZATION
312 # define BOOST_STATIC_CONSTANT(type, assignment) enum { assignment }
314 # define BOOST_STATIC_CONSTANT(type, assignment) static const type assignment
317 // BOOST_USE_FACET workaround ----------------------------------------------//
318 // When the standard library does not have a conforming std::use_facet there
319 // are various workarounds available, but they differ from library to library.
320 // This macro provides a consistent way to access a locale's facets.
323 // std::use_facet<Type>(loc);
325 // BOOST_USE_FACET(Type, loc);
326 // Note do not add a std:: prefix to the front of BOOST_USE_FACET!
328 #if defined(BOOST_NO_STD_USE_FACET)
329 # ifdef BOOST_HAS_TWO_ARG_USE_FACET
330 # define BOOST_USE_FACET(Type, loc) std::use_facet(loc, static_cast<Type*>(0))
331 # elif defined(BOOST_HAS_MACRO_USE_FACET)
332 # define BOOST_USE_FACET(Type, loc) std::_USE(loc, Type)
333 # elif defined(BOOST_HAS_STLP_USE_FACET)
334 # define BOOST_USE_FACET(Type, loc) (*std::_Use_facet<Type >(loc))
337 # define BOOST_USE_FACET(Type, loc) std::use_facet< Type >(loc)
340 // BOOST_NESTED_TEMPLATE workaround ------------------------------------------//
341 // Member templates are supported by some compilers even though they can't use
342 // the A::template member<U> syntax, as a workaround replace:
344 // typedef typename A::template rebind<U> binder;
348 // typedef typename A::BOOST_NESTED_TEMPLATE rebind<U> binder;
350 #ifndef BOOST_NO_MEMBER_TEMPLATE_KEYWORD
351 # define BOOST_NESTED_TEMPLATE template
353 # define BOOST_NESTED_TEMPLATE
356 // BOOST_UNREACHABLE_RETURN(x) workaround -------------------------------------//
357 // Normally evaluates to nothing, unless BOOST_NO_UNREACHABLE_RETURN_DETECTION
358 // is defined, in which case it evaluates to return x; Use when you have a return
359 // statement that can never be reached.
361 #ifdef BOOST_NO_UNREACHABLE_RETURN_DETECTION
362 # define BOOST_UNREACHABLE_RETURN(x) return x;
364 # define BOOST_UNREACHABLE_RETURN(x)
367 // BOOST_DEDUCED_TYPENAME workaround ------------------------------------------//
369 // Some compilers don't support the use of `typename' for dependent
370 // types in deduced contexts, e.g.
372 // template <class T> void f(T, typename T::type);
374 // Replace these declarations with:
376 // template <class T> void f(T, BOOST_DEDUCED_TYPENAME T::type);
378 #ifndef BOOST_NO_DEDUCED_TYPENAME
379 # define BOOST_DEDUCED_TYPENAME typename
381 # define BOOST_DEDUCED_TYPENAME
384 // BOOST_[APPEND_]EXPLICIT_TEMPLATE_[NON_]TYPE macros --------------------------//
386 // Some compilers have problems with function templates whose
387 // template parameters don't appear in the function parameter
388 // list (basically they just link one instantiation of the
389 // template in the final executable). These macros provide a
390 // uniform way to cope with the problem with no effects on the
395 // #include <iostream>
396 // #include <ostream>
397 // #include <typeinfo>
400 // void f() { std::cout << n << ' '; }
402 // template <typename T>
403 // void g() { std::cout << typeid(T).name() << ' '; }
413 // With VC++ 6.0 the output is:
420 // void f(BOOST_EXPLICIT_TEMPLATE_NON_TYPE(int, n)) { ... }
422 // template <typename T>
423 // void g(BOOST_EXPLICIT_TEMPLATE_TYPE(T)) { ... }
427 #if defined BOOST_NO_EXPLICIT_FUNCTION_TEMPLATE_ARGUMENTS
429 # include "boost/type.hpp"
430 # include "boost/non_type.hpp"
432 # define BOOST_EXPLICIT_TEMPLATE_TYPE(t) boost::type<t>* = 0
433 # define BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t) boost::type<t>*
434 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v) boost::non_type<t, v>* = 0
435 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v) boost::non_type<t, v>*
437 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(t) \
438 , BOOST_EXPLICIT_TEMPLATE_TYPE(t)
439 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE_SPEC(t) \
440 , BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
441 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE(t, v) \
442 , BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
443 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v) \
444 , BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
448 // no workaround needed: expand to nothing
450 # define BOOST_EXPLICIT_TEMPLATE_TYPE(t)
451 # define BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
452 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
453 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
455 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(t)
456 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
457 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
458 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
461 #endif // defined BOOST_NO_EXPLICIT_FUNCTION_TEMPLATE_ARGUMENTS
464 // ---------------------------------------------------------------------------//
467 // Helper macro BOOST_STRINGIZE:
468 // Converts the parameter X to a string after macro replacement
469 // on X has been performed.
471 #define BOOST_STRINGIZE(X) BOOST_DO_STRINGIZE(X)
472 #define BOOST_DO_STRINGIZE(X) #X
475 // Helper macro BOOST_JOIN:
476 // The following piece of macro magic joins the two
477 // arguments together, even when one of the arguments is
478 // itself a macro (see 16.3.1 in C++ standard). The key
479 // is that macro expansion of macro arguments does not
480 // occur in BOOST_DO_JOIN2 but does in BOOST_DO_JOIN.
482 #define BOOST_JOIN( X, Y ) BOOST_DO_JOIN( X, Y )
483 #define BOOST_DO_JOIN( X, Y ) BOOST_DO_JOIN2(X,Y)
484 #define BOOST_DO_JOIN2( X, Y ) X##Y
487 // Set some default values for compiler/library/platform names.
488 // These are for debugging config setup only:
490 # ifndef BOOST_COMPILER
491 # define BOOST_COMPILER "Unknown ISO C++ Compiler"
493 # ifndef BOOST_STDLIB
494 # define BOOST_STDLIB "Unknown ISO standard library"
496 # ifndef BOOST_PLATFORM
497 # if defined(unix) || defined(__unix) || defined(_XOPEN_SOURCE) \
498 || defined(_POSIX_SOURCE)
499 # define BOOST_PLATFORM "Generic Unix"
501 # define BOOST_PLATFORM "Unknown"