macros.hpp

Go to the documentation of this file.

#pragma once
 
namespace trlc {
namespace platform {
 
constexpr bool supportsNodecard() noexcept {
#if defined(__has_cpp_attribute) && !defined(_MSC_VER)
    return __has_cpp_attribute(nodiscard) >= 201603L;
#elif defined(_MSC_VER) && _MSC_VER >= 1911  // Visual Studio 2017 15.3
    return true;
#else
    return false;
#endif
}
 
constexpr bool supportsDeprecated() noexcept {
#if defined(__has_cpp_attribute) && !defined(_MSC_VER)
    return __has_cpp_attribute(deprecated) >= 201309L;
#elif defined(_MSC_VER)
    return true;  // MSVC has always supported deprecated
#else
    return false;
#endif
}
 
constexpr bool supportsFallthrough() noexcept {
#if defined(__has_cpp_attribute) && !defined(_MSC_VER)
    return __has_cpp_attribute(fallthrough) >= 201603L;
#elif defined(_MSC_VER) && _MSC_VER >= 1911  // Visual Studio 2017 15.3
    return true;
#else
    return false;
#endif
}
 
constexpr bool hasAttributeSupport(const char* /* attribute_name */) noexcept {
    // This is a placeholder for a more sophisticated implementation
    // that could check attribute support by name at compile time
    return false;
}
 
}  // namespace platform
}  // namespace trlc
 
// =============================================================================
// Core Attribute Detection
// =============================================================================
 
#if defined(__has_cpp_attribute) && !defined(_MSC_VER)
    #define TRLC_HAS_CPP_ATTRIBUTE(x) __has_cpp_attribute(x)
#else
    #define TRLC_HAS_CPP_ATTRIBUTE(x) 0
#endif
 
#ifdef __has_builtin
    #define TRLC_HAS_BUILTIN(x) __has_builtin(x)
#else
    #define TRLC_HAS_BUILTIN(x) 0
#endif
 
// =============================================================================
// Portable C++ Attributes
// =============================================================================
 
#if TRLC_HAS_CPP_ATTRIBUTE(nodiscard) >= 201603L
    #define TRLC_NODISCARD [[nodiscard]]
#elif defined(_MSC_VER) && _MSC_VER >= 1911  // Visual Studio 2017 15.3 supports [[nodiscard]]
    #define TRLC_NODISCARD [[nodiscard]]
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_NODISCARD __attribute__((warn_unused_result))
#elif defined(_MSC_VER) && _MSC_VER >= 1700
    #define TRLC_NODISCARD _Check_return_
#else
    #define TRLC_NODISCARD
#endif
 
#if TRLC_HAS_CPP_ATTRIBUTE(deprecated) >= 201309L
    #define TRLC_DEPRECATED [[deprecated]]
#elif defined(_MSC_VER) && _MSC_VER >= 1400  // MSVC has supported [[deprecated]] since VS2005
    #define TRLC_DEPRECATED [[deprecated]]
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_DEPRECATED __attribute__((deprecated))
#elif defined(_MSC_VER)
    #define TRLC_DEPRECATED __declspec(deprecated)
#else
    #define TRLC_DEPRECATED
#endif
 
#if TRLC_HAS_CPP_ATTRIBUTE(deprecated) >= 201309L
    #define TRLC_DEPRECATED_MSG(msg) [[deprecated(msg)]]
#elif defined(_MSC_VER) && _MSC_VER >= 1400
    #define TRLC_DEPRECATED_MSG(msg) [[deprecated(msg)]]
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_DEPRECATED_MSG(msg) __attribute__((deprecated(msg)))
#elif defined(_MSC_VER)
    #define TRLC_DEPRECATED_MSG(msg) __declspec(deprecated(msg))
#else
    #define TRLC_DEPRECATED_MSG(msg) TRLC_DEPRECATED
#endif
 
#if TRLC_HAS_CPP_ATTRIBUTE(fallthrough) >= 201603L
    #define TRLC_FALLTHROUGH [[fallthrough]]
#elif defined(_MSC_VER) && _MSC_VER >= 1911  // Visual Studio 2017 15.3 supports [[fallthrough]]
    #define TRLC_FALLTHROUGH [[fallthrough]]
#elif defined(__GNUC__) && __GNUC__ >= 7
    #define TRLC_FALLTHROUGH __attribute__((fallthrough))
#elif defined(__clang__) && TRLC_HAS_CPP_ATTRIBUTE(clang::fallthrough)
    #define TRLC_FALLTHROUGH [[clang::fallthrough]]
#else
    #define TRLC_FALLTHROUGH ((void)0)
#endif
 
#if TRLC_HAS_CPP_ATTRIBUTE(maybe_unused) >= 201603L
    #define TRLC_MAYBE_UNUSED [[maybe_unused]]
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_MAYBE_UNUSED __attribute__((unused))
#else
    #define TRLC_MAYBE_UNUSED
#endif
 
// =============================================================================
// Inlining Control
// =============================================================================
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_FORCE_INLINE __attribute__((always_inline)) inline
#elif defined(_MSC_VER)
    #define TRLC_FORCE_INLINE __forceinline
#elif defined(__INTEL_COMPILER)
    #define TRLC_FORCE_INLINE __forceinline
#else
    #define TRLC_FORCE_INLINE inline
#endif
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_NEVER_INLINE __attribute__((noinline))
#elif defined(_MSC_VER)
    #define TRLC_NEVER_INLINE __declspec(noinline)
#elif defined(__INTEL_COMPILER)
    #define TRLC_NEVER_INLINE __declspec(noinline)
#else
    #define TRLC_NEVER_INLINE
#endif
 
#define TRLC_INLINE inline
 
// =============================================================================
// Branch Prediction Hints
// =============================================================================
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_LIKELY(x) __builtin_expect(!!(x), 1)
#elif defined(__INTEL_COMPILER)
    #define TRLC_LIKELY(x) __builtin_expect(!!(x), 1)
#else
    #define TRLC_LIKELY(x) (x)
#endif
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_UNLIKELY(x) __builtin_expect(!!(x), 0)
#elif defined(__INTEL_COMPILER)
    #define TRLC_UNLIKELY(x) __builtin_expect(!!(x), 0)
#else
    #define TRLC_UNLIKELY(x) (x)
#endif
 
// =============================================================================
// Exception Safety
// =============================================================================
 
#if !defined(__cpp_exceptions) || __cpp_exceptions == 0 || \
    defined(_HAS_EXCEPTIONS) && _HAS_EXCEPTIONS == 0
    #define TRLC_NOEXCEPT
    #define TRLC_HAS_EXCEPTIONS_ENABLED 0
#else
    #define TRLC_NOEXCEPT noexcept
    #define TRLC_HAS_EXCEPTIONS_ENABLED 1
#endif
 
#if TRLC_HAS_EXCEPTIONS_ENABLED
    #define TRLC_NOEXCEPT_IF(cond) noexcept(cond)
#else
    #define TRLC_NOEXCEPT_IF(cond)
#endif
 
// =============================================================================
// Symbol Visibility Control
// =============================================================================
 
#if defined(_WIN32) || defined(_WIN64)
    #define TRLC_API_EXPORT __declspec(dllexport)
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_API_EXPORT __attribute__((visibility("default")))
#elif defined(__INTEL_COMPILER)
    #define TRLC_API_EXPORT __attribute__((visibility("default")))
#else
    #define TRLC_API_EXPORT
#endif
 
#if defined(_WIN32) || defined(_WIN64)
    #define TRLC_API_IMPORT __declspec(dllimport)
#elif defined(__GNUC__) || defined(__clang__)
    #define TRLC_API_IMPORT __attribute__((visibility("default")))
#elif defined(__INTEL_COMPILER)
    #define TRLC_API_IMPORT __attribute__((visibility("default")))
#else
    #define TRLC_API_IMPORT
#endif
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_API_HIDDEN __attribute__((visibility("hidden")))
#elif defined(__INTEL_COMPILER)
    #define TRLC_API_HIDDEN __attribute__((visibility("hidden")))
#else
    #define TRLC_API_HIDDEN
#endif
 
#ifdef TRLC_BUILDING_SHARED
    #define TRLC_API TRLC_API_EXPORT
#else
    #define TRLC_API TRLC_API_IMPORT
#endif
 
// =============================================================================
// C++ Standard Detection
// =============================================================================
 
#if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L)
    #define TRLC_HAS_CPP17 1
#else
    #define TRLC_HAS_CPP17 0
#endif
 
// =============================================================================
// Utility Macros
// =============================================================================
 
// TRLC_CONSTEXPR_IF is defined in cpp_standard.hpp
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_RESTRICT __restrict__
#elif defined(_MSC_VER)
    #define TRLC_RESTRICT __restrict
#elif defined(__INTEL_COMPILER)
    #define TRLC_RESTRICT __restrict
#else
    #define TRLC_RESTRICT
#endif
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_PACKED __attribute__((packed))
#elif defined(_MSC_VER)
    #define TRLC_PACKED
    #define TRLC_PACK_BEGIN __pragma(pack(push, 1))
    #define TRLC_PACK_END __pragma(pack(pop))
#else
    #define TRLC_PACKED
    #define TRLC_PACK_BEGIN
    #define TRLC_PACK_END
#endif
 
#ifndef TRLC_PACK_BEGIN
    #define TRLC_PACK_BEGIN
    #define TRLC_PACK_END
#endif
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_ALIGNED(bytes) __attribute__((aligned(bytes)))
#elif defined(_MSC_VER)
    #define TRLC_ALIGNED(bytes) __declspec(align(bytes))
#elif defined(__INTEL_COMPILER)
    #define TRLC_ALIGNED(bytes) __declspec(align(bytes))
#else
    #define TRLC_ALIGNED(bytes)
#endif
 
#define TRLC_CACHE_ALIGNED TRLC_ALIGNED(64)
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_DIAGNOSTIC_PUSH _Pragma("GCC diagnostic push")
    #define TRLC_DIAGNOSTIC_POP _Pragma("GCC diagnostic pop")
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_PARAMETER \
        _Pragma("GCC diagnostic ignored \"-Wunused-parameter\"")
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_VARIABLE \
        _Pragma("GCC diagnostic ignored \"-Wunused-variable\"")
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_FUNCTION \
        _Pragma("GCC diagnostic ignored \"-Wunused-function\"")
#elif defined(_MSC_VER)
    #define TRLC_DIAGNOSTIC_PUSH __pragma(warning(push))
    #define TRLC_DIAGNOSTIC_POP __pragma(warning(pop))
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_PARAMETER __pragma(warning(disable : 4100))
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_VARIABLE __pragma(warning(disable : 4101))
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_FUNCTION __pragma(warning(disable : 4505))
#else
    #define TRLC_DIAGNOSTIC_PUSH
    #define TRLC_DIAGNOSTIC_POP
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_PARAMETER
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_VARIABLE
    #define TRLC_DIAGNOSTIC_IGNORE_UNUSED_FUNCTION
#endif
 
// =============================================================================
// Conditional Compilation Helpers
// =============================================================================
 
#define TRLC_IF(condition, code)   \
    do {                           \
        if constexpr (condition) { \
            code;                  \
        }                          \
    } while (0)
 
#define TRLC_IF_ELSE(condition, then_code, else_code) \
    do {                                              \
        if constexpr (condition) {                    \
            then_code;                                \
        } else {                                      \
            else_code;                                \
        }                                             \
    } while (0)
 
// =============================================================================
// Compiler Bug Workarounds
// =============================================================================
 
#define TRLC_USE(var) ((void)(var))
 
#if defined(__GNUC__) || defined(__clang__)
    #define TRLC_UNREACHABLE() __builtin_unreachable()
#elif defined(_MSC_VER)
    #define TRLC_UNREACHABLE() __assume(0)
#else
    #define TRLC_UNREACHABLE() ((void)0)
#endif
 
#define TRLC_STRINGIFY(x) #x
#define TRLC_STRINGIFY_EXPANDED(x) TRLC_STRINGIFY(x)
#define TRLC_CONCAT(a, b) a##b
#define TRLC_CONCAT_EXPANDED(a, b) TRLC_CONCAT(a, b)
 
// =============================================================================
// Feature Test Helpers
// =============================================================================
 
#define TRLC_FEATURE_AVAILABLE(feature) (TRLC_HAS_##feature)
 
#if defined(_WIN32) || defined(_WIN64) || defined(__CYGWIN__)
    #define TRLC_ON_WINDOWS(code) code
    #define TRLC_ON_POSIX(code)
    #define TRLC_PLATFORM_WINDOWS 1
    #define TRLC_PLATFORM_POSIX 0
#elif defined(__unix__) || defined(__unix) || (defined(__APPLE__) && defined(__MACH__))
    #define TRLC_ON_WINDOWS(code)
    #define TRLC_ON_POSIX(code) code
    #define TRLC_PLATFORM_WINDOWS 0
    #define TRLC_PLATFORM_POSIX 1
#else
    #define TRLC_ON_WINDOWS(code)
    #define TRLC_ON_POSIX(code)
    #define TRLC_PLATFORM_WINDOWS 0
    #define TRLC_PLATFORM_POSIX 0
#endif
 
#if defined(__x86_64__) || defined(__x86_64) || defined(__amd64__) || defined(__amd64) || \
    defined(_M_X64)
    #define TRLC_ON_X86_64(code) code
    #define TRLC_ARCH_X86_64 1
#else
    #define TRLC_ON_X86_64(code)
    #define TRLC_ARCH_X86_64 0
#endif
 
#if defined(__aarch64__) || defined(_M_ARM64)
    #define TRLC_ON_ARM64(code) code
    #define TRLC_ARCH_ARM64 1
#else
    #define TRLC_ON_ARM64(code)
    #define TRLC_ARCH_ARM64 0
#endif
 
// =============================================================================
// Version and Compatibility
// =============================================================================
 
#define TRLC_MACROS_VERSION_MAJOR 1
#define TRLC_MACROS_VERSION_MINOR 0
#define TRLC_MACROS_VERSION_PATCH 0
#define TRLC_MACROS_VERSION_STRING "1.0.0"
 
#define TRLC_MACROS_VERSION_AT_LEAST(major, minor, patch)                             \
    ((TRLC_MACROS_VERSION_MAJOR > (major)) ||                                         \
     (TRLC_MACROS_VERSION_MAJOR == (major) && TRLC_MACROS_VERSION_MINOR > (minor)) || \
     (TRLC_MACROS_VERSION_MAJOR == (major) && TRLC_MACROS_VERSION_MINOR == (minor) && \
      TRLC_MACROS_VERSION_PATCH >= (patch)))
 
// Mark this header as successfully included
#define TRLC_MACROS_INCLUDED
 
// =============================================================================
// End of macros.hpp
// =============================================================================