mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-10-03 08:05:49 +01:00
Jon Ross-PerkinsandChandler Carruth
352fec1885
Example stack:
```
1. node_stack_:
0. FunctionDefinitionStart
1. ReturnStatement -> node1
2. node_block_stack_:
0. block0
1. block1
```
Example trace output:
```
*** SemanticsParseTreeHandler::Build Begin ***
Push 0: FunctionIntroducer
Push 1: DeclaredName
Push 2: ParameterListEnd
Pop 2: ParameterListEnd
Push 2: ParameterList
Pop 2: ParameterList
Pop 0: FunctionIntroducer
AddNode block0: FunctionDeclaration()
AddNode block0: BindName(ident0, node0)
AddNode block0: FunctionDefinition(node0, block1)
Push 0: FunctionDefinitionStart
Push 1: Literal -> IntegerLiteral
AddNode block1: IntegerLiteral(int0): node_xref1
Push 2: StatementEnd
Pop 2: StatementEnd
Pop 1: any (Literal) -> node0
Push 1: ReturnStatement -> ReturnExpression
AddNode block1: ReturnExpression(node0)
Pop 0: FunctionDefinitionStart
Push 0: FunctionDefinition
*** SemanticsParseTreeHandler::Build End ***
cross_reference_irs.size == 2,
cross_references = {
node_xref0 = "xref(ir0, block0, node0)";
node_xref1 = "xref(ir0, block0, node1)";
},
identifiers = {
ident0 = "Foo";
},
integer_literals = {
int0 = 0;
},
node_blocks = {
block0 = {
node0 = FunctionDeclaration();
node1 = BindName(ident0, node0);
node2 = FunctionDefinition(node0, block1);
},
block1 = {
node0 = IntegerLiteral(int0): node_xref1;
node1 = ReturnExpression(node0);
},
}
```
Co-authored-by: Chandler Carruth <chandlerc@gmail.com>
98 lines
3.5 KiB
C++
98 lines
3.5 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_SEMANTICS_SEMANTICS_PARSE_TREE_HANDLER_H_
|
|
#define CARBON_TOOLCHAIN_SEMANTICS_SEMANTICS_PARSE_TREE_HANDLER_H_
|
|
|
|
#include "toolchain/parser/parse_tree.h"
|
|
#include "toolchain/semantics/semantics_ir.h"
|
|
#include "toolchain/semantics/semantics_node.h"
|
|
|
|
namespace Carbon {
|
|
|
|
// Handles processing of a ParseTree for semantics.
|
|
class SemanticsParseTreeHandler {
|
|
public:
|
|
// Stores references for work.
|
|
explicit SemanticsParseTreeHandler(const TokenizedBuffer& tokens,
|
|
const ParseTree& parse_tree,
|
|
SemanticsIR& semantics,
|
|
llvm::raw_ostream* vlog_stream)
|
|
: tokens_(&tokens),
|
|
parse_tree_(&parse_tree),
|
|
semantics_(&semantics),
|
|
vlog_stream_(vlog_stream) {}
|
|
|
|
// Outputs the ParseTree information into SemanticsIR.
|
|
auto Build() -> void;
|
|
|
|
private:
|
|
// Prints the node_stack_ on stack dumps.
|
|
class PrettyStackTraceNodeStack;
|
|
// Prints the node_block_stack_ on stack dumps.
|
|
class PrettyStackTraceNodeBlockStack;
|
|
|
|
struct TraversalStackEntry {
|
|
ParseTree::Node parse_node;
|
|
llvm::Optional<SemanticsNodeId> result_id;
|
|
};
|
|
|
|
// Adds an identifier for a DeclaredName node, returning its reference.
|
|
auto AddIdentifier(ParseTree::Node decl_node) -> SemanticsIdentifierId;
|
|
|
|
// Adds a node to the current block, returning the produced ID.
|
|
auto AddNode(SemanticsNode node) -> SemanticsNodeId;
|
|
|
|
// Pushes a parse tree onto the stack. Used when there is no IR generated by
|
|
// the node.
|
|
auto Push(ParseTree::Node parse_node) -> void;
|
|
|
|
// Pushes a parse tree onto the stack, storing the SemanticsNode as the
|
|
// result.
|
|
auto Push(ParseTree::Node parse_node, SemanticsNode node) -> void;
|
|
|
|
// Pops the top of the stack, verifying that it's the expected kind.
|
|
auto Pop(ParseNodeKind pop_parse_kind) -> void;
|
|
|
|
// Pops the top of the stack, returning the result_id. Must only be called for
|
|
// nodes that have results.
|
|
auto PopWithResult() -> SemanticsNodeId;
|
|
|
|
// Pops the top of the stack, verifying that it's the expected kind and
|
|
// returning the result_id. Must only be called for nodes that have results.
|
|
auto PopWithResult(ParseNodeKind pop_parse_kind) -> SemanticsNodeId;
|
|
|
|
// Parse node handlers.
|
|
auto HandleDeclaredName(ParseTree::Node parse_node) -> void;
|
|
auto HandleFunctionDefinition(ParseTree::Node parse_node) -> void;
|
|
auto HandleFunctionDefinitionStart(ParseTree::Node parse_node) -> void;
|
|
auto HandleInfixOperator(ParseTree::Node parse_node) -> void;
|
|
auto HandleLiteral(ParseTree::Node parse_node) -> void;
|
|
auto HandleParameterList(ParseTree::Node parse_node) -> void;
|
|
auto HandleReturnStatement(ParseTree::Node parse_node) -> void;
|
|
|
|
// Tokens for getting data on literals.
|
|
const TokenizedBuffer* tokens_;
|
|
|
|
// The file's parse tree.
|
|
const ParseTree* parse_tree_;
|
|
|
|
// The SemanticsIR being added to.
|
|
SemanticsIR* semantics_;
|
|
|
|
// Whether to print verbose output.
|
|
llvm::raw_ostream* vlog_stream_;
|
|
|
|
// The stack during Build. Will contain file-level parse nodes on return.
|
|
llvm::SmallVector<TraversalStackEntry> node_stack_;
|
|
|
|
// The stack of node blocks during build. Only updated on ParseTree nodes that
|
|
// affect the stack.
|
|
llvm::SmallVector<SemanticsNodeBlockId> node_block_stack_;
|
|
};
|
|
|
|
} // namespace Carbon
|
|
|
|
#endif // CARBON_TOOLCHAIN_SEMANTICS_SEMANTICS_PARSE_TREE_HANDLER_H_
|