1//===--- DiagnosticError.h - Diagnostic payload for llvm::Error -*- 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#ifndef LLVM_CLANG_BASIC_DIAGNOSTICERROR_H
10#define LLVM_CLANG_BASIC_DIAGNOSTICERROR_H
11
12#include "clang/Basic/PartialDiagnostic.h"
13#include "llvm/Support/Error.h"
14#include <optional>
15
16namespace clang {
17
18/// Carries a Clang diagnostic in an llvm::Error.
19///
20/// Users should emit the stored diagnostic using the DiagnosticsEngine.
21class DiagnosticError : public llvm::ErrorInfo<DiagnosticError> {
22public:
23 DiagnosticError(PartialDiagnosticAt Diag) : Diag(std::move(Diag)) {}
24
25 void log(raw_ostream &OS) const override { OS << "clang diagnostic"; }
26
27 PartialDiagnosticAt &getDiagnostic() { return Diag; }
28 const PartialDiagnosticAt &getDiagnostic() const { return Diag; }
29
30 /// Creates a new \c DiagnosticError that contains the given diagnostic at
31 /// the given location.
32 static llvm::Error create(SourceLocation Loc, PartialDiagnostic Diag) {
33 return llvm::make_error<DiagnosticError>(
34 Args: PartialDiagnosticAt(Loc, std::move(Diag)));
35 }
36
37 /// Extracts and returns the diagnostic payload from the given \c Error if
38 /// the error is a \c DiagnosticError. Returns std::nullopt if the given error
39 /// is not a \c DiagnosticError.
40 static std::optional<PartialDiagnosticAt> take(llvm::Error &Err) {
41 std::optional<PartialDiagnosticAt> Result;
42 Err = llvm::handleErrors(E: std::move(Err), Hs: [&](DiagnosticError &E) {
43 Result = std::move(E.getDiagnostic());
44 });
45 return Result;
46 }
47
48 static char ID;
49
50private:
51 // Users are not expected to use error_code.
52 std::error_code convertToErrorCode() const override {
53 return llvm::inconvertibleErrorCode();
54 }
55
56 PartialDiagnosticAt Diag;
57};
58
59} // end namespace clang
60
61#endif // LLVM_CLANG_BASIC_DIAGNOSTICERROR_H
62

source code of clang/include/clang/Basic/DiagnosticError.h