parser

Documentation

Overview

Package parser implements a parser for Go source files. Input may be provided in a variety of forms (see the various Parse* functions); the output is an abstract syntax tree (AST) representing the Go source. The parser is invoked through one of the Parse* functions.

The parser accepts a larger language than is syntactically permitted by the Go spec, for simplicity, and for improved robustness in the presence of syntax errors. For instance, in method declarations, the receiver is treated like an ordinary parameter list and thus may contain multiple entries where the spec permits exactly one. Consequently, the corresponding field in the AST (ast.FuncDecl.Recv) field is not restricted to one entry.

Package parser implements a parser for Go source files. Input may be provided in a variety of forms (see the various Parse* functions); the output is an abstract syntax tree (AST) representing the Go source. The parser is invoked through one of the Parse* functions.

The parser accepts a larger language than is syntactically permitted by the Go spec, for simplicity, and for improved robustness in the presence of syntax errors. For instance, in method declarations, the receiver is treated like an ordinary parameter list and thus may contain multiple entries where the spec permits exactly one. Consequently, the corresponding field in the AST (ast.FuncDecl.Recv) field is not restricted to one entry.

Package parser implements a parser for Go source files. Input may be provided in a variety of forms (see the various Parse* functions); the output is an abstract syntax tree (AST) representing the Go source. The parser is invoked through one of the Parse* functions.

The parser accepts a larger language than is syntactically permitted by the Go spec, for simplicity, and for improved robustness in the presence of syntax errors. For instance, in method declarations, the receiver is treated like an ordinary parameter list and thus may contain multiple entries where the spec permits exactly one. Consequently, the corresponding field in the AST (ast.FuncDecl.Recv) field is not restricted to one entry.

Index

• func GENERICS_V1_CXX() bool
• func GENERICS_V2_CTI() bool
• func MakeQuote(p_or_nil *parser, op token.Token, pos token.Pos, node ast.Node) (*ast.UnaryExpr, *ast.BlockStmt)
• type Mode
• type Parser
  • func (p *Parser) Configure(mode Mode, macroChar rune)
  • func (p *Parser) Init(fileset *etoken.FileSet, filename string, lineOffset int, src []byte)
  • func (p *Parser) Parse() (list []ast.Node, err error)

Functions

func GENERICS_V1_CXX

func GENERICS_V1_CXX() bool

enable C++-style generics?

func GENERICS_V2_CTI

func GENERICS_V2_CTI() bool

enable generics "contracts are interfaces" ?

func MakeQuote

func MakeQuote(p_or_nil *parser, op token.Token, pos token.Pos, node ast.Node) (*ast.UnaryExpr, *ast.BlockStmt)

MakeQuote creates an ast.UnaryExpr representing op{node}: usually one of quote{node}, quasiquote{node}, unquote{node} or unquote_splice{node}. Returns both the unaryexpr and the blockstmt containing its body

Types

type Mode

type Mode uint

A Mode value is a set of flags (or 0). They control the amount of source code parsed and other optional parser functionality.

const (
	PackageClauseOnly Mode             = 1 << iota // stop parsing after package clause
	ImportsOnly                                    // stop parsing after import declarations
	ParseComments                                  // parse comments and add them to AST
	Trace                                          // print a trace of parsed productions
	DeclarationErrors                              // report declaration errors
	SpuriousErrors                                 // same as AllErrors, for backward-compatibility
	CopySources                                    // copy source code to FileSet
	AllErrors         = SpuriousErrors             // report all errors (not just the first 10 on different lines)

)

type Parser

type Parser struct {
	// contains filtered or unexported fields
}

func (*Parser) Configure

func (p *Parser) Configure(mode Mode, macroChar rune)

func (*Parser) Init

func (p *Parser) Init(fileset *etoken.FileSet, filename string, lineOffset int, src []byte)

func (*Parser) Parse

func (p *Parser) Parse() (list []ast.Node, err error)