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 // Workaround for the unfortunate min/max macros defined by some platform headers
290 #define BOOST_PREVENT_MACRO_SUBSTITUTION
292 #ifndef BOOST_USING_STD_MIN
293 # define BOOST_USING_STD_MIN() using std::min
296 #ifndef BOOST_USING_STD_MAX
297 # define BOOST_USING_STD_MAX() using std::max
300 // BOOST_NO_STD_MIN_MAX workaround -----------------------------------------//
302 # ifdef BOOST_NO_STD_MIN_MAX
306 inline const _Tp& min BOOST_PREVENT_MACRO_SUBSTITUTION (const _Tp& __a, const _Tp& __b) {
307 return __b < __a ? __b : __a;
310 inline const _Tp& max BOOST_PREVENT_MACRO_SUBSTITUTION (const _Tp& __a, const _Tp& __b) {
311 return __a < __b ? __b : __a;
317 // BOOST_STATIC_CONSTANT workaround --------------------------------------- //
318 // On compilers which don't allow in-class initialization of static integral
319 // constant members, we must use enums as a workaround if we want the constants
320 // to be available at compile-time. This macro gives us a convenient way to
321 // declare such constants.
323 # ifdef BOOST_NO_INCLASS_MEMBER_INITIALIZATION
324 # define BOOST_STATIC_CONSTANT(type, assignment) enum { assignment }
326 # define BOOST_STATIC_CONSTANT(type, assignment) static const type assignment
329 // BOOST_USE_FACET / HAS_FACET workaround ----------------------------------//
330 // When the standard library does not have a conforming std::use_facet there
331 // are various workarounds available, but they differ from library to library.
332 // The same problem occurs with has_facet.
333 // These macros provide a consistent way to access a locale's facets.
336 // std::use_facet<Type>(loc);
338 // BOOST_USE_FACET(Type, loc);
339 // Note do not add a std:: prefix to the front of BOOST_USE_FACET!
340 // Use for BOOST_HAS_FACET is analagous.
342 #if defined(BOOST_NO_STD_USE_FACET)
343 # ifdef BOOST_HAS_TWO_ARG_USE_FACET
344 # define BOOST_USE_FACET(Type, loc) std::use_facet(loc, static_cast<Type*>(0))
345 # define BOOST_HAS_FACET(Type, loc) std::has_facet(loc, static_cast<Type*>(0))
346 # elif defined(BOOST_HAS_MACRO_USE_FACET)
347 # define BOOST_USE_FACET(Type, loc) std::_USE(loc, Type)
348 # define BOOST_HAS_FACET(Type, loc) std::_HAS(loc, Type)
349 # elif defined(BOOST_HAS_STLP_USE_FACET)
350 # define BOOST_USE_FACET(Type, loc) (*std::_Use_facet<Type >(loc))
351 # define BOOST_HAS_FACET(Type, loc) std::has_facet< Type >(loc)
354 # define BOOST_USE_FACET(Type, loc) std::use_facet< Type >(loc)
355 # define BOOST_HAS_FACET(Type, loc) std::has_facet< Type >(loc)
358 // BOOST_NESTED_TEMPLATE workaround ------------------------------------------//
359 // Member templates are supported by some compilers even though they can't use
360 // the A::template member<U> syntax, as a workaround replace:
362 // typedef typename A::template rebind<U> binder;
366 // typedef typename A::BOOST_NESTED_TEMPLATE rebind<U> binder;
368 #ifndef BOOST_NO_MEMBER_TEMPLATE_KEYWORD
369 # define BOOST_NESTED_TEMPLATE template
371 # define BOOST_NESTED_TEMPLATE
374 // BOOST_UNREACHABLE_RETURN(x) workaround -------------------------------------//
375 // Normally evaluates to nothing, unless BOOST_NO_UNREACHABLE_RETURN_DETECTION
376 // is defined, in which case it evaluates to return x; Use when you have a return
377 // statement that can never be reached.
379 #ifdef BOOST_NO_UNREACHABLE_RETURN_DETECTION
380 # define BOOST_UNREACHABLE_RETURN(x) return x;
382 # define BOOST_UNREACHABLE_RETURN(x)
385 // BOOST_DEDUCED_TYPENAME workaround ------------------------------------------//
387 // Some compilers don't support the use of `typename' for dependent
388 // types in deduced contexts, e.g.
390 // template <class T> void f(T, typename T::type);
392 // Replace these declarations with:
394 // template <class T> void f(T, BOOST_DEDUCED_TYPENAME T::type);
396 #ifndef BOOST_NO_DEDUCED_TYPENAME
397 # define BOOST_DEDUCED_TYPENAME typename
399 # define BOOST_DEDUCED_TYPENAME
402 // long long workaround ------------------------------------------//
403 // On gcc (and maybe other compilers?) long long is alway supported
404 // but it's use may generate either warnings (with -ansi), or errors
405 // (with -pedantic -ansi) unless it's use is prefixed by __extension__
407 #if defined(BOOST_HAS_LONG_LONG)
410 __extension__ typedef long long long_long_type;
411 __extension__ typedef unsigned long long ulong_long_type;
413 typedef long long long_long_type;
414 typedef unsigned long long ulong_long_type;
419 // BOOST_[APPEND_]EXPLICIT_TEMPLATE_[NON_]TYPE macros --------------------------//
421 // Some compilers have problems with function templates whose
422 // template parameters don't appear in the function parameter
423 // list (basically they just link one instantiation of the
424 // template in the final executable). These macros provide a
425 // uniform way to cope with the problem with no effects on the
430 // #include <iostream>
431 // #include <ostream>
432 // #include <typeinfo>
435 // void f() { std::cout << n << ' '; }
437 // template <typename T>
438 // void g() { std::cout << typeid(T).name() << ' '; }
448 // With VC++ 6.0 the output is:
455 // void f(BOOST_EXPLICIT_TEMPLATE_NON_TYPE(int, n)) { ... }
457 // template <typename T>
458 // void g(BOOST_EXPLICIT_TEMPLATE_TYPE(T)) { ... }
462 #if defined BOOST_NO_EXPLICIT_FUNCTION_TEMPLATE_ARGUMENTS
464 # include "boost/type.hpp"
465 # include "boost/non_type.hpp"
467 # define BOOST_EXPLICIT_TEMPLATE_TYPE(t) boost::type<t>* = 0
468 # define BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t) boost::type<t>*
469 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v) boost::non_type<t, v>* = 0
470 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v) boost::non_type<t, v>*
472 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(t) \
473 , BOOST_EXPLICIT_TEMPLATE_TYPE(t)
474 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE_SPEC(t) \
475 , BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
476 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE(t, v) \
477 , BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
478 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v) \
479 , BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
483 // no workaround needed: expand to nothing
485 # define BOOST_EXPLICIT_TEMPLATE_TYPE(t)
486 # define BOOST_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
487 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
488 # define BOOST_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
490 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(t)
491 # define BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE_SPEC(t)
492 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE(t, v)
493 # define BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE_SPEC(t, v)
496 #endif // defined BOOST_NO_EXPLICIT_FUNCTION_TEMPLATE_ARGUMENTS
499 // ---------------------------------------------------------------------------//
502 // Helper macro BOOST_STRINGIZE:
503 // Converts the parameter X to a string after macro replacement
504 // on X has been performed.
506 #define BOOST_STRINGIZE(X) BOOST_DO_STRINGIZE(X)
507 #define BOOST_DO_STRINGIZE(X) #X
510 // Helper macro BOOST_JOIN:
511 // The following piece of macro magic joins the two
512 // arguments together, even when one of the arguments is
513 // itself a macro (see 16.3.1 in C++ standard). The key
514 // is that macro expansion of macro arguments does not
515 // occur in BOOST_DO_JOIN2 but does in BOOST_DO_JOIN.
517 #define BOOST_JOIN( X, Y ) BOOST_DO_JOIN( X, Y )
518 #define BOOST_DO_JOIN( X, Y ) BOOST_DO_JOIN2(X,Y)
519 #define BOOST_DO_JOIN2( X, Y ) X##Y
522 // Set some default values for compiler/library/platform names.
523 // These are for debugging config setup only:
525 # ifndef BOOST_COMPILER
526 # define BOOST_COMPILER "Unknown ISO C++ Compiler"
528 # ifndef BOOST_STDLIB
529 # define BOOST_STDLIB "Unknown ISO standard library"
531 # ifndef BOOST_PLATFORM
532 # if defined(unix) || defined(__unix) || defined(_XOPEN_SOURCE) \
533 || defined(_POSIX_SOURCE)
534 # define BOOST_PLATFORM "Generic Unix"
536 # define BOOST_PLATFORM "Unknown"