Files
carbon-lang/toolchain/sem_ir/cpp_global_var.h
T
Chandler Carruth d010d52f37 Switch the ValueStore-related templates to use explicit instantiation (#7116)
As part of this, move functions that seem reasonable to make out-of-line
to a separate `_impl.h` header file that is only included where the
explicit instantiation _definition_ is provided.

By using explicit instantiation we can make these templates behave more
like non-template classes in terms of supporting out-of-line definitions
that don't need to be compiled by every translation unit. The set of
eventual instantiations here is fundamentally known, and there tend to
be headers that define a canonical "leaf" type where it makes sense to
trigger the explicit instantiation.

Where we already had a `.cpp` file to put the explicit instantiation
definition, use it. But in some places we didn't have such a `.cpp` file
so this PR adds those.

This also requires that we have precise constraints on APIs that _can't_
be instantiated for specific argument types, as now we don't do this
lazily.

Combined, this appears to reduce the sum of object file sizes in the
`check` directory by almost 40% (122mb -> 74mb) in my measurement.

My actual goal was to improve compile times, but so far I don't have a
great methodology for measuring these... But the object file size
reduction seems to confirm this is a net win and likely represents a
non-trivial improvement in compile time.

Assisted-by: Antigravity with Gemini
2026-05-14 08:29:17 +00:00

66 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_SEM_IR_CPP_GLOBAL_VAR_H_
#define CARBON_TOOLCHAIN_SEM_IR_CPP_GLOBAL_VAR_H_
#include "common/hashing.h"
#include "common/ostream.h"
#include "toolchain/sem_ir/clang_decl.h"
#include "toolchain/sem_ir/ids.h"
namespace Carbon::SemIR {
// A key describing a C++ global variable imported into Carbon, identified by
// its entity name.
struct CppGlobalVarKey : public Printable<CppGlobalVarKey> {
auto Print(llvm::raw_ostream& out) const -> void {
out << "{entity_name_id: " << entity_name_id << "}";
}
// TODO: Use default when `Printable` supports it.
friend auto operator==(const CppGlobalVarKey& lhs, const CppGlobalVarKey& rhs)
-> bool {
return lhs.entity_name_id == rhs.entity_name_id;
}
// The name of the variable.
EntityNameId entity_name_id;
};
// A C++ global variable imported into Carbon. This is used to map the entity
// name to the Clang declaration so we can use Clang mangling.
struct CppGlobalVar : public Printable<CppGlobalVar> {
auto Print(llvm::raw_ostream& out) const -> void {
out << "{key: " << key << ", clang_decl_id: " << clang_decl_id << "}";
}
// The key by which this variable can be looked up.
CppGlobalVarKey key;
// The Clang declaration for this variable, if any.
// This is ignored for equality and hashing, since it's always unique for a
// given key, in order to store it in `CanonicalValueStore` and allow lookup
// by `CppGlobalVarKey`.
ClangDeclId clang_decl_id;
auto GetAsKey() const -> CppGlobalVarKey { return key; }
};
// Use the name of a C++ global variable when doing `Lookup` to find an ID.
using CppGlobalVarStore = CanonicalValueStore<CppGlobalVarId, CppGlobalVarKey,
Tag<CheckIRId>, CppGlobalVar>;
} // namespace Carbon::SemIR
namespace Carbon {
extern template class CanonicalValueStore<
SemIR::CppGlobalVarId, SemIR::CppGlobalVarKey, Tag<SemIR::CheckIRId>,
SemIR::CppGlobalVar>;
extern template class ValueStore<SemIR::CppGlobalVarId, SemIR::CppGlobalVar,
Tag<SemIR::CheckIRId>>;
} // namespace Carbon
#endif // CARBON_TOOLCHAIN_SEM_IR_CPP_GLOBAL_VAR_H_