1//===- Version.h - Clang Version Number -------------------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8///
9/// \file
10/// Defines version macros and version-related utility functions
11/// for Clang.
12///
13//===----------------------------------------------------------------------===//
14
15#ifndef LLVM_CLANG_BASIC_VERSION_H
16#define LLVM_CLANG_BASIC_VERSION_H
17
18#include "clang/Basic/Version.inc"
19#include "llvm/ADT/StringRef.h"
20
21namespace clang {
22  /// Retrieves the repository path (e.g., Subversion path) that
23  /// identifies the particular Clang branch, tag, or trunk from which this
24  /// Clang was built.
25  std::string getClangRepositoryPath();
26
27  /// Retrieves the repository path from which LLVM was built.
28  ///
29  /// This supports LLVM residing in a separate repository from clang.
30  std::string getLLVMRepositoryPath();
31
32  /// Retrieves the repository revision number (or identifier) from which
33  /// this Clang was built.
34  std::string getClangRevision();
35
36  /// Retrieves the repository revision number (or identifier) from which
37  /// LLVM was built.
38  ///
39  /// If Clang and LLVM are in the same repository, this returns the same
40  /// string as getClangRevision.
41  std::string getLLVMRevision();
42
43  /// Retrieves the full repository version that is an amalgamation of
44  /// the information in getClangRepositoryPath() and getClangRevision().
45  std::string getClangFullRepositoryVersion();
46
47  /// Retrieves a string representing the complete clang version,
48  /// which includes the clang version number, the repository version,
49  /// and the vendor tag.
50  std::string getClangFullVersion();
51
52  /// Like getClangFullVersion(), but with a custom tool name.
53  std::string getClangToolFullVersion(llvm::StringRef ToolName);
54
55  /// Retrieves a string representing the complete clang version suitable
56  /// for use in the CPP __VERSION__ macro, which includes the clang version
57  /// number, the repository version, and the vendor tag.
58  std::string getClangFullCPPVersion();
59}
60
61#endif // LLVM_CLANG_BASIC_VERSION_H
62