convert

package
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 25, 2025 License: Apache-2.0 Imports: 23 Imported by: 0

Documentation

Overview

This file is used to convert ast from "github.com/goplus/llcppg/ast" to "go/ast"

This file is used to convert type from ast type to types.Type

Index

Constants

View Source 
const (
	TYPEC = "// llgo:type C"
)

Variables

View Source 
var (
	ErrTypeConv = errors.New("error convert type")
)

Functions

func IsDepStd 

func IsDepStd(pkgPath string) (string, bool)

func ModInit added in v0.2.0 

func ModInit(deps []string, outputDir string, modulePath string) error

if modulePath is not empty, init the module by modulePath

func NewFuncDocComments 

func NewFuncDocComments(funcName string, goFuncName string) *goast.CommentGroup

func NewTypecDocComments 

func NewTypecDocComments() *goast.CommentGroup

Types

type BuiltinTypeMap 

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

func NewBuiltinTypeMap 

func NewBuiltinTypeMap(pkgPath, name string, conf *gogen.Config) *BuiltinTypeMap

func NewBuiltinTypeMapWithPkgRefS 

func NewBuiltinTypeMapWithPkgRefS(pkgs ...gogen.PkgRef) *BuiltinTypeMap

func (*BuiltinTypeMap) CType 

func (p *BuiltinTypeMap) CType(typ string) types.Type

func (*BuiltinTypeMap) FindBuiltinType 

func (p *BuiltinTypeMap) FindBuiltinType(builtinType ast.BuiltinType) (types.Type, error)

func (*BuiltinTypeMap) IsVoidType 

func (p *BuiltinTypeMap) IsVoidType(typ types.Type) bool

type Config 

type Config struct {
	PkgName   string
	SymbFile  string // llcppg.symb.json
	CfgFile   string // llcppg.cfg
	PubFile   string // llcppg.pub
	OutputDir string

	Pkg *llcppg.Pkg
}

type ConstGroup 

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

func NewConstGroup 

func NewConstGroup(pkg *gogen.Package, scope *types.Scope) *ConstGroup

func (*ConstGroup) New 

func (p *ConstGroup) New(val any, typ types.Type, name string)

type ConvertComment 

type ConvertComment struct {
	*goast.Comment
}

func Comment 

func Comment(doc *ast.Comment) *ConvertComment

type ConvertCommentGroup 

type ConvertCommentGroup struct {
	*goast.CommentGroup
}

func CommentGroup 

func CommentGroup(doc *ast.CommentGroup) *ConvertCommentGroup

func (*ConvertCommentGroup) AddComment 

func (p *ConvertCommentGroup) AddComment(comment *goast.Comment) error

func (*ConvertCommentGroup) AddCommentGroup 

func (p *ConvertCommentGroup) AddCommentGroup(doc *goast.CommentGroup)

type Converter 

type Converter struct {
	Pkg    *llcppg.Pkg
	GenPkg *Package
	Conf   *Config
}

func NewConverter 

func NewConverter(config *Config) (*Converter, error)

func (*Converter) Convert 

func (p *Converter) Convert()

func (*Converter) Fmt 

func (p *Converter) Fmt()

func (*Converter) Process 

func (p *Converter) Process()

func (*Converter) Tidy added in v0.2.0 

func (p *Converter) Tidy()

func (*Converter) Write 

func (p *Converter) Write()

type ExprWrap 

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

func Expr 

func Expr(e ast.Expr) *ExprWrap

func (*ExprWrap) IsVoid 

func (p *ExprWrap) IsVoid() bool

func (*ExprWrap) ToChar 

func (p *ExprWrap) ToChar() (int8, error)

func (*ExprWrap) ToFloat 

func (p *ExprWrap) ToFloat(bitSize int) (float64, error)

func (*ExprWrap) ToInt 

func (p *ExprWrap) ToInt() (int, error)

func (*ExprWrap) ToString 

func (p *ExprWrap) ToString() (string, error)

type GoFuncSpec 

type GoFuncSpec struct {
	GoSymbName string // original full name from input
	FnName     string // function name without receiver
	IsMethod   bool   // if the function is a method
	RecvName   string // receiver name
	PtrRecv    bool   // if the receiver is a pointer
}

GoFuncSpec parses and stores components of a Go function name Input examples from llcppg.symb.json's "go" field: 1. Simple function: "AddPatchToArray" 2. Method with pointer receiver: "(*Sqlite3Stmt).Sqlite3BindParameterIndex" 3. Method with value receiver: "CJSONBool.CJSONCreateBool"

func NewGoFuncSpec 

func NewGoFuncSpec(name string) *GoFuncSpec

- "AddPatchToArray" -> {goSymbolName: "AddPatchToArray", funcName: "AddPatchToArray"} - "(*Sqlite3Stmt).Sqlite3BindParameterIndex" -> {goSymbolName: "...", recvName: "Sqlite3Stmt", funcName: "Sqlite3BindParameterIndex", ptrRecv: true} - "CJSONBool.CJSONCreateBool" -> {goSymbolName: "...", recvName: "CJSONBool", funcName: "CJSONCreateBool", ptrRecv: false}

func (*GoFuncSpec) IsIgnore added in v0.2.1 

func (g *GoFuncSpec) IsIgnore() bool

type HeaderFile 

type HeaderFile struct {
	File     string
	FileType llcppg.FileType
}

func NewHeaderFile 

func NewHeaderFile(file string, fileType llcppg.FileType) *HeaderFile

func (*HeaderFile) InCurPkg 

func (p *HeaderFile) InCurPkg() bool

func (*HeaderFile) ToGoFileName 

func (p *HeaderFile) ToGoFileName(pkgName string) string

Note:third hfile should not set to gogen.Package

type Incomplete 

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

type IncompleteTypes 

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

func NewIncompleteTypes 

func NewIncompleteTypes() *IncompleteTypes

func (*IncompleteTypes) Add 

func (it *IncompleteTypes) Add(inc *Incomplete)

func (*IncompleteTypes) Clear 

func (it *IncompleteTypes) Clear()

func (*IncompleteTypes) Complete 

func (it *IncompleteTypes) Complete(cname string)

func (*IncompleteTypes) IterateIncomplete 

func (it *IncompleteTypes) IterateIncomplete(fn func(*Incomplete) error) error

func (*IncompleteTypes) Lookup 

func (it *IncompleteTypes) Lookup(cname string) (*Incomplete, bool)

type Module 

type Module = gopmod.Module

type Package 

type Package struct {
	*PkgInfo
	// contains filtered or unexported fields
}

In Processing Package

func NewPackage 

func NewPackage(config *PackageConfig) *Package

When creating a new package for conversion, a Go file named after the package is generated by default. If SetCurFile is not called, all type conversions will be written to this default Go file.

func (*Package) CollectNameMapping 

func (p *Package) CollectNameMapping(originName, newName string)

Collect the name mapping between origin name and pubname if in current package, it will be collected in public symbol table

func (*Package) DeclName 

func (p *Package) DeclName(name string, toCamel bool) (pubName string, changed bool, err error)

For a decl name, it should be unique

func (*Package) GetGenPackage 

func (p *Package) GetGenPackage() *gogen.Package

func (*Package) GetOutputDir 

func (p *Package) GetOutputDir() string

func (*Package) LookupSymbol 

func (p *Package) LookupSymbol(mangleName config.MangleNameType) (*GoFuncSpec, error)

func (*Package) NewConstGroup 

func (p *Package) NewConstGroup() *ConstGroup

func (*Package) NewEnumTypeDecl 

func (p *Package) NewEnumTypeDecl(enumTypeDecl *ast.EnumTypeDecl) error

func (*Package) NewFuncDecl 

func (p *Package) NewFuncDecl(funcDecl *ast.FuncDecl) error

func (*Package) NewMacro 

func (p *Package) NewMacro(macro *ast.Macro) error

func (*Package) NewTypeDecl 

func (p *Package) NewTypeDecl(typeDecl *ast.TypeDecl) error

NewTypeDecl converts C/C++ type declarations to Go. Besides regular type declarations, it also supports: - Forward declarations: Pre-registers incomplete types for later definition - Self-referential types: Handles types that reference themselves (like linked lists)

func (*Package) NewTypedefDecl 

func (p *Package) NewTypedefDecl(typedefDecl *ast.TypedefDecl) error

func (*Package) NewTypedefs 

func (p *Package) NewTypedefs(name string, typ types.Type) *gogen.TypeDecl

func (*Package) SetCurFile 

func (p *Package) SetCurFile(hfile *HeaderFile)

func (*Package) ToSigSignature 

func (p *Package) ToSigSignature(recv *types.Var, funcDecl *ast.FuncDecl) (*types.Signature, error)

func (*Package) ToType 

func (p *Package) ToType(expr ast.Expr) (types.Type, error)

Convert ast.Expr to types.Type

func (*Package) Write 

func (p *Package) Write(headerFile string) error

Write generates a Go file based on the package content. The output file will be generated in a subdirectory named after the package within the outputDir. If outputDir is not provided, the current directory will be used. The header file name is the go file name.

Files that are already processed in dependent packages will not be output.

func (*Package) WriteAutogenFile 

func (p *Package) WriteAutogenFile() error

func (*Package) WriteLinkFile 

func (p *Package) WriteLinkFile() (string, error)

func (*Package) WritePkgFiles 

func (p *Package) WritePkgFiles() error

WritePkgFiles writes all converted header files to Go files. Calls deferTypeBuild() first to complete all incomplete type definitions, because some types may be implemented across multiple files.

func (*Package) WritePubFile 

func (p *Package) WritePubFile() error

func (*Package) WriteToBuffer 

func (p *Package) WriteToBuffer(genFName string) (*bytes.Buffer, error)

Write the corresponding files in gogen package to the buffer

type PackageConfig 

type PackageConfig struct {
	PkgBase
	Name        string // current package name
	OutputDir   string
	SymbolTable *config.SymbolTable
	GenConf     *gogen.Config
}

type PkgBase 

type PkgBase struct {
	PkgPath  string            // package path, e.g. github.com/goplus/llgo/cjson
	CppgConf *llcppg.Config    // llcppg.cfg
	Pubs     map[string]string // llcppg.pub
}

type PkgDepLoader 

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

func NewPkgDepLoader 

func NewPkgDepLoader(mod *gopmod.Module, pkg *gogen.Package) *PkgDepLoader

func (*PkgDepLoader) Import 

func (pm *PkgDepLoader) Import(pkgPath string) (*PkgInfo, error)

func (*PkgDepLoader) Imports 

func (pm *PkgDepLoader) Imports(pkgPaths []string) (pkgs []*PkgInfo, err error)

func (*PkgDepLoader) InitDeps 

func (pm *PkgDepLoader) InitDeps(p *PkgInfo) error

func (*PkgDepLoader) LoadDeps 

func (pm *PkgDepLoader) LoadDeps(p *PkgInfo) ([]*PkgInfo, error)

LoadDeps loads direct dependencies of the current package and recursively loads their dependencies, to get the complete dependency.

func (*PkgDepLoader) RegisterDep 

func (pm *PkgDepLoader) RegisterDep(dep *PkgInfo)

func (*PkgDepLoader) RegisterDeps 

func (pm *PkgDepLoader) RegisterDeps(p *PkgInfo)

RegisterDeps registers types from dependent packages into the current conversion project's scope

type PkgInfo 

type PkgInfo struct {
	PkgBase
	Deps []*PkgInfo
	Dir  string // absolute local path of the package
}

for current package & dependent packages

func NewPkgInfo 

func NewPkgInfo(pkgPath string, pkgDir string, conf *llcppg.Config, pubs map[string]string) *PkgInfo

type ThirdTypeLoc 

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

func NewThirdTypeLoc 

func NewThirdTypeLoc() *ThirdTypeLoc

func (*ThirdTypeLoc) Add 

func (p *ThirdTypeLoc) Add(ident *ast.Ident, loc *ast.Location)

func (*ThirdTypeLoc) Lookup 

func (p *ThirdTypeLoc) Lookup(name string) (string, bool)

type TypeContext 

type TypeContext int
const (
	Normal TypeContext = iota
	Param              // In function parameter context
	Record             // In record field context
)

type TypeConv 

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

func NewConv 

func NewConv(p *Package) *TypeConv

func (*TypeConv) RecordTypeToStruct 

func (p *TypeConv) RecordTypeToStruct(recordType *ast.RecordType) (types.Type, error)

func (*TypeConv) ToDefaultEnumType 

func (p *TypeConv) ToDefaultEnumType() types.Type

func (*TypeConv) ToSignature 

func (p *TypeConv) ToSignature(funcType *ast.FuncType, recv *types.Var) (*types.Signature, error)

func (*TypeConv) ToType 

func (p *TypeConv) ToType(expr ast.Expr) (types.Type, error)

Convert ast.Expr to types.Type

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.