Files
carbon-lang/toolchain/diagnostics/sorting_consumer.h
T
Jon Ross-Perkins 45ca3d28f5 Drop "diagnostic" from some filenames in the "diagnostics" folder (#6686)
Mainly because "sorting_diagnostic_consumer" is legacy, since
`SortingDiagnosticConsumer` became `SortingConsumer`. Also better
reflecting contents of these files.

Where I'm not renaming, I'm less positive about dropping "diagnostics"
from "file_diagnostics" and "null_diagnostics" (which contain both a
consumer and emitter, and "null.h" seems like poor naming), so not doing
that here. Also "diagnostic.h" contains `struct Diagnostic`, so is a
decent fit.

Assisted-by: Google Antigravity with Gemini 3 Flash
2026-02-04 17:24:55 +00:00

64 lines
2.3 KiB
C++

// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
#ifndef CARBON_TOOLCHAIN_DIAGNOSTICS_SORTING_CONSUMER_H_
#define CARBON_TOOLCHAIN_DIAGNOSTICS_SORTING_CONSUMER_H_
#include "common/check.h"
#include "llvm/ADT/STLExtras.h"
#include "toolchain/diagnostics/emitter.h"
namespace Carbon::Diagnostics {
// Buffers incoming diagnostics for printing and sorting.
//
// Sorting is based on `last_byte_offset` without taking the filename into
// account. When processing multiple files, it's expected that separate
// consumers will be used in order to keep diagnostics distinct. Typically
// `Diagnostic::messages[0]` will always be a location in the consumer's primary
// file, but if it needs to correspond to a different file, the
// `last_byte_offset` must still indicate an offset within the primary file.
class SortingConsumer : public Consumer {
public:
explicit SortingConsumer(Consumer& next_consumer)
: next_consumer_(&next_consumer) {}
~SortingConsumer() override {
// We choose not to automatically flush diagnostics here, because they are
// likely to refer to data that gets destroyed before the diagnostics
// consumer is destroyed, because the diagnostics consumer is typically
// created before the objects that diagnostics refer into are created.
CARBON_CHECK(diagnostics_.empty(),
"Must flush diagnostics consumer before destroying it");
}
// Buffers the diagnostic.
auto HandleDiagnostic(Diagnostic diagnostic) -> void override {
diagnostics_.push_back(std::move(diagnostic));
}
// Sorts and flushes buffered diagnostics.
auto Flush() -> void override {
llvm::stable_sort(diagnostics_,
[](const Diagnostic& lhs, const Diagnostic& rhs) {
return lhs.last_byte_offset < rhs.last_byte_offset;
});
for (auto& diag : diagnostics_) {
next_consumer_->HandleDiagnostic(std::move(diag));
}
diagnostics_.clear();
}
private:
// A Diagnostic is undesirably large for inline storage by SmallVector, so we
// specify 0.
llvm::SmallVector<Diagnostic, 0> diagnostics_;
Consumer* next_consumer_;
};
} // namespace Carbon::Diagnostics
#endif // CARBON_TOOLCHAIN_DIAGNOSTICS_SORTING_CONSUMER_H_