Files
carbon-lang/common/vlog_internal.h
T
Jon Ross-PerkinsandChandler Carruth 352fec1885 Add some coarse debug information to semantics. (#2382)
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>
2022-11-11 14:10:13 -08:00

57 lines
1.6 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_COMMON_VLOG_INTERNAL_H_
#define CARBON_COMMON_VLOG_INTERNAL_H_
#include <cstdlib>
#include "llvm/Support/raw_ostream.h"
namespace Carbon::Internal {
// Wraps a stream and exiting for fatal errors. Should only be used by check.h
// macros.
class VLoggingStream {
public:
// Internal type used in macros to dispatch to the `operator|` overload.
struct Helper {};
VLoggingStream(llvm::raw_ostream* stream)
// Prefix the buffer with the current bug report message.
: stream_(stream) {}
~VLoggingStream() = default;
// If the bool cast occurs, it's because the condition is false. This supports
// && short-circuiting the creation of ExitingStream.
explicit operator bool() const { return true; }
// Forward output to llvm::errs.
template <typename T>
auto operator<<(const T& message) -> VLoggingStream& {
*stream_ << message;
return *this;
}
// Low-precedence binary operator overload used in vlog.h macros.
friend auto operator|(Helper /*helper*/, VLoggingStream& /*stream*/) -> void {
}
private:
[[noreturn]] auto Done() -> void;
llvm::raw_ostream* stream_;
};
} // namespace Carbon::Internal
// Raw logging stream. This should be used when building forms of vlog
// macros.
#define CARBON_VLOG_INTERNAL_STREAM(stream) \
Carbon::Internal::VLoggingStream::Helper() | \
Carbon::Internal::VLoggingStream(stream)
#endif // CARBON_COMMON_VLOG_INTERNAL_H_