mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-11-22 00:06:41 +00:00
This shifts logic so that bindings are added to name lookup only after the scope is complete, removing logic around adding/removing/re-adding names in certain scopes. This does mean that things like a function's forward declaration will need to go through an extra hoop for name conflict checks, because under this approach a function definition does conflict checking when it adds names for the body's use. But, that seems easy to address, and better than the current hoops.
111 lines
4.1 KiB
C++
111 lines
4.1 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_LOWERING_LOWERING_CONTEXT_H_
|
|
#define CARBON_TOOLCHAIN_LOWERING_LOWERING_CONTEXT_H_
|
|
|
|
#include "llvm/IR/IRBuilder.h"
|
|
#include "llvm/IR/LLVMContext.h"
|
|
#include "llvm/IR/Module.h"
|
|
#include "toolchain/semantics/semantics_ir.h"
|
|
#include "toolchain/semantics/semantics_node.h"
|
|
|
|
namespace Carbon {
|
|
|
|
// Context and shared functionality for lowering handlers.
|
|
class LoweringContext {
|
|
public:
|
|
explicit LoweringContext(llvm::LLVMContext& llvm_context,
|
|
llvm::StringRef module_name,
|
|
const SemanticsIR& semantics_ir,
|
|
llvm::raw_ostream* vlog_stream);
|
|
|
|
// Lowers the SemanticsIR to LLVM IR. Should only be called once, and handles
|
|
// the main execution loop.
|
|
auto Run() -> std::unique_ptr<llvm::Module>;
|
|
|
|
// Returns a local (versus global) value for the given node.
|
|
auto GetLocal(SemanticsNodeId node_id) -> llvm::Value* {
|
|
auto it = locals_.find(node_id);
|
|
CARBON_CHECK(it != locals_.end()) << "Missing local: " << node_id;
|
|
return it->second;
|
|
}
|
|
|
|
// Returns a local (versus global) value for the given node in loaded state.
|
|
// Loads will only be inserted on an as-needed basis.
|
|
auto GetLocalLoaded(SemanticsNodeId node_id) -> llvm::Value*;
|
|
|
|
// Sets the value for the given node.
|
|
auto SetLocal(SemanticsNodeId node_id, llvm::Value* value) {
|
|
bool added = locals_.insert({node_id, value}).second;
|
|
CARBON_CHECK(added) << "Duplicate local insert: " << node_id;
|
|
}
|
|
|
|
// Gets a callable's function.
|
|
auto GetFunction(SemanticsFunctionId function_id) -> llvm::Function* {
|
|
CARBON_CHECK(functions_[function_id.index] != nullptr) << function_id;
|
|
return functions_[function_id.index];
|
|
}
|
|
|
|
// Returns a lowered type for the given type_id.
|
|
auto GetType(SemanticsTypeId type_id) -> llvm::Type* {
|
|
// Neither TypeType nor InvalidType should be passed in.
|
|
CARBON_CHECK(type_id.index >= 0) << type_id;
|
|
return types_[type_id.index];
|
|
}
|
|
|
|
auto llvm_context() -> llvm::LLVMContext& { return *llvm_context_; }
|
|
auto llvm_module() -> llvm::Module& { return *llvm_module_; }
|
|
auto builder() -> llvm::IRBuilder<>& { return builder_; }
|
|
auto semantics_ir() -> const SemanticsIR& { return *semantics_ir_; }
|
|
|
|
private:
|
|
// Builds the declaration for the given function, which should then be cached
|
|
// by the caller.
|
|
auto BuildFunctionDeclaration(SemanticsFunctionId function_id)
|
|
-> llvm::Function*;
|
|
|
|
// Builds the definition for the given function. If the function is only a
|
|
// declaration with no definition, does nothing.
|
|
auto BuildFunctionDefinition(SemanticsFunctionId function_id) -> void;
|
|
|
|
// Builds the type for the given node, which should then be cached by the
|
|
// caller.
|
|
auto BuildType(SemanticsNodeId node_id) -> llvm::Type*;
|
|
|
|
// State for building the LLVM IR.
|
|
llvm::LLVMContext* llvm_context_;
|
|
std::unique_ptr<llvm::Module> llvm_module_;
|
|
llvm::IRBuilder<> builder_;
|
|
|
|
// The input Semantics IR.
|
|
const SemanticsIR* const semantics_ir_;
|
|
|
|
// The optional vlog stream.
|
|
llvm::raw_ostream* vlog_stream_;
|
|
|
|
// Maps a function's SemanticsIR nodes to lowered values.
|
|
// TODO: Handle nested scopes. Right now this is just cleared at the end of
|
|
// every block.
|
|
llvm::DenseMap<SemanticsNodeId, llvm::Value*> locals_;
|
|
|
|
// Maps callables to lowered functions. Semantics treats callables as the
|
|
// canonical form of a function, so lowering needs to do the same.
|
|
llvm::SmallVector<llvm::Function*> functions_;
|
|
|
|
// Provides lowered versions of types.
|
|
llvm::SmallVector<llvm::Type*> types_;
|
|
};
|
|
|
|
// Declare handlers for each SemanticsIR node.
|
|
#define CARBON_SEMANTICS_NODE_KIND(Name) \
|
|
auto LoweringHandle##Name(LoweringContext& context, SemanticsNodeId node_id, \
|
|
SemanticsNode node) \
|
|
->void;
|
|
#include "toolchain/semantics/semantics_node_kind.def"
|
|
|
|
} // namespace Carbon
|
|
|
|
#endif // CARBON_TOOLCHAIN_LOWERING_LOWERING_CONTEXT_H_
|