annuaire recherche
archive archive/tar archive/zip bufio bufio(缓存) builtin builtin(内置包) bytes bytes(包字节) compress compress/bzip2(压缩/bzip2) compress/flate(压缩/flate) compress/gzip(压缩/gzip) compress/lzw(压缩/lzw) compress/zlib(压缩/zlib) container container/heap(容器数据结构heap) container/list(容器数据结构list) container/ring(容器数据结构ring) context context(上下文) crypto crypto(加密) crypto/aes(加密/aes) crypto/cipher(加密/cipher) crypto/des(加密/des) crypto/dsa(加密/dsa) crypto/ecdsa(加密/ecdsa) crypto/elliptic(加密/elliptic) crypto/hmac(加密/hmac) crypto/md5(加密/md5) crypto/rand(加密/rand) crypto/rc4(加密/rc4) crypto/rsa(加密/rsa) crypto/sha1(加密/sha1) crypto/sha256(加密/sha256) crypto/sha512(加密/sha512) crypto/subtle(加密/subtle) crypto/tls(加密/tls) crypto/x509(加密/x509) crypto/x509/pkix(加密/x509/pkix) database database/sql(数据库/sql) database/sql/driver(数据库/sql/driver) debug debug/dwarf(调试/dwarf) debug/elf(调试/elf) debug/gosym(调试/gosym) debug/macho(调试/macho) debug/pe(调试/pe) debug/plan9obj(调试/plan9obj) encoding encoding(编码) encoding/ascii85(编码/ascii85) encoding/asn1(编码/asn1) encoding/base32(编码/base32) encoding/base64(编码/base64) encoding/binary(编码/binary) encoding/csv(编码/csv) encoding/gob(编码/gob) encoding/hex(编码/hex) encoding/json(编码/json) encoding/pem(编码/pem) encoding/xml(编码/xml) errors errors(错误) expvar expvar flag flag(命令行参数解析flag包) fmt fmt go go/ast(抽象语法树) go/build go/constant(常量) go/doc(文档) go/format(格式) go/importer go/parser go/printer go/scanner(扫描仪) go/token(令牌) go/types(类型) hash hash(散列) hash/adler32 hash/crc32 hash/crc64 hash/fnv html html html/template(模板) image image(图像) image/color(颜色) image/color/palette(调色板) image/draw(绘图) image/gif image/jpeg image/png index index/suffixarray io io io/ioutil log log log/syslog(日志系统) math math math/big math/big math/bits math/bits math/cmplx math/cmplx math/rand math/rand mime mime mime/multipart(多部分) mime/quotedprintable net net net/http net/http net/http/cgi net/http/cookiejar net/http/fcgi net/http/httptest net/http/httptrace net/http/httputil net/http/internal net/http/pprof net/mail net/mail net/rpc net/rpc net/rpc/jsonrpc net/smtp net/smtp net/textproto net/textproto net/url net/url os os os/exec os/signal os/user path path path/filepath(文件路径) plugin plugin(插件) reflect reflect(反射) regexp regexp(正则表达式) regexp/syntax runtime runtime(运行时) runtime/debug(调试) runtime/internal/sys runtime/pprof runtime/race(竞争) runtime/trace(执行追踪器) sort sort(排序算法) strconv strconv(转换) strings strings(字符串) sync sync(同步) sync/atomic(原子操作) syscall syscall(系统调用) testing testing(测试) testing/iotest testing/quick text text/scanner(扫描文本) text/tabwriter text/template(定义模板) text/template/parse time time(时间戳) unicode unicode unicode/utf16 unicode/utf8 unsafe unsafe
personnages

  • 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

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

func ParseExpr(x string) (ast.Expr, error)

ParseExpr是获取表达式x的AST的便捷函数。记录在AST中的位置信息是未定义的。错误消息中使用的文件名是空字符串。

func ParseExprFrom

func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode Mode) (ast.Expr, error)

ParseExprFrom是一个用于解析表达式的便捷函数。参数的含义与ParseFile相同,但源必须是有效的Go(类型或值)表达式。具体而言,fset不能为零。

func ParseFile

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)}}

type Mode

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))
Article précédent: Article suivant: