libcxx/include/source_location

   1 // -*- C++ -*-
   2 //===----------------------------------------------------------------------===//
   3 //
   4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
   5 // See https://llvm.org/LICENSE.txt for license information.
   6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #ifndef _LIBCPP_SOURCE_LOCATION
  11 #define _LIBCPP_SOURCE_LOCATION
  12
  13 /* source_location synopsis
  14
  15 namespace std {
  16   struct source_location {
  17     static consteval source_location current() noexcept;
  18     constexpr source_location() noexcept;
  19
  20     constexpr uint_least32_t line() const noexcept;
  21     constexpr uint_least32_t column() const noexcept;
  22     constexpr const char* file_name() const noexcept;
  23     constexpr const char* function_name() const noexcept;
  24   };
  25 }
  26 */
  27
  28 #include <__config>
  29 #include <cstdint>
  30 #include <version>
  31
  32 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  33 #  pragma GCC system_header
  34 #endif
  35
  36 _LIBCPP_BEGIN_NAMESPACE_STD
  37
  38 #if _LIBCPP_STD_VER >= 20
  39
  40 class source_location {
  41   // The names source_location::__impl, _M_file_name, _M_function_name, _M_line, and _M_column
  42   // are hard-coded in the compiler and must not be changed here.
  43   struct __impl {
  44     const char* _M_file_name;
  45     const char* _M_function_name;
  46     unsigned _M_line;
  47     unsigned _M_column;
  48   };
  49   const __impl* __ptr_ = nullptr;
  50   // GCC returns the type 'const void*' from the builtin, while clang returns
  51   // `const __impl*`. Per C++ [expr.const], casts from void* are not permitted
  52   // in constant evaluation, so we don't want to use `void*` as the argument
  53   // type unless the builtin returned that, anyhow, and the invalid cast is
  54   // unavoidable.
  55   using __bsl_ty = decltype(__builtin_source_location());
  56
  57 public:
  58   // The defaulted __ptr argument is necessary so that the builtin is evaluated
  59   // in the context of the caller. An explicit value should never be provided.
  60   static consteval source_location current(__bsl_ty __ptr = __builtin_source_location()) noexcept {
  61     source_location __sl;
  62     __sl.__ptr_ = static_cast<const __impl*>(__ptr);
  63     return __sl;
  64   }
  65   _LIBCPP_HIDE_FROM_ABI constexpr source_location() noexcept = default;
  66
  67   _LIBCPP_HIDE_FROM_ABI constexpr uint_least32_t line() const noexcept {
  68     return __ptr_ != nullptr ? __ptr_->_M_line : 0;
  69   }
  70   _LIBCPP_HIDE_FROM_ABI constexpr uint_least32_t column() const noexcept {
  71     return __ptr_ != nullptr ? __ptr_->_M_column : 0;
  72   }
  73   _LIBCPP_HIDE_FROM_ABI constexpr const char* file_name() const noexcept {
  74     return __ptr_ != nullptr ? __ptr_->_M_file_name : "";
  75   }
  76   _LIBCPP_HIDE_FROM_ABI constexpr const char* function_name() const noexcept {
  77     return __ptr_ != nullptr ? __ptr_->_M_function_name : "";
  78   }
  79 };
  80
  81 #endif // _LIBCPP_STD_VER >= 20
  82
  83 _LIBCPP_END_NAMESPACE_STD
  84
  85 #endif // _LIBCPP_SOURCE_LOCATION