platform.hpp

Go to the documentation of this file.

// -----------------------------------------------------------------------------------------------------
// Copyright (c) 2006-2021, Knut Reinert & Freie Universität Berlin
// Copyright (c) 2016-2021, Knut Reinert & MPI für molekulare Genetik
// This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
// shipped with this file and also available at: https://github.com/seqan/seqan3/blob/master/LICENSE.md
// -----------------------------------------------------------------------------------------------------
 
#pragma once
 
#include <cinttypes>
#include <ciso646> // makes _LIBCPP_VERSION available
#include <cstddef> // makes __GLIBCXX__ available
 
// macro cruft
#define SEQAN3_STR_HELPER(x) #x
#define SEQAN3_STR(x) SEQAN3_STR_HELPER(x)
 
// ============================================================================
//  C++ standard and features
// ============================================================================
 
// C++ standard [required]
#ifdef __cplusplus
    static_assert(__cplusplus >= 201703, "SeqAn3 requires C++17, make sure that you have set -std=c++17.");
#else
#   error "This is not a C++ compiler."
#endif
 
#if __has_include(<version>)
#   include <version>
#endif
 
// C++ Concepts [required]
#ifdef __cpp_concepts
#   if __cpp_concepts == 201507 // GCC and Concepts TS
#       define SEQAN3_CONCEPT concept bool
#   else
        static_assert(__cpp_concepts >= 201507, "Your compiler supports Concepts, but the support is not recent enough.");
#       define SEQAN3_CONCEPT concept
#   endif
#else
#   error "SeqAn3 requires C++ Concepts, either via the TS (flag: -fconcepts) or via C++20 (flag: -std=c++2a / -std=c++20)."
#endif
 
#if defined(__GNUC__) && (__GNUC__ < 10)
#   define SEQAN3_RETURN_TYPE_CONSTRAINT(expression, concept_name, ...) \
       {expression}; requires concept_name<decltype(expression), __VA_ARGS__>
#else
#   define SEQAN3_RETURN_TYPE_CONSTRAINT(expression, concept_name, ...) \
       {expression} -> concept_name<__VA_ARGS__>
#endif
 
// filesystem [required]
#if !__has_include(<filesystem>)
#   if !__has_include(<experimental/filesystem>)
#      error SeqAn3 requires C++17 filesystem support, but it was not found.
#   endif
#endif
 
// ============================================================================
//  Dependencies
// ============================================================================
 
// SeqAn [required]
#if __has_include(<seqan3/version.hpp>)
#   include <seqan3/version.hpp>
#else
#   error SeqAn3 include directory not set correctly. Forgot to add -I ${INSTALLDIR}/include to your CXXFLAGS?
#endif
 
// Ranges [required]
#if __has_include(<range/v3/version.hpp>)
#   define RANGE_V3_MINVERSION 1100
#   define RANGE_V3_MAXVERSION 1199
// TODO the following doesn't actually show the current version, only its formula. How'd you do it?
#   define SEQAN3_MSG "Your version: " SEQAN3_STR(RANGE_V3_VERSION) \
                      "; minimum version: " SEQAN3_STR(RANGE_V3_MINVERSION) \
                      "; expected maximum version: " SEQAN3_STR(RANGE_V3_MAXVERSION)
#   include <range/v3/version.hpp>
#   if RANGE_V3_VERSION < RANGE_V3_MINVERSION
#       error Your range-v3 library is too old.
#       pragma message(SEQAN3_MSG)
#   elif RANGE_V3_VERSION > RANGE_V3_MAXVERSION
#       pragma GCC warning "Your range-v3 library is possibly too new. Some features might not work correctly."
#       pragma message(SEQAN3_MSG)
#   endif
#   undef SEQAN3_MSG
#else
#   error The range-v3 library was not included correctly. Forgot to add -I ${INSTALLDIR}/include to your CXXFLAGS?
#endif
 
// SDSL [required]
#if __has_include(<sdsl/version.hpp>)
#   include <sdsl/version.hpp>
    static_assert(sdsl::sdsl_version_major == 3, "Only version 3 of the SDSL is supported by SeqAn3.");
#else
#   error The sdsl library was not included correctly. Forgot to add -I ${INSTALLDIR}/include to your CXXFLAGS?
#endif
 
// Cereal [optional]
#ifndef SEQAN3_WITH_CEREAL
#   if __has_include(<cereal/cereal.hpp>)
#       define SEQAN3_WITH_CEREAL 1
#   else
#       define SEQAN3_WITH_CEREAL 0
#   endif
#elif SEQAN3_WITH_CEREAL != 0
#   if ! __has_include(<cereal/cereal.hpp>)
#       error Cereal was marked as required, but not found!
#   endif
#endif
 
#if !SEQAN3_WITH_CEREAL
#   define CEREAL_SERIALIZE_FUNCTION_NAME serialize
#   define CEREAL_LOAD_FUNCTION_NAME load
#   define CEREAL_SAVE_FUNCTION_NAME save
#   define CEREAL_LOAD_MINIMAL_FUNCTION_NAME load_minimal
#   define CEREAL_SAVE_MINIMAL_FUNCTION_NAME save_minimal
#endif
 
// Lemon [optional]
#ifndef SEQAN3_WITH_LEMON
#   if __has_include(<lemon/config.h>)
#       define SEQAN3_WITH_LEMON 1
#   else
#       define SEQAN3_WITH_LEMON 0
#   endif
#elif SEQAN3_WITH_LEMON != 0
#   if !__has_include(<lemon/config.h>)
#       error Lemon was marked as required, but not found!
#   endif
#endif
#if SEQAN3_WITH_LEMON == 1
#   define LEMON_HAVE_LONG_LONG 1
#   define LEMON_CXX11 1
#   if defined(__unix__) || defined(__APPLE__)
#       define LEMON_USE_PTHREAD 1
#       define LEMON_USE_WIN32_THREADS 0
#       define LEMON_WIN32 0
#   else
#       define LEMON_USE_PTHREAD 0
#       define LEMON_USE_WIN32_THREADS 1
#       define LEMON_WIN32 1
#   endif
#endif
 
// TODO (doesn't have a version.hpp, yet)
 
// ============================================================================
//  Documentation
// ============================================================================
 
// Doxygen related
// this macro is a NO-OP unless doxygen parses it, in which case it resolves to the argument
#ifndef SEQAN3_DOXYGEN_ONLY
#   define SEQAN3_DOXYGEN_ONLY(x)
#endif
 
// ============================================================================
//  Deprecation Messages
// ============================================================================
 
#ifndef SEQAN3_PRAGMA
#   define SEQAN3_PRAGMA(non_string_literal) _Pragma(#non_string_literal)
#endif
 
#ifndef SEQAN3_REMOVE_DEPRECATED_310
#    ifndef SEQAN3_DEPRECATED_310
#       ifndef SEQAN3_DISABLE_DEPRECATED_WARNINGS
#           define SEQAN3_DEPRECATED_310 [[deprecated("This will be removed in SeqAn-3.1.0; please see the documentation.")]]
#       else
#           define SEQAN3_DEPRECATED_310 
#       endif
#    endif
#endif
 
#ifndef SEQAN3_DEPRECATED_HEADER
#   ifndef SEQAN3_DISABLE_DEPRECATED_WARNINGS
#       define SEQAN3_DEPRECATED_HEADER(message) SEQAN3_PRAGMA(GCC warning message)
#   else
#       define SEQAN3_DEPRECATED_HEADER(message) 
#   endif
#endif
 
// ============================================================================
//  Workarounds
// ============================================================================
 
#if defined(__GNUC__) && (__GNUC__ == 10 && __GNUC_MINOR__ <= 1)
#   ifdef SEQAN3_DEPRECATED_310
#       define SEQAN3_WORKAROUND_GCC_93983 0
#       define SEQAN3_WORKAROUND_GCC_95371 0
#       define SEQAN3_WORKAROUND_GCC_95578 0
#   endif // SEQAN3_DEPRECATED_310
#   pragma GCC warning "Be aware that gcc 10.0 and 10.1 are known to have several bugs that might make SeqAn3 fail to compile. Please use gcc >= 10.2."
#endif // defined(__GNUC__) && (__GNUC__ == 10 && __GNUC_MINOR__ <= 1)
 
#ifndef SEQAN3_WORKAROUND_VIEW_PERFORMANCE
#   define SEQAN3_WORKAROUND_VIEW_PERFORMANCE 1
#endif
 
#ifndef SEQAN3_WORKAROUND_ISSUE_286
#   if defined(__GNUC__) && (__GNUC__ <= 9)
#       define SEQAN3_WORKAROUND_ISSUE_286 1
#   else
#       define SEQAN3_WORKAROUND_ISSUE_286 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_83328
#   if defined(__GNUC__) && (__GNUC__ <= 8)
#       define SEQAN3_WORKAROUND_GCC_83328 1
#   else
#       define SEQAN3_WORKAROUND_GCC_83328 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_87113
#   if defined(__GNUC_MINOR__) && ((__GNUC__ == 7) || ((__GNUC__ == 8) && (__GNUC_MINOR__ < 3)))
#       define SEQAN3_WORKAROUND_GCC_87113 1
#   else
#       define SEQAN3_WORKAROUND_GCC_87113 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_89953
#   if defined(__GNUC_MINOR__) && (__GNUC__ == 9 && __GNUC_MINOR__ < 3)
#       define SEQAN3_WORKAROUND_GCC_89953 1
#   else
#       define SEQAN3_WORKAROUND_GCC_89953 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_90897 // fixed since gcc8.4
#   if defined(__GNUC__) && (__GNUC__ == 8 && __GNUC_MINOR__ < 4)
#       define SEQAN3_WORKAROUND_GCC_90897 1
#   else
#       define SEQAN3_WORKAROUND_GCC_90897 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC7_AND_8_CONCEPT_ISSUES
#   if defined(__GNUC__) && ((__GNUC__ == 7) || (__GNUC__ == 8))
#       define SEQAN3_WORKAROUND_GCC7_AND_8_CONCEPT_ISSUES 1
#   else
#       define SEQAN3_WORKAROUND_GCC7_AND_8_CONCEPT_ISSUES 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_93467 // fixed since gcc10.2
#   if defined(__GNUC__) && ((__GNUC__ <= 9) || (__GNUC__ == 10 && __GNUC_MINOR__ < 2))
#       define SEQAN3_WORKAROUND_GCC_93467 1
#   else
#       define SEQAN3_WORKAROUND_GCC_93467 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_94967 // fixed since gcc8
#   if defined(__GNUC__) && (__GNUC__ <= 7)
#       define SEQAN3_WORKAROUND_GCC_94967 1
#   else
#       define SEQAN3_WORKAROUND_GCC_94967 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_96070 // fixed since gcc10.4
#   if defined(__GNUC__) && (__GNUC__ == 10 && __GNUC_MINOR__ < 4)
#       define SEQAN3_WORKAROUND_GCC_96070 1
#   else
#       define SEQAN3_WORKAROUND_GCC_96070 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_99318 // fixed since gcc10.3
#   if defined(__GNUC__) && (__GNUC__ == 10 && __GNUC_MINOR__ < 3)
#       define SEQAN3_WORKAROUND_GCC_99318 1
#   else
#       define SEQAN3_WORKAROUND_GCC_99318 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_100139 // not yet fixed
#   if defined(__GNUC__)
#       define SEQAN3_WORKAROUND_GCC_100139 1
#   else
#       define SEQAN3_WORKAROUND_GCC_100139 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_NO_CXX11_ABI
#   if defined(_GLIBCXX_USE_CXX11_ABI) && _GLIBCXX_USE_CXX11_ABI == 0
#       define SEQAN3_WORKAROUND_GCC_NO_CXX11_ABI 1
#   else
#       define SEQAN3_WORKAROUND_GCC_NO_CXX11_ABI 0
#   endif
#endif
 
#if SEQAN3_DOXYGEN_ONLY(1)0
#define SEQAN3_DISABLE_LEGACY_STD_DIAGNOSTIC
#endif // SEQAN3_DOXYGEN_ONLY(1)0
 
#if defined(_GLIBCXX_USE_CXX11_ABI) &&  _GLIBCXX_USE_CXX11_ABI == 0
#   ifndef SEQAN3_DISABLE_LEGACY_STD_DIAGNOSTIC
#       pragma GCC warning "We do not actively support compiler that have -D_GLIBCXX_USE_CXX11_ABI=0 set, and it might be that SeqAn does not compile due to this. It is known that all compiler of CentOS 7 / RHEL 7 set this flag by default (and that it cannot be overridden!). Note that these versions of the OSes are community-supported (see https://docs.seqan.de/seqan/3-master-user/about_api.html#platform_stability for more details). You can disable this warning by setting -DSEQAN3_DISABLE_LEGACY_STD_DIAGNOSTIC."
#   endif // SEQAN3_DISABLE_LEGACY_STD_DIAGNOSTIC
#endif // _GLIBCXX_USE_CXX11_ABI == 0
 
#ifndef SEQAN3_WORKAROUND_GCC_NON_TEMPLATE_REQUIRES
#   if defined(__GNUC_MINOR__) && (__GNUC__ < 10) // fixed since gcc-10
#       define SEQAN3_WORKAROUND_GCC_NON_TEMPLATE_REQUIRES 1
#   else
#       define SEQAN3_WORKAROUND_GCC_NON_TEMPLATE_REQUIRES 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_PIPEABLE_CONFIG_CONCEPT
#   if defined(__GNUC__) && (__GNUC__ < 11)
#       define SEQAN3_WORKAROUND_GCC_PIPEABLE_CONFIG_CONCEPT 1
#   else
#       define SEQAN3_WORKAROUND_GCC_PIPEABLE_CONFIG_CONCEPT 0
#   endif
#endif
 
#ifndef SEQAN3_WORKAROUND_GCC_INCOMPLETE_FILESYSTEM
#   if defined(__GNUC__) && (__GNUC__ == 7)
#       define SEQAN3_WORKAROUND_GCC_INCOMPLETE_FILESYSTEM 1
#   else
#       define SEQAN3_WORKAROUND_GCC_INCOMPLETE_FILESYSTEM 0
#   endif
#endif
 
 
// ============================================================================
//  Backmatter
// ============================================================================
 
// macro cruft undefine
#undef SEQAN3_STR
#undef SEQAN3_STR_HELPER