Clang Project

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