xref: /freebsd/contrib/llvm-project/clang/include/clang/Basic/DiagnosticError.h (revision 06c3fb2749bda94cb5201f81ffdb8fa6c3161b2e)
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 
16 namespace clang {
17 
18 /// Carries a Clang diagnostic in an llvm::Error.
19 ///
20 /// Users should emit the stored diagnostic using the DiagnosticsEngine.
21 class DiagnosticError : public llvm::ErrorInfo<DiagnosticError> {
22 public:
DiagnosticError(PartialDiagnosticAt Diag)23   DiagnosticError(PartialDiagnosticAt Diag) : Diag(std::move(Diag)) {}
24 
log(raw_ostream & OS)25   void log(raw_ostream &OS) const override { OS << "clang diagnostic"; }
26 
getDiagnostic()27   PartialDiagnosticAt &getDiagnostic() { return Diag; }
getDiagnostic()28   const PartialDiagnosticAt &getDiagnostic() const { return Diag; }
29 
30   /// Creates a new \c DiagnosticError that contains the given diagnostic at
31   /// the given location.
create(SourceLocation Loc,PartialDiagnostic Diag)32   static llvm::Error create(SourceLocation Loc, PartialDiagnostic Diag) {
33     return llvm::make_error<DiagnosticError>(
34         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.
take(llvm::Error & Err)40   static std::optional<PartialDiagnosticAt> take(llvm::Error &Err) {
41     std::optional<PartialDiagnosticAt> Result;
42     Err = llvm::handleErrors(std::move(Err), [&](DiagnosticError &E) {
43       Result = std::move(E.getDiagnostic());
44     });
45     return Result;
46   }
47 
48   static char ID;
49 
50 private:
51   // Users are not expected to use error_code.
convertToErrorCode()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