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 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(std::move(Err), [&](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