427 lines
16 KiB
C++
427 lines
16 KiB
C++
//
|
|
// Copyright 2017 The Abseil Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//
|
|
// -----------------------------------------------------------------------------
|
|
// File: config.h
|
|
// -----------------------------------------------------------------------------
|
|
//
|
|
// This header file defines a set of macros for checking the presence of
|
|
// important compiler and platform features. Such macros can be used to
|
|
// produce portable code by parameterizing compilation based on the presence or
|
|
// lack of a given feature.
|
|
//
|
|
// We define a "feature" as some interface we wish to program to: for example,
|
|
// a library function or system call. A value of `1` indicates support for
|
|
// that feature; any other value indicates the feature support is undefined.
|
|
//
|
|
// Example:
|
|
//
|
|
// Suppose a programmer wants to write a program that uses the 'mmap()' system
|
|
// call. The Abseil macro for that feature (`ABSL_HAVE_MMAP`) allows you to
|
|
// selectively include the `mmap.h` header and bracket code using that feature
|
|
// in the macro:
|
|
//
|
|
// #include "absl/base/config.h"
|
|
//
|
|
// #ifdef ABSL_HAVE_MMAP
|
|
// #include "sys/mman.h"
|
|
// #endif //ABSL_HAVE_MMAP
|
|
//
|
|
// ...
|
|
// #ifdef ABSL_HAVE_MMAP
|
|
// void *ptr = mmap(...);
|
|
// ...
|
|
// #endif // ABSL_HAVE_MMAP
|
|
|
|
#ifndef ABSL_BASE_CONFIG_H_
|
|
#define ABSL_BASE_CONFIG_H_
|
|
|
|
// Included for the __GLIBC__ macro (or similar macros on other systems).
|
|
#include <limits.h>
|
|
|
|
#ifdef __cplusplus
|
|
// Included for __GLIBCXX__, _LIBCPP_VERSION
|
|
#include <cstddef>
|
|
#endif // __cplusplus
|
|
|
|
#if defined(__APPLE__)
|
|
// Included for TARGET_OS_IPHONE, __IPHONE_OS_VERSION_MIN_REQUIRED,
|
|
// __IPHONE_8_0.
|
|
#include <Availability.h>
|
|
#include <TargetConditionals.h>
|
|
#endif
|
|
|
|
#include "absl/base/policy_checks.h"
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Compiler Feature Checks
|
|
// -----------------------------------------------------------------------------
|
|
|
|
// ABSL_HAVE_BUILTIN()
|
|
//
|
|
// Checks whether the compiler supports a Clang Feature Checking Macro, and if
|
|
// so, checks whether it supports the provided builtin function "x" where x
|
|
// is one of the functions noted in
|
|
// https://clang.llvm.org/docs/LanguageExtensions.html
|
|
//
|
|
// Note: Use this macro to avoid an extra level of #ifdef __has_builtin check.
|
|
// http://releases.llvm.org/3.3/tools/clang/docs/LanguageExtensions.html
|
|
#ifdef __has_builtin
|
|
#define ABSL_HAVE_BUILTIN(x) __has_builtin(x)
|
|
#else
|
|
#define ABSL_HAVE_BUILTIN(x) 0
|
|
#endif
|
|
|
|
// ABSL_HAVE_TLS is defined to 1 when __thread should be supported.
|
|
// We assume __thread is supported on Linux when compiled with Clang or compiled
|
|
// against libstdc++ with _GLIBCXX_HAVE_TLS defined.
|
|
#ifdef ABSL_HAVE_TLS
|
|
#error ABSL_HAVE_TLS cannot be directly set
|
|
#elif defined(__linux__) && (defined(__clang__) || defined(_GLIBCXX_HAVE_TLS))
|
|
#define ABSL_HAVE_TLS 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_IS_TRIVIALLY_DESTRUCTIBLE
|
|
//
|
|
// Checks whether `std::is_trivially_destructible<T>` is supported.
|
|
//
|
|
// Notes: All supported compilers using libc++ support this feature, as does
|
|
// gcc >= 4.8.1 using libstdc++, and Visual Studio.
|
|
#ifdef ABSL_HAVE_STD_IS_TRIVIALLY_DESTRUCTIBLE
|
|
#error ABSL_HAVE_STD_IS_TRIVIALLY_DESTRUCTIBLE cannot be directly set
|
|
#elif defined(_LIBCPP_VERSION) || \
|
|
(!defined(__clang__) && defined(__GNUC__) && defined(__GLIBCXX__) && \
|
|
(__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 8))) || \
|
|
defined(_MSC_VER)
|
|
#define ABSL_HAVE_STD_IS_TRIVIALLY_DESTRUCTIBLE 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_IS_TRIVIALLY_CONSTRUCTIBLE
|
|
//
|
|
// Checks whether `std::is_trivially_default_constructible<T>` and
|
|
// `std::is_trivially_copy_constructible<T>` are supported.
|
|
|
|
// ABSL_HAVE_STD_IS_TRIVIALLY_ASSIGNABLE
|
|
//
|
|
// Checks whether `std::is_trivially_copy_assignable<T>` is supported.
|
|
|
|
// Notes: Clang with libc++ supports these features, as does gcc >= 5.1 with
|
|
// either libc++ or libstdc++, and Visual Studio.
|
|
#if defined(ABSL_HAVE_STD_IS_TRIVIALLY_CONSTRUCTIBLE)
|
|
#error ABSL_HAVE_STD_IS_TRIVIALLY_CONSTRUCTIBLE cannot be directly set
|
|
#elif defined(ABSL_HAVE_STD_IS_TRIVIALLY_ASSIGNABLE)
|
|
#error ABSL_HAVE_STD_IS_TRIVIALLY_ASSIGNABLE cannot directly set
|
|
#elif (defined(__clang__) && defined(_LIBCPP_VERSION)) || \
|
|
(!defined(__clang__) && defined(__GNUC__) && \
|
|
(__GNUC__ > 5 || (__GNUC__ == 5 && __GNUC_MINOR__ >= 1)) && \
|
|
(defined(_LIBCPP_VERSION) || defined(__GLIBCXX__))) || \
|
|
defined(_MSC_VER)
|
|
#define ABSL_HAVE_STD_IS_TRIVIALLY_CONSTRUCTIBLE 1
|
|
#define ABSL_HAVE_STD_IS_TRIVIALLY_ASSIGNABLE 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_THREAD_LOCAL
|
|
//
|
|
// Checks whether C++11's `thread_local` storage duration specifier is
|
|
// supported.
|
|
#ifdef ABSL_HAVE_THREAD_LOCAL
|
|
#error ABSL_HAVE_THREAD_LOCAL cannot be directly set
|
|
#elif defined(__APPLE__)
|
|
// Notes: Xcode's clang did not support `thread_local` until version
|
|
// 8, and even then not for all iOS < 9.0. Also, Xcode 9.3 started disallowing
|
|
// `thread_local` for 32-bit iOS simulator targeting iOS 9.x.
|
|
// `__has_feature` is only supported by Clang so it has be inside
|
|
// `defined(__APPLE__)` check.
|
|
#if __has_feature(cxx_thread_local)
|
|
#define ABSL_HAVE_THREAD_LOCAL 1
|
|
#endif
|
|
#else // !defined(__APPLE__)
|
|
#define ABSL_HAVE_THREAD_LOCAL 1
|
|
#endif
|
|
|
|
// There are platforms for which TLS should not be used even though the compiler
|
|
// makes it seem like it's supported (Android NDK < r12b for example).
|
|
// This is primarily because of linker problems and toolchain misconfiguration:
|
|
// Abseil does not intend to support this indefinitely. Currently, the newest
|
|
// toolchain that we intend to support that requires this behavior is the
|
|
// r11 NDK - allowing for a 5 year support window on that means this option
|
|
// is likely to be removed around June of 2021.
|
|
// TLS isn't supported until NDK r12b per
|
|
// https://developer.android.com/ndk/downloads/revision_history.html
|
|
// Since NDK r16, `__NDK_MAJOR__` and `__NDK_MINOR__` are defined in
|
|
// <android/ndk-version.h>. For NDK < r16, users should define these macros,
|
|
// e.g. `-D__NDK_MAJOR__=11 -D__NKD_MINOR__=0` for NDK r11.
|
|
#if defined(__ANDROID__) && defined(__clang__)
|
|
#if __has_include(<android/ndk-version.h>)
|
|
#include <android/ndk-version.h>
|
|
#endif // __has_include(<android/ndk-version.h>)
|
|
#if defined(__ANDROID__) && defined(__clang__) && defined(__NDK_MAJOR__) && \
|
|
defined(__NDK_MINOR__) && \
|
|
((__NDK_MAJOR__ < 12) || ((__NDK_MAJOR__ == 12) && (__NDK_MINOR__ < 1)))
|
|
#undef ABSL_HAVE_TLS
|
|
#undef ABSL_HAVE_THREAD_LOCAL
|
|
#endif
|
|
#endif // defined(__ANDROID__) && defined(__clang__)
|
|
|
|
// ABSL_HAVE_INTRINSIC_INT128
|
|
//
|
|
// Checks whether the __int128 compiler extension for a 128-bit integral type is
|
|
// supported.
|
|
//
|
|
// Note: __SIZEOF_INT128__ is defined by Clang and GCC when __int128 is
|
|
// supported, but we avoid using it in certain cases:
|
|
// * On Clang:
|
|
// * Building using Clang for Windows, where the Clang runtime library has
|
|
// 128-bit support only on LP64 architectures, but Windows is LLP64.
|
|
// * Building for aarch64, where __int128 exists but has exhibits a sporadic
|
|
// compiler crashing bug.
|
|
// * On Nvidia's nvcc:
|
|
// * nvcc also defines __GNUC__ and __SIZEOF_INT128__, but not all versions
|
|
// actually support __int128.
|
|
#ifdef ABSL_HAVE_INTRINSIC_INT128
|
|
#error ABSL_HAVE_INTRINSIC_INT128 cannot be directly set
|
|
#elif defined(__SIZEOF_INT128__)
|
|
#if (defined(__clang__) && !defined(_WIN32) && !defined(__aarch64__)) || \
|
|
(defined(__CUDACC__) && __CUDACC_VER_MAJOR__ >= 9) || \
|
|
(defined(__GNUC__) && !defined(__clang__) && !defined(__CUDACC__))
|
|
#define ABSL_HAVE_INTRINSIC_INT128 1
|
|
#elif defined(__CUDACC__)
|
|
// __CUDACC_VER__ is a full version number before CUDA 9, and is defined to a
|
|
// std::string explaining that it has been removed starting with CUDA 9. We use
|
|
// nested #ifs because there is no short-circuiting in the preprocessor.
|
|
// NOTE: `__CUDACC__` could be undefined while `__CUDACC_VER__` is defined.
|
|
#if __CUDACC_VER__ >= 70000
|
|
#define ABSL_HAVE_INTRINSIC_INT128 1
|
|
#endif // __CUDACC_VER__ >= 70000
|
|
#endif // defined(__CUDACC__)
|
|
#endif // ABSL_HAVE_INTRINSIC_INT128
|
|
|
|
// ABSL_HAVE_EXCEPTIONS
|
|
//
|
|
// Checks whether the compiler both supports and enables exceptions. Many
|
|
// compilers support a "no exceptions" mode that disables exceptions.
|
|
//
|
|
// Generally, when ABSL_HAVE_EXCEPTIONS is not defined:
|
|
//
|
|
// * Code using `throw` and `try` may not compile.
|
|
// * The `noexcept` specifier will still compile and behave as normal.
|
|
// * The `noexcept` operator may still return `false`.
|
|
//
|
|
// For further details, consult the compiler's documentation.
|
|
#ifdef ABSL_HAVE_EXCEPTIONS
|
|
#error ABSL_HAVE_EXCEPTIONS cannot be directly set.
|
|
|
|
#elif defined(__clang__)
|
|
// TODO(calabrese)
|
|
// Switch to using __cpp_exceptions when we no longer support versions < 3.6.
|
|
// For details on this check, see:
|
|
// http://releases.llvm.org/3.6.0/tools/clang/docs/ReleaseNotes.html#the-exceptions-macro
|
|
#if defined(__EXCEPTIONS) && __has_feature(cxx_exceptions)
|
|
#define ABSL_HAVE_EXCEPTIONS 1
|
|
#endif // defined(__EXCEPTIONS) && __has_feature(cxx_exceptions)
|
|
|
|
// Handle remaining special cases and default to exceptions being supported.
|
|
#elif !(defined(__GNUC__) && (__GNUC__ < 5) && !defined(__EXCEPTIONS)) && \
|
|
!(defined(__GNUC__) && (__GNUC__ >= 5) && !defined(__cpp_exceptions)) && \
|
|
!(defined(_MSC_VER) && !defined(_CPPUNWIND))
|
|
#define ABSL_HAVE_EXCEPTIONS 1
|
|
#endif
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// Platform Feature Checks
|
|
// -----------------------------------------------------------------------------
|
|
|
|
// Currently supported operating systems and associated preprocessor
|
|
// symbols:
|
|
//
|
|
// Linux and Linux-derived __linux__
|
|
// Android __ANDROID__ (implies __linux__)
|
|
// Linux (non-Android) __linux__ && !__ANDROID__
|
|
// Darwin (Mac OS X and iOS) __APPLE__
|
|
// Akaros (http://akaros.org) __ros__
|
|
// Windows _WIN32
|
|
// NaCL __native_client__
|
|
// AsmJS __asmjs__
|
|
// WebAssembly __wasm__
|
|
// Fuchsia __Fuchsia__
|
|
//
|
|
// Note that since Android defines both __ANDROID__ and __linux__, one
|
|
// may probe for either Linux or Android by simply testing for __linux__.
|
|
|
|
// ABSL_HAVE_MMAP
|
|
//
|
|
// Checks whether the platform has an mmap(2) implementation as defined in
|
|
// POSIX.1-2001.
|
|
#ifdef ABSL_HAVE_MMAP
|
|
#error ABSL_HAVE_MMAP cannot be directly set
|
|
#elif defined(__linux__) || defined(__APPLE__) || defined(__FreeBSD__) || \
|
|
defined(__ros__) || defined(__native_client__) || defined(__asmjs__) || \
|
|
defined(__wasm__) || defined(__Fuchsia__) || defined(__sun)
|
|
#define ABSL_HAVE_MMAP 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_PTHREAD_GETSCHEDPARAM
|
|
//
|
|
// Checks whether the platform implements the pthread_(get|set)schedparam(3)
|
|
// functions as defined in POSIX.1-2001.
|
|
#ifdef ABSL_HAVE_PTHREAD_GETSCHEDPARAM
|
|
#error ABSL_HAVE_PTHREAD_GETSCHEDPARAM cannot be directly set
|
|
#elif defined(__linux__) || defined(__APPLE__) || defined(__FreeBSD__) || \
|
|
defined(__ros__)
|
|
#define ABSL_HAVE_PTHREAD_GETSCHEDPARAM 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_SCHED_YIELD
|
|
//
|
|
// Checks whether the platform implements sched_yield(2) as defined in
|
|
// POSIX.1-2001.
|
|
#ifdef ABSL_HAVE_SCHED_YIELD
|
|
#error ABSL_HAVE_SCHED_YIELD cannot be directly set
|
|
#elif defined(__linux__) || defined(__ros__) || defined(__native_client__)
|
|
#define ABSL_HAVE_SCHED_YIELD 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_SEMAPHORE_H
|
|
//
|
|
// Checks whether the platform supports the <semaphore.h> header and sem_open(3)
|
|
// family of functions as standardized in POSIX.1-2001.
|
|
//
|
|
// Note: While Apple provides <semaphore.h> for both iOS and macOS, it is
|
|
// explicitly deprecated and will cause build failures if enabled for those
|
|
// platforms. We side-step the issue by not defining it here for Apple
|
|
// platforms.
|
|
#ifdef ABSL_HAVE_SEMAPHORE_H
|
|
#error ABSL_HAVE_SEMAPHORE_H cannot be directly set
|
|
#elif defined(__linux__) || defined(__ros__)
|
|
#define ABSL_HAVE_SEMAPHORE_H 1
|
|
#endif
|
|
|
|
// ABSL_HAVE_ALARM
|
|
//
|
|
// Checks whether the platform supports the <signal.h> header and alarm(2)
|
|
// function as standardized in POSIX.1-2001.
|
|
#ifdef ABSL_HAVE_ALARM
|
|
#error ABSL_HAVE_ALARM cannot be directly set
|
|
#elif defined(__GOOGLE_GRTE_VERSION__)
|
|
// feature tests for Google's GRTE
|
|
#define ABSL_HAVE_ALARM 1
|
|
#elif defined(__GLIBC__)
|
|
// feature test for glibc
|
|
#define ABSL_HAVE_ALARM 1
|
|
#elif defined(_MSC_VER)
|
|
// feature tests for Microsoft's library
|
|
#elif defined(__native_client__)
|
|
#else
|
|
// other standard libraries
|
|
#define ABSL_HAVE_ALARM 1
|
|
#endif
|
|
|
|
// ABSL_IS_LITTLE_ENDIAN
|
|
// ABSL_IS_BIG_ENDIAN
|
|
//
|
|
// Checks the endianness of the platform.
|
|
//
|
|
// Notes: uses the built in endian macros provided by GCC (since 4.6) and
|
|
// Clang (since 3.2); see
|
|
// https://gcc.gnu.org/onlinedocs/cpp/Common-Predefined-Macros.html.
|
|
// Otherwise, if _WIN32, assume little endian. Otherwise, bail with an error.
|
|
#if defined(ABSL_IS_BIG_ENDIAN)
|
|
#error "ABSL_IS_BIG_ENDIAN cannot be directly set."
|
|
#endif
|
|
#if defined(ABSL_IS_LITTLE_ENDIAN)
|
|
#error "ABSL_IS_LITTLE_ENDIAN cannot be directly set."
|
|
#endif
|
|
|
|
#if (defined(__BYTE_ORDER__) && defined(__ORDER_LITTLE_ENDIAN__) && \
|
|
__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__)
|
|
#define ABSL_IS_LITTLE_ENDIAN 1
|
|
#elif defined(__BYTE_ORDER__) && defined(__ORDER_BIG_ENDIAN__) && \
|
|
__BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
|
|
#define ABSL_IS_BIG_ENDIAN 1
|
|
#elif defined(_WIN32)
|
|
#define ABSL_IS_LITTLE_ENDIAN 1
|
|
#else
|
|
#error "absl endian detection needs to be set up for your compiler"
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_ANY
|
|
//
|
|
// Checks whether C++17 std::any is available by checking whether <any> exists.
|
|
#ifdef ABSL_HAVE_STD_ANY
|
|
#error "ABSL_HAVE_STD_ANY cannot be directly set."
|
|
#endif
|
|
|
|
#ifdef __has_include
|
|
#if __has_include(<any>) && __cplusplus >= 201703L
|
|
#define ABSL_HAVE_STD_ANY 1
|
|
#endif
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_OPTIONAL
|
|
//
|
|
// Checks whether C++17 std::optional is available.
|
|
#ifdef ABSL_HAVE_STD_OPTIONAL
|
|
#error "ABSL_HAVE_STD_OPTIONAL cannot be directly set."
|
|
#endif
|
|
|
|
#ifdef __has_include
|
|
#if __has_include(<optional>) && __cplusplus >= 201703L
|
|
#define ABSL_HAVE_STD_OPTIONAL 1
|
|
#endif
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_VARIANT
|
|
//
|
|
// Checks whether C++17 std::variant is available.
|
|
#ifdef ABSL_HAVE_STD_VARIANT
|
|
#error "ABSL_HAVE_STD_VARIANT cannot be directly set."
|
|
#endif
|
|
|
|
#ifdef __has_include
|
|
#if __has_include(<variant>) && __cplusplus >= 201703L
|
|
#define ABSL_HAVE_STD_VARIANT 1
|
|
#endif
|
|
#endif
|
|
|
|
// ABSL_HAVE_STD_STRING_VIEW
|
|
//
|
|
// Checks whether C++17 std::string_view is available.
|
|
#ifdef ABSL_HAVE_STD_STRING_VIEW
|
|
#error "ABSL_HAVE_STD_STRING_VIEW cannot be directly set."
|
|
#endif
|
|
|
|
#ifdef __has_include
|
|
#if __has_include(<string_view>) && __cplusplus >= 201703L
|
|
#define ABSL_HAVE_STD_STRING_VIEW 1
|
|
#endif
|
|
#endif
|
|
|
|
// For MSVC, `__has_include` is supported in VS 2017 15.3, which is later than
|
|
// the support for <optional>, <any>, <string_view>, <variant>. So we use
|
|
// _MSC_VER to check whether we have VS 2017 RTM (when <optional>, <any>,
|
|
// <string_view>, <variant> is implemented) or higher. Also, `__cplusplus` is
|
|
// not correctly set by MSVC, so we use `_MSVC_LANG` to check the language
|
|
// version.
|
|
// TODO(zhangxy): fix tests before enabling aliasing for `std::any`,
|
|
// `std::string_view`.
|
|
#if defined(_MSC_VER) && _MSC_VER >= 1910 && \
|
|
((defined(_MSVC_LANG) && _MSVC_LANG > 201402) || __cplusplus > 201402)
|
|
// #define ABSL_HAVE_STD_ANY 1
|
|
#define ABSL_HAVE_STD_OPTIONAL 1
|
|
#define ABSL_HAVE_STD_VARIANT 1
|
|
// #define ABSL_HAVE_STD_STRING_VIEW 1
|
|
#endif
|
|
|
|
#endif // ABSL_BASE_CONFIG_H_
|