mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-11-17 00:58:40 +00:00
As proposed in [Carbon: C++ interop for overloaded functions and function templates](https://docs.google.com/document/d/1KUxumZtNe3mY3TsjW2s_ZADOlAaFlrtsLKHVILtqIaM/edit?tab=t.0), Clang is used to perform the overload resolution using C++ rules, when an overloaded C++ set is called from Carbon. Once a function is selected, it's converted into a Carbon function and called using the Carbon rules including argument conversions. A single non-templated function is treated the same way as an overload set and the same rules apply for its call. Template functions are not supported yet. Demo: a) Non-templated function calls: ```c++ // --- overloads.h auto foo(int a, short b) -> void; auto foo(double a) -> void; auto foo(int a) -> void; ``` ```c++ // overloads.cpp #include "overloads.h" #include <cstdio> auto foo(int a, short b) -> void { printf("hello from foo_int_short(%d, %d) \n", a, b); } auto foo(double a) -> void { printf("hello from foo_double(%f) \n", a); } auto foo(int a) -> void { printf("hello from foo_int(%d) \n", a); } ``` ```c++ library "Main"; import Cpp library "overloads.h"; fn Run() -> i32 { Cpp.foo(1.1 as f64); return 0; } ``` ``` $ clang -c overloads.cpp $ bazel-bin/toolchain/carbon compile main.carbon $ bazel-bin/toolchain/carbon link overloads.o main.o --output=demo $ ./demo hello from foo_double(1.100000) ``` b) Constructors: ```c++ // --- constructor_overloads.h class C { public: C(); C(int a, int b); }; ``` ```c++ // constructor_overloads.cpp #include "constructor_overloads.h" #include <cstdio> C::C() { printf("hello from C() \n"); } C::C(int a, int b) { printf("hello from C(%d, %d) \n", a, b); } ``` ```c++ library "Main"; import Cpp library "constructor_overloads.h"; fn Run() -> i32 { let c1: Cpp.C = Cpp.C.C(); let c2: Cpp.C = Cpp.C.C(1, 2); return 0; } ``` ``` $ clang -c constructor_overloads.cpp $ bazel-bin/toolchain/carbon compile main.carbon $ bazel-bin/toolchain/carbon link constructor_overloads.o main.o \--output=demo $ ./demo hello from C() hello from C(1, 2) ``` Follow-ups: - `Cpp.foo({})` - proper handling of struct literals as call args. - Fix access for overloaded sets. - Fix tests: - Method calls: `error: missing object argument in method call [MissingObjectInMethodCall]` in tests. - Fix `toolchain/check/testdata/interop/cpp/import.carbon` test. - Fix `enums` support. - Fix `str` -> `std::string_view` mapping. Part of #5915
127 lines
5.4 KiB
C++
127 lines
5.4 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_CHECK_TYPE_H_
|
|
#define CARBON_TOOLCHAIN_CHECK_TYPE_H_
|
|
|
|
#include "llvm/ADT/ArrayRef.h"
|
|
#include "toolchain/check/context.h"
|
|
#include "toolchain/sem_ir/ids.h"
|
|
|
|
namespace Carbon::Check {
|
|
|
|
// Enforces that an integer type has a valid bit width.
|
|
auto ValidateIntType(Context& context, SemIR::LocId loc_id,
|
|
SemIR::IntType result) -> bool;
|
|
|
|
// Enforces that a float type has a valid bit width. If the `float_kind` field
|
|
// is `None`, sets it to a suitable kind for the bit width.
|
|
auto ValidateFloatTypeAndSetKind(Context& context, SemIR::LocId loc_id,
|
|
SemIR::FloatType& result) -> bool;
|
|
|
|
// Gets the type to use for an unbound associated entity declared in this
|
|
// interface. For example, this is the type of `I.T` after
|
|
// `interface I { let T:! type; }`. The name of the interface is used for
|
|
// diagnostics.
|
|
// TODO: Should we use a different type for each such entity, or the same type
|
|
// for all associated entities?
|
|
auto GetAssociatedEntityType(Context& context, SemIR::InterfaceId interface_id,
|
|
SemIR::SpecificId interface_specific_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets a singleton type. The returned type will be complete. Requires that
|
|
// `singleton_id` is already validated to be a singleton.
|
|
auto GetSingletonType(Context& context, SemIR::TypeInstId singleton_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets a const-qualified version of a type.
|
|
auto GetConstType(Context& context, SemIR::TypeInstId inner_type_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets a qualified version of a type.
|
|
auto GetQualifiedType(Context& context, SemIR::TypeId type_id,
|
|
SemIR::TypeQualifiers quals) -> SemIR::TypeId;
|
|
|
|
// Gets a class type.
|
|
auto GetClassType(Context& context, SemIR::ClassId class_id,
|
|
SemIR::SpecificId specific_id) -> SemIR::TypeId;
|
|
|
|
// Gets a C++ overload set type. The returned type will be complete.
|
|
auto GetCppOverloadSetType(Context& context,
|
|
SemIR::CppOverloadSetId overload_set_id,
|
|
SemIR::SpecificId specific_id) -> SemIR::TypeId;
|
|
|
|
// Gets a function type. The returned type will be complete.
|
|
auto GetFunctionType(Context& context, SemIR::FunctionId fn_id,
|
|
SemIR::SpecificId specific_id) -> SemIR::TypeId;
|
|
|
|
auto GetVtableType(Context& context, SemIR::VtableId vtable_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets the type of an associated function with the `Self` parameter bound to
|
|
// a particular value. The returned type will be complete.
|
|
auto GetFunctionTypeWithSelfType(Context& context,
|
|
SemIR::TypeInstId interface_function_type_id,
|
|
SemIR::InstId self_id) -> SemIR::TypeId;
|
|
|
|
// Gets a generic class type, which is the type of a name of a generic class,
|
|
// such as the type of `Vector` given `class Vector(T:! type)`. The returned
|
|
// type will be complete.
|
|
auto GetGenericClassType(Context& context, SemIR::ClassId class_id,
|
|
SemIR::SpecificId enclosing_specific_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets a generic interface type, which is the type of a name of a generic
|
|
// interface, such as the type of `AddWith` given
|
|
// `interface AddWith(T:! type)`. The returned type will be complete.
|
|
auto GetGenericInterfaceType(Context& context, SemIR::InterfaceId interface_id,
|
|
SemIR::SpecificId enclosing_specific_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Gets the facet type corresponding to a particular interface.
|
|
auto GetInterfaceType(Context& context, SemIR::InterfaceId interface_id,
|
|
SemIR::SpecificId specific_id) -> SemIR::TypeId;
|
|
|
|
// Gets the facet type for the given `info`.
|
|
auto GetFacetType(Context& context, const SemIR::FacetTypeInfo& info)
|
|
-> SemIR::TypeId;
|
|
|
|
// Returns a pointer type whose pointee type is `pointee_type_id`.
|
|
auto GetPointerType(Context& context, SemIR::TypeInstId pointee_type_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Returns a struct type with the given fields.
|
|
auto GetStructType(Context& context, SemIR::StructTypeFieldsId fields_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Returns a tuple type with the given element types.
|
|
auto GetTupleType(Context& context, llvm::ArrayRef<SemIR::InstId> type_inst_ids)
|
|
-> SemIR::TypeId;
|
|
|
|
// Returns a pattern type with the given scrutinee type.
|
|
auto GetPatternType(Context& context, SemIR::TypeId scrutinee_type_id)
|
|
-> SemIR::TypeId;
|
|
|
|
// Returns an unbound element type.
|
|
auto GetUnboundElementType(Context& context, SemIR::TypeInstId class_type_id,
|
|
SemIR::TypeInstId element_type_id) -> SemIR::TypeId;
|
|
|
|
// Convert a facet value or type value instruction to a canonical facet or type
|
|
// value instruction.
|
|
//
|
|
// Type values are already canonical and are returned unchanged, except for
|
|
// `FacetAccessType` which is unwrapped to find the facet value it refers to.
|
|
//
|
|
// For facet values, unwraps `FacetValue` instructions to get to an underlying
|
|
// canonical type instruction.
|
|
auto GetCanonicalizedFacetOrTypeValue(Context& context, SemIR::InstId inst_id)
|
|
-> SemIR::InstId;
|
|
auto GetCanonicalizedFacetOrTypeValue(Context& context,
|
|
SemIR::ConstantId const_id)
|
|
-> SemIR::ConstantId;
|
|
|
|
} // namespace Carbon::Check
|
|
|
|
#endif // CARBON_TOOLCHAIN_CHECK_TYPE_H_
|