Files
carbon-lang/toolchain/sem_ir/interface.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

82 lines
3.0 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_INTERFACE_H_
#define CARBON_TOOLCHAIN_SEM_IR_INTERFACE_H_
#include "toolchain/base/value_store.h"
#include "toolchain/sem_ir/core_interface.h"
#include "toolchain/sem_ir/entity_with_params_base.h"
#include "toolchain/sem_ir/ids.h"
namespace Carbon::SemIR {
// Interface-specific fields.
//
// TODO: Factor out the shared fields between InterfaceFields and
// NamedConstraintFields.
struct InterfaceFields {
// The following members are set at the `{` of the interface definition.
// The interface scopes.
NameScopeId scope_without_self_id = NameScopeId::None;
NameScopeId scope_with_self_id = NameScopeId::None;
// The block of instructions outside the interface-with-self. This is where
// the `Self` instruction can be constructed.
InstBlockId body_block_without_self_id = InstBlockId::None;
// The interface-with-self generic, where the `Self` is a parameter to the
// generic. This generic contains all the associated entities of the
// interface.
GenericId generic_with_self_id = GenericId::None;
// The first block of the interface-with-self body.
// TODO: Handle control flow in the interface body, such as if-expressions.
InstBlockId body_block_with_self_id = InstBlockId::None;
// The implicit `Self` parameter. This is a SymbolicBinding instruction.
InstId self_param_id = InstId::None;
// Identifies whether the interface is a core interface.
CoreInterface core_interface = CoreInterface::Unknown;
// The following members are set at the `}` of the interface definition.
RequireImplsBlockId require_impls_block_id = RequireImplsBlockId::None;
InstBlockId associated_entities_id = InstBlockId::None;
};
// An interface. See EntityWithParamsBase regarding the inheritance here.
struct Interface : public EntityWithParamsBase,
public InterfaceFields,
public Printable<Interface> {
auto Print(llvm::raw_ostream& out) const -> void {
out << "{";
PrintBaseFields(out);
out << ", require_impls_block_id: " << require_impls_block_id;
if (core_interface != CoreInterface::Unknown) {
out << ", core_interface: " << core_interface;
}
out << "}";
}
// This is false until we reach the `}` of the interface definition.
auto is_complete() const -> bool {
return associated_entities_id.has_value();
}
// Determines whether we're currently defining the interface. This is true
// between the braces of the interface.
auto is_being_defined() const -> bool {
return has_definition_started() && !is_complete();
}
};
using InterfaceStore = ValueStore<InterfaceId, Interface, Tag<CheckIRId>>;
} // namespace Carbon::SemIR
namespace Carbon {
extern template class ValueStore<SemIR::InterfaceId, SemIR::Interface,
Tag<SemIR::CheckIRId>>;
} // namespace Carbon
#endif // CARBON_TOOLCHAIN_SEM_IR_INTERFACE_H_