©
Ce document utilise Manuel du site Web PHP chinois Libérer
import "go/parser"
Overview
Index
Examples
Package parser为Go源文件实现解析器。输入可以以各种形式提供(参见各种Parse *函数); 输出是表示Go源的抽象语法树(AST)。解析器是通过一个Parse *函数调用的。
解析器接受比Go规范在语法上允许的语言更大的语言,以简化语法错误,并提高语法错误的健壮性。例如,在方法声明中,接收器被看作是一个普通的参数列表,因此可能包含多个条目,其中规范只允许一个。因此,AST(ast.FuncDecl.Recv)字段中的对应字段不限于一个条目。
func ParseDir(fset *token.FileSet, path string, filter func(os.FileInfo) bool, mode Mode) (pkgs map[string]*ast.Package, first error)
func ParseExpr(x string) (ast.Expr, error)
func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode Mode) (ast.Expr, error)
func ParseFile(fset *token.FileSet, filename string, src interface{}, mode Mode) (f *ast.File, err error)
type Mode
ParseFile
interface.go parser.go
func ParseDir(fset *token.FileSet, path string, filter func(os.FileInfo) bool, mode Mode) (pkgs map[string]*ast.Package, first error)
ParseDir针对path指定的目录中名称以“.go”结尾的所有文件调用ParseFile,并返回包名 - > AST包与所有找到的包。
如果filter!= nil,则只考虑os.FileInfo条目通过过滤器(以“.go”结尾)的文件。模式位不变地传递给ParseFile。位置信息记录在fset中,不能为零。
如果无法读取目录,则返回零映射和相应的错误。如果发生分析错误,则返回一个非零但不完整的映射和遇到的第一个错误。
func ParseExpr(x string) (ast.Expr, error)
ParseExpr是获取表达式x的AST的便捷函数。记录在AST中的位置信息是未定义的。错误消息中使用的文件名是空字符串。
func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode Mode) (ast.Expr, error)
ParseExprFrom是一个用于解析表达式的便捷函数。参数的含义与ParseFile相同,但源必须是有效的Go(类型或值)表达式。具体而言,fset不能为零。
func ParseFile(fset *token.FileSet, filename string, src interface{}, mode Mode) (f *ast.File, err error)
ParseFile解析单个Go源文件的源代码并返回相应的ast.File节点。源代码可以通过源文件的文件名或通过src参数提供。
如果src!= nil,ParseFile解析来自src的源文件并且文件名仅在记录位置信息时使用。src参数的参数类型必须是string,[] byte或io.Reader。如果src == nil,ParseFile解析由filename指定的文件。
mode参数控制解析的源文本的数量和其他可选的解析器功能。位置信息记录在文件集fset中,该文件集不能为零。
如果源无法读取,则返回的AST为零,并且错误指示特定故障。如果源被读取但发现语法错误,则结果是部分AST(ast.Bad *节点代表错误源代码的片段)。多个错误通过一个scanner.ErrorList按文件位置排序返回。
package mainimport ("fmt""go/parser""go/token")func main() { fset := token.NewFileSet() // positions are relative to fset src := `package foo import ( "fmt" "time" ) func bar() { fmt.Println(time.Now()) }`// Parse src but stop after processing the imports. f, err := parser.ParseFile(fset, "", src, parser.ImportsOnly)if err != nil { fmt.Println(err)return}// Print the imports from the file's AST.for _, s := range f.Imports { fmt.Println(s.Path.Value)}}
Mode值是一组标志(或0)。它们控制解析的源代码量和其他可选的解析器功能。
type Mode uint
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 AllErrors = SpuriousErrors // report all errors (not just the first 10 on different lines))