?
This document uses PHP Chinese website manual Release
import "go/parser"
Overview
Index
Examples
概觀
Package parser為Go源文件實(shí)現(xiàn)解析器。輸入可以以各種形式提供（參見(jiàn)各種Parse *函數(shù)）; 輸出是表示Go源的抽象語(yǔ)法樹（AST）。解析器是通過(guò)一個(gè)Parse *函數(shù)調(diào)用的。
解析器接受比Go規(guī)范在語(yǔ)法上允許的語(yǔ)言更大的語(yǔ)言，以簡(jiǎn)化語(yǔ)法錯(cuò)誤，并提高語(yǔ)法錯(cuò)誤的健壯性。例如，在方法聲明中，接收器被看作是一個(gè)普通的參數(shù)列表，因此可能包含多個(gè)條目，其中規(guī)范只允許一個(gè)。因此，AST（ast.FuncDecl.Recv）字段中的對(duì)應(yīng)字段不限于一個(gè)條目。
索引
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
func ParseDir(fset *token.FileSet, path string, filter func(os.FileInfo) bool, mode Mode) (pkgs map[string]*ast.Package, first error)
ParseDir針對(duì)path指定的目錄中名稱以“.go”結(jié)尾的所有文件調(diào)用ParseFile，并返回包名 - > AST包與所有找到的包。
如果filter！= nil，則只考慮os.FileInfo條目通過(guò)過(guò)濾器（以“.go”結(jié)尾）的文件。模式位不變地傳遞給ParseFile。位置信息記錄在fset中，不能為零。
如果無(wú)法讀取目錄，則返回零映射和相應(yīng)的錯(cuò)誤。如果發(fā)生分析錯(cuò)誤，則返回一個(gè)非零但不完整的映射和遇到的第一個(gè)錯(cuò)誤。
func ParseExpr
func ParseExpr(x string) (ast.Expr, error)
ParseExpr是獲取表達(dá)式x的AST的便捷函數(shù)。記錄在AST中的位置信息是未定義的。錯(cuò)誤消息中使用的文件名是空字符串。
func ParseExprFrom
func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode Mode) (ast.Expr, error)ParseExprFrom是一個(gè)用于解析表達(dá)式的便捷函數(shù)。參數(shù)的含義與ParseFile相同，但源必須是有效的Go（類型或值）表達(dá)式。具體而言，fset不能為零。
func ParseFile
func ParseFile(fset *token.FileSet, filename string, src interface{}, mode Mode) (f *ast.File, err error)ParseFile解析單個(gè)Go源文件的源代碼并返回相應(yīng)的ast.File節(jié)點(diǎn)。源代碼可以通過(guò)源文件的文件名或通過(guò)src參數(shù)提供。
如果src！= nil，ParseFile解析來(lái)自src的源文件并且文件名僅在記錄位置信息時(shí)使用。src參數(shù)的參數(shù)類型必須是string，[] byte或io.Reader。如果src == nil，ParseFile解析由filename指定的文件。
mode參數(shù)控制解析的源文本的數(shù)量和其他可選的解析器功能。位置信息記錄在文件集fset中，該文件集不能為零。
如果源無(wú)法讀取，則返回的AST為零，并且錯(cuò)誤指示特定故障。如果源被讀取但發(fā)現(xiàn)語(yǔ)法錯(cuò)誤，則結(jié)果是部分AST（ast.Bad *節(jié)點(diǎn)代表錯(cuò)誤源代碼的片段）。多個(gè)錯(cuò)誤通過(guò)一個(gè)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)}}type Mode
Mode值是一組標(biāo)志（或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))