mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 22:02:23 +01:00
This ensures that equal forms always have equal representations (because the index depends on how the form is used, not on the value of the form itself). As a byproduct, also remove `NextCallParamIndex`. --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Nicholas Bishop <nicholasbishop@google.com> Co-authored-by: Jon Ross-Perkins <jperkins@google.com> Co-authored-by: Dana Jansens <danakj@orodu.net> Co-authored-by: Boaz Brickner <brickner@google.com> Co-authored-by: Richard Smith <richard@metafoo.co.uk> Co-authored-by: Carbon Infra Bot <carbon-external-infra@google.com> Co-authored-by: MK4070 <60286678+MK4070@users.noreply.github.com> Co-authored-by: Christopher Di Bella <cjdb@google.com>
791 lines
32 KiB
C++
791 lines
32 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
|
|
|
|
#include <optional>
|
|
#include <utility>
|
|
|
|
#include "toolchain/base/kind_switch.h"
|
|
#include "toolchain/check/context.h"
|
|
#include "toolchain/check/control_flow.h"
|
|
#include "toolchain/check/convert.h"
|
|
#include "toolchain/check/decl_introducer_state.h"
|
|
#include "toolchain/check/generic.h"
|
|
#include "toolchain/check/handle.h"
|
|
#include "toolchain/check/import_ref.h"
|
|
#include "toolchain/check/interface.h"
|
|
#include "toolchain/check/literal.h"
|
|
#include "toolchain/check/merge.h"
|
|
#include "toolchain/check/modifiers.h"
|
|
#include "toolchain/check/name_component.h"
|
|
#include "toolchain/check/name_lookup.h"
|
|
#include "toolchain/check/return.h"
|
|
#include "toolchain/check/type.h"
|
|
#include "toolchain/check/type_completion.h"
|
|
#include "toolchain/check/unused.h"
|
|
#include "toolchain/lex/token_kind.h"
|
|
#include "toolchain/parse/node_ids.h"
|
|
#include "toolchain/sem_ir/builtin_function_kind.h"
|
|
#include "toolchain/sem_ir/entry_point.h"
|
|
#include "toolchain/sem_ir/function.h"
|
|
#include "toolchain/sem_ir/ids.h"
|
|
#include "toolchain/sem_ir/inst.h"
|
|
#include "toolchain/sem_ir/typed_insts.h"
|
|
|
|
namespace Carbon::Check {
|
|
|
|
auto HandleParseNode(Context& context, Parse::FunctionIntroducerId node_id)
|
|
-> bool {
|
|
// The function is potentially generic.
|
|
StartGenericDecl(context);
|
|
// Create an instruction block to hold the instructions created as part of the
|
|
// function signature, such as parameter and return types.
|
|
context.inst_block_stack().Push();
|
|
// Push the bracketing node.
|
|
context.node_stack().Push(node_id);
|
|
// Optional modifiers and the name follow.
|
|
context.decl_introducer_state_stack().Push<Lex::TokenKind::Fn>();
|
|
context.decl_name_stack().PushScopeAndStartName();
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::ReturnTypeId node_id) -> bool {
|
|
auto [type_node_id, type_inst_id] = context.node_stack().PopExprWithNodeId();
|
|
|
|
// Propagate the type expression.
|
|
auto form_expr = ReturnExprAsForm(context, type_node_id, type_inst_id);
|
|
context.PushReturnForm(form_expr);
|
|
auto return_patterns_id = AddReturnPatterns(context, node_id, form_expr);
|
|
context.node_stack().Push(node_id, return_patterns_id);
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::ReturnFormId node_id) -> bool {
|
|
return context.TODO(node_id, "Support ->?");
|
|
}
|
|
|
|
// Diagnoses issues with the modifiers, removing modifiers that shouldn't be
|
|
// present.
|
|
static auto DiagnoseModifiers(Context& context,
|
|
Parse::AnyFunctionDeclId node_id,
|
|
DeclIntroducerState& introducer,
|
|
bool is_definition,
|
|
SemIR::NameScopeId parent_scope_id,
|
|
SemIR::InstId parent_scope_inst_id,
|
|
std::optional<SemIR::Inst> parent_scope_inst,
|
|
SemIR::InstId self_param_id) -> void {
|
|
CheckAccessModifiersOnDecl(context, introducer, parent_scope_inst);
|
|
LimitModifiersOnDecl(
|
|
context, introducer,
|
|
KeywordModifierSet::Access | KeywordModifierSet::Extern |
|
|
KeywordModifierSet::Export | KeywordModifierSet::Method |
|
|
KeywordModifierSet::Interface | KeywordModifierSet::Evaluation);
|
|
RestrictExternModifierOnDecl(context, introducer, parent_scope_inst,
|
|
is_definition);
|
|
CheckMethodModifiersOnFunction(context, introducer, parent_scope_inst_id,
|
|
parent_scope_inst);
|
|
RequireDefaultFinalOnlyInInterfaces(context, introducer, parent_scope_id);
|
|
|
|
if (introducer.modifier_set.HasAnyOf(KeywordModifierSet::Interface)) {
|
|
// TODO: Once we are saving the modifiers for a function, add check that
|
|
// the function may only be defined if it is marked `default` or `final`.
|
|
context.TODO(introducer.modifier_node_id(ModifierOrder::Decl),
|
|
"interface modifier");
|
|
}
|
|
|
|
if (!self_param_id.has_value() &&
|
|
introducer.modifier_set.HasAnyOf(KeywordModifierSet::Method)) {
|
|
CARBON_DIAGNOSTIC(VirtualWithoutSelf, Error, "virtual class function");
|
|
context.emitter().Emit(node_id, VirtualWithoutSelf);
|
|
introducer.modifier_set.Remove(KeywordModifierSet::Method);
|
|
}
|
|
}
|
|
|
|
// Returns the virtual-family modifier as an enum.
|
|
static auto GetVirtualModifier(const KeywordModifierSet& modifier_set)
|
|
-> SemIR::Function::VirtualModifier {
|
|
return modifier_set.ToEnum<SemIR::Function::VirtualModifier>()
|
|
.Case(KeywordModifierSet::Virtual,
|
|
SemIR::Function::VirtualModifier::Virtual)
|
|
.Case(KeywordModifierSet::Abstract,
|
|
SemIR::Function::VirtualModifier::Abstract)
|
|
.Case(KeywordModifierSet::Override,
|
|
SemIR::Function::VirtualModifier::Override)
|
|
.Default(SemIR::Function::VirtualModifier::None);
|
|
}
|
|
|
|
// Returns the evaluation modifier as an enum.
|
|
static auto GetEvaluationMode(const KeywordModifierSet& modifier_set)
|
|
-> SemIR::Function::EvaluationMode {
|
|
return modifier_set.ToEnum<SemIR::Function::EvaluationMode>()
|
|
.Case(KeywordModifierSet::Eval, SemIR::Function::EvaluationMode::Eval)
|
|
.Case(KeywordModifierSet::MustEval,
|
|
SemIR::Function::EvaluationMode::MustEval)
|
|
.Default(SemIR::Function::EvaluationMode::None);
|
|
}
|
|
|
|
// Tries to merge new_function into prev_function_id. Since new_function won't
|
|
// have a definition even if one is upcoming, set is_definition to indicate the
|
|
// planned result.
|
|
//
|
|
// If merging is successful, returns true and may update the previous function.
|
|
// Otherwise, returns false. Prints a diagnostic when appropriate.
|
|
static auto MergeFunctionRedecl(Context& context,
|
|
Parse::AnyFunctionDeclId node_id,
|
|
SemIR::Function& new_function,
|
|
bool new_is_definition,
|
|
SemIR::FunctionId prev_function_id,
|
|
SemIR::ImportIRId prev_import_ir_id) -> bool {
|
|
auto& prev_function = context.functions().Get(prev_function_id);
|
|
|
|
if (!CheckFunctionTypeMatches(context, new_function, prev_function)) {
|
|
return false;
|
|
}
|
|
|
|
DiagnoseIfInvalidRedecl(
|
|
context, Lex::TokenKind::Fn, prev_function.name_id,
|
|
RedeclInfo(new_function, node_id, new_is_definition),
|
|
RedeclInfo(prev_function, SemIR::LocId(prev_function.latest_decl_id()),
|
|
prev_function.has_definition_started()),
|
|
prev_import_ir_id);
|
|
if (new_is_definition && prev_function.has_definition_started()) {
|
|
return false;
|
|
}
|
|
|
|
if (!prev_function.first_owning_decl_id.has_value()) {
|
|
prev_function.first_owning_decl_id = new_function.first_owning_decl_id;
|
|
}
|
|
if (new_is_definition) {
|
|
// Track the signature from the definition, so that IDs in the body
|
|
// match IDs in the signature.
|
|
prev_function.MergeDefinition(new_function);
|
|
prev_function.call_param_patterns_id = new_function.call_param_patterns_id;
|
|
prev_function.call_params_id = new_function.call_params_id;
|
|
prev_function.return_type_inst_id = new_function.return_type_inst_id;
|
|
prev_function.return_form_inst_id = new_function.return_form_inst_id;
|
|
prev_function.return_patterns_id = new_function.return_patterns_id;
|
|
prev_function.self_param_id = new_function.self_param_id;
|
|
}
|
|
if (prev_import_ir_id.has_value()) {
|
|
ReplacePrevInstForMerge(context, new_function.parent_scope_id,
|
|
prev_function.name_id,
|
|
new_function.first_owning_decl_id);
|
|
}
|
|
return true;
|
|
}
|
|
|
|
// Check whether this is a redeclaration, merging if needed.
|
|
static auto TryMergeRedecl(Context& context, Parse::AnyFunctionDeclId node_id,
|
|
const DeclNameStack::NameContext& name_context,
|
|
SemIR::FunctionDecl& function_decl,
|
|
SemIR::Function& function_info, bool is_definition)
|
|
-> void {
|
|
if (name_context.state == DeclNameStack::NameContext::State::Poisoned) {
|
|
DiagnosePoisonedName(context, name_context.name_id_for_new_inst(),
|
|
name_context.poisoning_loc_id, name_context.loc_id);
|
|
return;
|
|
}
|
|
|
|
auto prev_id = name_context.prev_inst_id();
|
|
if (!prev_id.has_value()) {
|
|
return;
|
|
}
|
|
|
|
auto prev_function_id = SemIR::FunctionId::None;
|
|
auto prev_type_id = SemIR::TypeId::None;
|
|
auto prev_import_ir_id = SemIR::ImportIRId::None;
|
|
CARBON_KIND_SWITCH(context.insts().Get(prev_id)) {
|
|
case CARBON_KIND(SemIR::AssociatedEntity assoc_entity): {
|
|
// This is a function in an interface definition scope (see
|
|
// NameScope::is_interface_definition()).
|
|
auto function_decl =
|
|
context.insts().GetAs<SemIR::FunctionDecl>(assoc_entity.decl_id);
|
|
prev_function_id = function_decl.function_id;
|
|
prev_type_id = function_decl.type_id;
|
|
break;
|
|
}
|
|
case CARBON_KIND(SemIR::FunctionDecl function_decl): {
|
|
prev_function_id = function_decl.function_id;
|
|
prev_type_id = function_decl.type_id;
|
|
break;
|
|
}
|
|
case SemIR::ImportRefLoaded::Kind: {
|
|
auto import_ir_inst = GetCanonicalImportIRInst(context, prev_id);
|
|
|
|
// Verify the decl so that things like aliases are name conflicts.
|
|
const auto* import_ir =
|
|
context.import_irs().Get(import_ir_inst.ir_id()).sem_ir;
|
|
if (!import_ir->insts().Is<SemIR::FunctionDecl>(
|
|
import_ir_inst.inst_id())) {
|
|
break;
|
|
}
|
|
|
|
// Use the type to get the ID.
|
|
if (auto struct_value = context.insts().TryGetAs<SemIR::StructValue>(
|
|
context.constant_values().GetConstantInstId(prev_id))) {
|
|
if (auto function_type = context.types().TryGetAs<SemIR::FunctionType>(
|
|
struct_value->type_id)) {
|
|
prev_function_id = function_type->function_id;
|
|
prev_type_id = struct_value->type_id;
|
|
prev_import_ir_id = import_ir_inst.ir_id();
|
|
}
|
|
}
|
|
break;
|
|
}
|
|
default:
|
|
break;
|
|
}
|
|
|
|
if (!prev_function_id.has_value()) {
|
|
DiagnoseDuplicateName(context, name_context.name_id, name_context.loc_id,
|
|
SemIR::LocId(prev_id));
|
|
return;
|
|
}
|
|
|
|
if (MergeFunctionRedecl(context, node_id, function_info, is_definition,
|
|
prev_function_id, prev_import_ir_id)) {
|
|
// When merging, use the existing function rather than adding a new one.
|
|
function_decl.function_id = prev_function_id;
|
|
function_decl.type_id = prev_type_id;
|
|
}
|
|
}
|
|
|
|
// Adds the declaration to name lookup when appropriate.
|
|
static auto MaybeAddToNameLookup(Context& context,
|
|
const DeclNameStack::NameContext& name_context,
|
|
const KeywordModifierSet& modifier_set,
|
|
SemIR::NameScopeId parent_scope_id,
|
|
SemIR::InstId decl_id) -> void {
|
|
if (name_context.state == DeclNameStack::NameContext::State::Poisoned ||
|
|
name_context.prev_inst_id().has_value()) {
|
|
return;
|
|
}
|
|
|
|
// At interface scope, a function declaration introduces an associated
|
|
// function.
|
|
auto lookup_result_id = decl_id;
|
|
if (parent_scope_id.has_value() && !name_context.has_qualifiers) {
|
|
const auto& parent_scope = context.name_scopes().Get(parent_scope_id);
|
|
if (parent_scope.is_interface_definition()) {
|
|
auto interface_decl = context.insts().GetAs<SemIR::InterfaceWithSelfDecl>(
|
|
parent_scope.inst_id());
|
|
lookup_result_id =
|
|
BuildAssociatedEntity(context, interface_decl.interface_id, decl_id);
|
|
}
|
|
}
|
|
|
|
context.decl_name_stack().AddName(name_context, lookup_result_id,
|
|
modifier_set.GetAccessKind());
|
|
}
|
|
|
|
// Returns whether the given type is `i32`.
|
|
static auto IsI32(Context& context, Parse::NodeId node_id,
|
|
SemIR::TypeId type_id) -> bool {
|
|
return type_id == MakeIntType(context, node_id, SemIR::IntKind::Signed,
|
|
context.ints().Add(32));
|
|
}
|
|
|
|
// Returns whether the given parameter list is valid for the entry point
|
|
// function `Main.Run`.
|
|
static auto IsValidEntryPointParamList(Context& context, Parse::NodeId node_id,
|
|
SemIR::InstBlockId param_patterns_id)
|
|
-> bool {
|
|
if (!param_patterns_id.has_value()) {
|
|
// Positional parameters for are not supported.
|
|
return false;
|
|
}
|
|
|
|
for (auto [index, param_pattern_id] :
|
|
llvm::enumerate(context.inst_blocks().Get(param_patterns_id))) {
|
|
if (param_pattern_id == SemIR::ErrorInst::InstId) {
|
|
// Ignore erroneous parameters.
|
|
continue;
|
|
}
|
|
|
|
auto param =
|
|
context.insts().TryGetAs<SemIR::ValueParamPattern>(param_pattern_id);
|
|
if (!param) {
|
|
// Only value parameters are supported for now.
|
|
return false;
|
|
}
|
|
|
|
if (param->type_id == SemIR::ErrorInst::TypeId) {
|
|
// Ignore parameters with erroneous types.
|
|
continue;
|
|
}
|
|
|
|
auto param_type_inst_id = context.types()
|
|
.GetAs<SemIR::PatternType>(param->type_id)
|
|
.scrutinee_type_inst_id;
|
|
switch (index) {
|
|
case 0: {
|
|
// `argc` should be a 32-bit integer.
|
|
if (!IsI32(
|
|
context, node_id,
|
|
context.types().GetTypeIdForTypeInstId(param_type_inst_id))) {
|
|
return false;
|
|
}
|
|
break;
|
|
}
|
|
case 1: {
|
|
// `argv` should be a pointer.
|
|
// TODO: Consider checking the pointee type also.
|
|
if (!context.insts().Is<SemIR::PointerType>(param_type_inst_id)) {
|
|
return false;
|
|
}
|
|
break;
|
|
}
|
|
default: {
|
|
// TODO: Decide whether to allow a third `envp` parameter.
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
// Returns whether the given return type is valid for the entry point
|
|
// function `Main.Run`.
|
|
static auto IsValidEntryPointReturnType(Context& context, Parse::NodeId node_id,
|
|
SemIR::TypeId return_type_id) -> bool {
|
|
// An implicit or explicit return type of `()` is OK.
|
|
// TODO: Translate this to returning an `i32` with value `0` in lowering.
|
|
if (!return_type_id.has_value()) {
|
|
return true;
|
|
}
|
|
if (return_type_id == GetTupleType(context, {})) {
|
|
return true;
|
|
}
|
|
|
|
if (IsI32(context, node_id, return_type_id)) {
|
|
// Explicit return type of `i32` or an adapter for it is OK.
|
|
return true;
|
|
}
|
|
|
|
// For now, disallow anything else.
|
|
// TODO: Decide on valid return types for `Main.Run`. Perhaps we should
|
|
// have an interface for this.
|
|
return false;
|
|
}
|
|
|
|
// If the function is the entry point, do corresponding validation.
|
|
static auto ValidateForEntryPoint(Context& context,
|
|
Parse::AnyFunctionDeclId node_id,
|
|
SemIR::FunctionId function_id,
|
|
const SemIR::Function& function_info)
|
|
-> void {
|
|
if (!SemIR::IsEntryPoint(context.sem_ir(), function_id)) {
|
|
return;
|
|
}
|
|
|
|
// TODO: Update this once valid signatures for the entry point are decided.
|
|
// See https://github.com/carbon-language/carbon-lang/issues/6735
|
|
if (function_info.implicit_param_patterns_id.has_value() ||
|
|
!IsValidEntryPointParamList(context, node_id,
|
|
function_info.param_patterns_id)) {
|
|
CARBON_DIAGNOSTIC(InvalidMainRunParameters, Error,
|
|
"invalid parameters for `Main.Run` function; expected "
|
|
"`()` or `(argc: i32, argv: Core.Optional(char*)*)`");
|
|
context.emitter().Emit(node_id, InvalidMainRunParameters);
|
|
} else if (!IsValidEntryPointReturnType(
|
|
context, node_id,
|
|
function_info.GetDeclaredReturnType(context.sem_ir()))) {
|
|
CARBON_DIAGNOSTIC(InvalidMainRunReturnType, Error,
|
|
"invalid return type for `Main.Run` function; expected "
|
|
"`fn (...)` or `fn (...) -> i32`");
|
|
context.emitter().Emit(node_id, InvalidMainRunReturnType);
|
|
}
|
|
}
|
|
|
|
static auto IsGenericFunction(Context& context,
|
|
SemIR::GenericId function_generic_id,
|
|
SemIR::GenericId class_generic_id) -> bool {
|
|
if (function_generic_id == SemIR::GenericId::None) {
|
|
return false;
|
|
}
|
|
|
|
if (class_generic_id == SemIR::GenericId::None) {
|
|
return true;
|
|
}
|
|
|
|
const auto& function_generic = context.generics().Get(function_generic_id);
|
|
const auto& class_generic = context.generics().Get(class_generic_id);
|
|
|
|
auto function_bindings =
|
|
context.inst_blocks().Get(function_generic.bindings_id);
|
|
auto class_bindings = context.inst_blocks().Get(class_generic.bindings_id);
|
|
|
|
// If the function's bindings are the same size as the class's bindings,
|
|
// then there are no extra bindings for the function, so it is effectively
|
|
// non-generic within the scope of a specific of the class.
|
|
return class_bindings.size() != function_bindings.size();
|
|
}
|
|
|
|
// Requests a vtable be created when processing a virtual function.
|
|
static auto RequestVtableIfVirtual(
|
|
Context& context, Parse::AnyFunctionDeclId node_id,
|
|
SemIR::Function::VirtualModifier& virtual_modifier,
|
|
const std::optional<SemIR::Inst>& parent_scope_inst, SemIR::InstId decl_id,
|
|
SemIR::GenericId generic_id) -> void {
|
|
// In order to request a vtable, the function must be virtual, and in a class
|
|
// scope.
|
|
if (virtual_modifier == SemIR::Function::VirtualModifier::None ||
|
|
!parent_scope_inst) {
|
|
return;
|
|
}
|
|
auto class_decl = parent_scope_inst->TryAs<SemIR::ClassDecl>();
|
|
if (!class_decl) {
|
|
return;
|
|
}
|
|
|
|
auto& class_info = context.classes().Get(class_decl->class_id);
|
|
if (virtual_modifier == SemIR::Function::VirtualModifier::Override &&
|
|
!class_info.base_id.has_value()) {
|
|
CARBON_DIAGNOSTIC(OverrideWithoutBase, Error,
|
|
"override without base class");
|
|
context.emitter().Emit(node_id, OverrideWithoutBase);
|
|
virtual_modifier = SemIR::Function::VirtualModifier::None;
|
|
return;
|
|
}
|
|
|
|
if (IsGenericFunction(context, generic_id, class_info.generic_id)) {
|
|
CARBON_DIAGNOSTIC(GenericVirtual, Error, "generic virtual function");
|
|
context.emitter().Emit(node_id, GenericVirtual);
|
|
virtual_modifier = SemIR::Function::VirtualModifier::None;
|
|
return;
|
|
}
|
|
|
|
// TODO: If this is an `impl` function, check there's a matching base
|
|
// function that's impl or virtual.
|
|
class_info.is_dynamic = true;
|
|
context.vtable_stack().AddInstId(decl_id);
|
|
}
|
|
|
|
// Diagnoses when positional params aren't supported. Reassigns the pattern
|
|
// block if needed.
|
|
static auto DiagnosePositionalParams(Context& context,
|
|
SemIR::Function& function_info) -> void {
|
|
if (function_info.param_patterns_id.has_value()) {
|
|
return;
|
|
}
|
|
|
|
context.TODO(function_info.latest_decl_id(),
|
|
"function with positional parameters");
|
|
function_info.param_patterns_id = SemIR::InstBlockId::Empty;
|
|
}
|
|
|
|
// Build a FunctionDecl describing the signature of a function. This
|
|
// handles the common logic shared by function declaration syntax and function
|
|
// definition syntax.
|
|
static auto BuildFunctionDecl(Context& context,
|
|
Parse::AnyFunctionDeclId node_id,
|
|
bool is_definition)
|
|
-> std::pair<SemIR::FunctionId, SemIR::InstId> {
|
|
auto return_patterns_id = SemIR::InstBlockId::None;
|
|
auto return_type_inst_id = SemIR::TypeInstId::None;
|
|
auto return_form_inst_id = SemIR::InstId::None;
|
|
if (auto [return_node, maybe_return_patterns_id] =
|
|
context.node_stack().PopWithNodeIdIf<Parse::NodeKind::ReturnType>();
|
|
maybe_return_patterns_id) {
|
|
return_patterns_id = *maybe_return_patterns_id;
|
|
auto return_form = context.PopReturnForm();
|
|
return_type_inst_id = return_form.type_component_inst_id;
|
|
return_form_inst_id = return_form.form_inst_id;
|
|
}
|
|
|
|
auto name = PopNameComponent(context, return_patterns_id);
|
|
auto name_context = context.decl_name_stack().FinishName(name);
|
|
|
|
context.node_stack()
|
|
.PopAndDiscardSoloNodeId<Parse::NodeKind::FunctionIntroducer>();
|
|
|
|
auto self_param_id =
|
|
FindSelfPattern(context, name.implicit_param_patterns_id);
|
|
|
|
// Process modifiers.
|
|
auto [parent_scope_inst_id, parent_scope_inst] =
|
|
context.name_scopes().GetInstIfValid(name_context.parent_scope_id);
|
|
auto introducer =
|
|
context.decl_introducer_state_stack().Pop<Lex::TokenKind::Fn>();
|
|
DiagnoseModifiers(context, node_id, introducer, is_definition,
|
|
name_context.parent_scope_id, parent_scope_inst_id,
|
|
parent_scope_inst, self_param_id);
|
|
bool is_extern = introducer.modifier_set.HasAnyOf(KeywordModifierSet::Extern);
|
|
auto virtual_modifier = GetVirtualModifier(introducer.modifier_set);
|
|
auto evaluation_mode = GetEvaluationMode(introducer.modifier_set);
|
|
|
|
// Add the function declaration.
|
|
SemIR::FunctionDecl function_decl = {SemIR::TypeId::None,
|
|
SemIR::FunctionId::None,
|
|
context.inst_block_stack().Pop()};
|
|
auto decl_id = AddPlaceholderInst(context, node_id, function_decl);
|
|
|
|
// Build the function entity. This will be merged into an existing function if
|
|
// there is one, or otherwise added to the function store.
|
|
auto function_info =
|
|
SemIR::Function{name_context.MakeEntityWithParamsBase(
|
|
name, decl_id, is_extern, introducer.extern_library),
|
|
{.call_param_patterns_id = name.call_param_patterns_id,
|
|
.call_params_id = name.call_params_id,
|
|
.call_param_ranges = name.param_ranges,
|
|
.return_type_inst_id = return_type_inst_id,
|
|
.return_form_inst_id = return_form_inst_id,
|
|
.return_patterns_id = return_patterns_id,
|
|
.virtual_modifier = virtual_modifier,
|
|
.evaluation_mode = evaluation_mode,
|
|
.self_param_id = self_param_id}};
|
|
if (is_definition) {
|
|
function_info.definition_id = decl_id;
|
|
}
|
|
|
|
DiagnosePositionalParams(context, function_info);
|
|
|
|
TryMergeRedecl(context, node_id, name_context, function_decl, function_info,
|
|
is_definition);
|
|
|
|
// Create a new function if this isn't a valid redeclaration.
|
|
if (!function_decl.function_id.has_value()) {
|
|
if (function_info.is_extern && context.sem_ir().is_impl()) {
|
|
DiagnoseExternRequiresDeclInApiFile(context, node_id);
|
|
}
|
|
function_info.generic_id = BuildGenericDecl(context, decl_id);
|
|
function_decl.function_id = context.functions().Add(function_info);
|
|
function_decl.type_id =
|
|
GetFunctionType(context, function_decl.function_id,
|
|
context.scope_stack().PeekSpecificId());
|
|
} else {
|
|
auto prev_decl_generic_id =
|
|
context.functions().Get(function_decl.function_id).generic_id;
|
|
FinishGenericRedecl(context, prev_decl_generic_id);
|
|
// TODO: Validate that the redeclaration doesn't set an access modifier.
|
|
}
|
|
|
|
RequestVtableIfVirtual(context, node_id, function_info.virtual_modifier,
|
|
parent_scope_inst, decl_id, function_info.generic_id);
|
|
|
|
// Write the function ID into the FunctionDecl.
|
|
ReplaceInstBeforeConstantUse(context, decl_id, function_decl);
|
|
|
|
// Diagnose 'definition of `abstract` function' using the canonical Function's
|
|
// modifiers.
|
|
if (is_definition &&
|
|
context.functions().Get(function_decl.function_id).virtual_modifier ==
|
|
SemIR::Function::VirtualModifier::Abstract) {
|
|
CARBON_DIAGNOSTIC(DefinedAbstractFunction, Error,
|
|
"definition of `abstract` function");
|
|
context.emitter().Emit(LocIdForDiagnostics::TokenOnly(node_id),
|
|
DefinedAbstractFunction);
|
|
}
|
|
|
|
// Add to name lookup if needed, now that the decl is built.
|
|
MaybeAddToNameLookup(context, name_context, introducer.modifier_set,
|
|
name_context.parent_scope_id, decl_id);
|
|
|
|
ValidateForEntryPoint(context, node_id, function_decl.function_id,
|
|
function_info);
|
|
|
|
if (!is_definition && context.sem_ir().is_impl() && !is_extern) {
|
|
context.definitions_required_by_decl().push_back(decl_id);
|
|
}
|
|
|
|
return {function_decl.function_id, decl_id};
|
|
}
|
|
|
|
// Checks that "unused" marker is only used in definitions, and emits a
|
|
// diagnostic for every binding that is marked unused.
|
|
static auto CheckUnusedBindingsInPattern(Context& context,
|
|
SemIR::InstId pattern_id) -> void {
|
|
llvm::SmallVector<SemIR::InstId> work_list;
|
|
work_list.push_back(pattern_id);
|
|
|
|
while (!work_list.empty()) {
|
|
auto current_id = work_list.pop_back_val();
|
|
auto inst = context.insts().Get(current_id);
|
|
CARBON_KIND_SWITCH(inst) {
|
|
case CARBON_KIND_ANY(SemIR::AnyParamPattern, param): {
|
|
work_list.push_back(param.subpattern_id);
|
|
break;
|
|
}
|
|
case CARBON_KIND_ANY(SemIR::AnyBindingPattern, bind): {
|
|
auto& entity_name = context.entity_names().Get(bind.entity_name_id);
|
|
// We need special treatment for the name "_" which is implicitly
|
|
// unused but actually permitted in declarations.
|
|
if (entity_name.is_unused &&
|
|
entity_name.name_id != SemIR::NameId::Underscore) {
|
|
CARBON_DIAGNOSTIC(UnusedModifierOnDeclaration, Error,
|
|
"`unused` modifier on declaration");
|
|
context.emitter().Emit(current_id, UnusedModifierOnDeclaration);
|
|
}
|
|
break;
|
|
}
|
|
case CARBON_KIND(SemIR::VarPattern var_pattern): {
|
|
work_list.push_back(var_pattern.subpattern_id);
|
|
break;
|
|
}
|
|
case CARBON_KIND(SemIR::TuplePattern tuple_pattern): {
|
|
auto elements = context.inst_blocks().Get(tuple_pattern.elements_id);
|
|
for (auto element_id : llvm::reverse(elements)) {
|
|
work_list.push_back(element_id);
|
|
}
|
|
break;
|
|
}
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
static auto DiagnoseUnusedMarkersInDeclaration(Context& context,
|
|
SemIR::FunctionId function_id)
|
|
-> void {
|
|
const auto& function = context.functions().Get(function_id);
|
|
if (function.param_patterns_id.has_value()) {
|
|
for (auto pattern_id :
|
|
context.inst_blocks().Get(function.param_patterns_id)) {
|
|
CheckUnusedBindingsInPattern(context, pattern_id);
|
|
}
|
|
}
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::FunctionDeclId node_id) -> bool {
|
|
auto [function_id, decl_id] =
|
|
BuildFunctionDecl(context, node_id, /*is_definition=*/false);
|
|
DiagnoseUnusedMarkersInDeclaration(context, function_id);
|
|
context.decl_name_stack().PopScope();
|
|
return true;
|
|
}
|
|
|
|
// Processes a function definition after a signature for which we have already
|
|
// built a function ID. This logic is shared between processing regular function
|
|
// definitions and delayed parsing of inline method definitions.
|
|
static auto HandleFunctionDefinitionAfterSignature(
|
|
Context& context, Parse::FunctionDefinitionStartId node_id,
|
|
SemIR::FunctionId function_id, SemIR::InstId decl_id) -> void {
|
|
StartFunctionDefinition(context, decl_id, function_id);
|
|
context.node_stack().Push(node_id, function_id);
|
|
}
|
|
|
|
auto HandleFunctionDefinitionSuspend(Context& context,
|
|
Parse::FunctionDefinitionStartId node_id)
|
|
-> DeferredDefinitionWorklist::SuspendedFunction {
|
|
// Process the declaration portion of the function.
|
|
auto [function_id, decl_id] =
|
|
BuildFunctionDecl(context, node_id, /*is_definition=*/true);
|
|
return {.function_id = function_id,
|
|
.decl_id = decl_id,
|
|
.saved_name_state = context.decl_name_stack().Suspend()};
|
|
}
|
|
|
|
auto HandleFunctionDefinitionResume(
|
|
Context& context, Parse::FunctionDefinitionStartId node_id,
|
|
DeferredDefinitionWorklist::SuspendedFunction&& suspended_fn) -> void {
|
|
context.decl_name_stack().Restore(std::move(suspended_fn.saved_name_state));
|
|
HandleFunctionDefinitionAfterSignature(
|
|
context, node_id, suspended_fn.function_id, suspended_fn.decl_id);
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::FunctionDefinitionStartId node_id)
|
|
-> bool {
|
|
// Process the declaration portion of the function.
|
|
auto [function_id, decl_id] =
|
|
BuildFunctionDecl(context, node_id, /*is_definition=*/true);
|
|
HandleFunctionDefinitionAfterSignature(context, node_id, function_id,
|
|
decl_id);
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::FunctionDefinitionId node_id)
|
|
-> bool {
|
|
SemIR::FunctionId function_id =
|
|
context.node_stack().Pop<Parse::NodeKind::FunctionDefinitionStart>();
|
|
|
|
// If the `}` of the function is reachable, reject if we need a return value
|
|
// and otherwise add an implicit `return;`.
|
|
if (IsCurrentPositionReachable(context)) {
|
|
if (context.functions().Get(function_id).return_form_inst_id.has_value()) {
|
|
CARBON_DIAGNOSTIC(
|
|
MissingReturnStatement, Error,
|
|
"missing `return` at end of function with declared return type");
|
|
context.emitter().Emit(LocIdForDiagnostics::TokenOnly(node_id),
|
|
MissingReturnStatement);
|
|
} else {
|
|
AddReturnCleanupBlock(context, node_id);
|
|
}
|
|
}
|
|
|
|
FinishFunctionDefinition(context, function_id);
|
|
context.decl_name_stack().PopScope(/*check_unused=*/true);
|
|
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context,
|
|
Parse::BuiltinFunctionDefinitionStartId node_id) -> bool {
|
|
// Process the declaration portion of the function.
|
|
auto [function_id, _] =
|
|
BuildFunctionDecl(context, node_id, /*is_definition=*/true);
|
|
context.node_stack().Push(node_id, function_id);
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::BuiltinNameId node_id) -> bool {
|
|
context.node_stack().Push(node_id);
|
|
return true;
|
|
}
|
|
|
|
// Looks up a builtin function kind given its name as a string.
|
|
// TODO: Move this out to another file.
|
|
static auto LookupBuiltinFunctionKind(Context& context,
|
|
Parse::BuiltinNameId name_id)
|
|
-> SemIR::BuiltinFunctionKind {
|
|
auto builtin_name = context.string_literal_values().Get(
|
|
context.tokens().GetStringLiteralValue(
|
|
context.parse_tree().node_token(name_id)));
|
|
auto kind = SemIR::BuiltinFunctionKind::ForBuiltinName(builtin_name);
|
|
if (kind == SemIR::BuiltinFunctionKind::None) {
|
|
CARBON_DIAGNOSTIC(UnknownBuiltinFunctionName, Error,
|
|
"unknown builtin function name \"{0}\"", std::string);
|
|
context.emitter().Emit(name_id, UnknownBuiltinFunctionName,
|
|
builtin_name.str());
|
|
}
|
|
return kind;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context,
|
|
Parse::BuiltinFunctionDefinitionId /*node_id*/) -> bool {
|
|
auto name_id =
|
|
context.node_stack().PopForSoloNodeId<Parse::NodeKind::BuiltinName>();
|
|
auto [fn_node_id, function_id] =
|
|
context.node_stack()
|
|
.PopWithNodeId<Parse::NodeKind::BuiltinFunctionDefinitionStart>();
|
|
|
|
auto builtin_kind = LookupBuiltinFunctionKind(context, name_id);
|
|
if (builtin_kind != SemIR::BuiltinFunctionKind::None) {
|
|
CheckFunctionDefinitionSignature(context, function_id);
|
|
|
|
auto& function = context.functions().Get(function_id);
|
|
if (IsValidBuiltinDeclaration(context, function, builtin_kind)) {
|
|
function.SetBuiltinFunction(builtin_kind);
|
|
// Build an empty generic definition if this is a generic builtin.
|
|
StartGenericDefinition(context, function.generic_id);
|
|
FinishGenericDefinition(context, function.generic_id);
|
|
} else {
|
|
CARBON_DIAGNOSTIC(InvalidBuiltinSignature, Error,
|
|
"invalid signature for builtin function \"{0}\"",
|
|
std::string);
|
|
context.emitter().Emit(fn_node_id, InvalidBuiltinSignature,
|
|
builtin_kind.name().str());
|
|
}
|
|
}
|
|
context.decl_name_stack().PopScope();
|
|
return true;
|
|
}
|
|
|
|
auto HandleParseNode(Context& context, Parse::FunctionTerseDefinitionId node_id)
|
|
-> bool {
|
|
return context.TODO(node_id, "HandleFunctionTerseDefinition");
|
|
}
|
|
|
|
} // namespace Carbon::Check
|