source-location.h 2.57 KB
Newer Older
1 2 3 4 5 6 7
// Copyright 2020 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef INCLUDE_CPPGC_SOURCE_LOCATION_H_
#define INCLUDE_CPPGC_SOURCE_LOCATION_H_

8
#include <cstddef>
9 10
#include <string>

11
#include "v8config.h"  // NOLINT(build/include_directory)
12 13 14 15 16

#if defined(__has_builtin)
#define CPPGC_SUPPORTS_SOURCE_LOCATION                                   \
  (__has_builtin(__builtin_FUNCTION) && __has_builtin(__builtin_FILE) && \
   __has_builtin(__builtin_LINE))  // NOLINT
17
#elif defined(V8_CC_GNU) && __GNUC__ >= 7
18 19 20 21 22 23 24 25 26
#define CPPGC_SUPPORTS_SOURCE_LOCATION 1
#elif defined(V8_CC_INTEL) && __ICC >= 1800
#define CPPGC_SUPPORTS_SOURCE_LOCATION 1
#else
#define CPPGC_SUPPORTS_SOURCE_LOCATION 0
#endif

namespace cppgc {

27 28
/**
 * Encapsulates source location information. Mimics C++20's
29
 * `std::source_location`.
30
 */
31 32
class V8_EXPORT SourceLocation final {
 public:
33 34 35 36
  /**
   * Construct source location information corresponding to the location of the
   * call site.
   */
37 38 39 40 41 42 43 44 45 46
#if CPPGC_SUPPORTS_SOURCE_LOCATION
  static constexpr SourceLocation Current(
      const char* function = __builtin_FUNCTION(),
      const char* file = __builtin_FILE(), size_t line = __builtin_LINE()) {
    return SourceLocation(function, file, line);
  }
#else
  static constexpr SourceLocation Current() { return SourceLocation(); }
#endif  // CPPGC_SUPPORTS_SOURCE_LOCATION

47 48 49
  /**
   * Constructs unspecified source location information.
   */
50 51
  constexpr SourceLocation() = default;

52 53 54 55 56 57
  /**
   * Returns the name of the function associated with the position represented
   * by this object, if any.
   *
   * \returns the function name as cstring.
   */
58
  constexpr const char* Function() const { return function_; }
59 60 61 62 63 64

  /**
   * Returns the name of the current source file represented by this object.
   *
   * \returns the file name as cstring.
   */
65
  constexpr const char* FileName() const { return file_; }
66 67 68 69 70 71

  /**
   * Returns the line number represented by this object.
   *
   * \returns the line number.
   */
72 73
  constexpr size_t Line() const { return line_; }

74 75 76 77 78
  /**
   * Returns a human-readable string representing this object.
   *
   * \returns a human-readable string representing source location information.
   */
79 80 81 82 83 84 85 86 87 88 89 90 91 92
  std::string ToString() const;

 private:
  constexpr SourceLocation(const char* function, const char* file, size_t line)
      : function_(function), file_(file), line_(line) {}

  const char* function_ = nullptr;
  const char* file_ = nullptr;
  size_t line_ = 0u;
};

}  // namespace cppgc

#endif  // INCLUDE_CPPGC_SOURCE_LOCATION_H_