template/parse

1

func IsEmptyTree(n Node) bool

1

func Parse(name, text, leftDelim, rightDelim string, funcs ...map[string]any) (map[string]*Tree, error)

1
2
3
4
5
6
7
8

type ActionNode struct {
	NodeType
	Pos

	Line int       // The line number in the input. Deprecated: Kept for compatibility. 输入中的行号。已弃用：保留兼容性。
	Pipe *PipeNode // The pipeline in the action. 动作中的管道。
	// contains filtered or unexported fields
}

1

func (a *ActionNode) Copy() Node

1

func (a *ActionNode) String() string

1
2
3
4
5
6
7

type BoolNode struct {
	NodeType
	Pos

	True bool // The value of the boolean constant. 布尔常量的值。
	// contains filtered or unexported fields
}

1

func (b *BoolNode) Copy() Node

1

func (b *BoolNode) String() string

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

type BranchNode struct {
	NodeType
	Pos

	Line     int       // The line number in the input. Deprecated: Kept for compatibility. 输入中的行号。已弃用：保留兼容性。
	Pipe     *PipeNode // The pipeline to be evaluated. 要评估的管道。
	List     *ListNode // What to execute if the value is non-empty. 如果值非空，则执行的内容。
	ElseList *ListNode // What to execute if the value is empty (nil if absent). 如果值为空时执行的内容（如果不存在，则为nil）。
	// contains filtered or unexported fields
}

1

func (b *BranchNode) Copy() Node

1

func (b *BranchNode) String() string

1
2
3
4
5
6

type BreakNode struct {
	NodeType
	Pos
	Line int
	// contains filtered or unexported fields
}

1

func (b *BreakNode) Copy() Node

1

func (b *BreakNode) String() string

1
2
3
4
5
6
7
8

type ChainNode struct {
	NodeType
	Pos

	Node  Node
	Field []string // The identifiers in lexical order. 以词法顺序的标识符。
	// contains filtered or unexported fields
}

1

func (c *ChainNode) Add(field string)

1

func (c *ChainNode) Copy() Node

1

func (c *ChainNode) String() string

1
2
3
4
5
6
7

type CommandNode struct {
	NodeType
	Pos

	Args []Node // Arguments in lexical order: Identifier, field, or constant. 参数的词法顺序：标识符、字段或常量。
	// contains filtered or unexported fields
}

1

func (c *CommandNode) Copy() Node

1

func (c *CommandNode) String() string

1
2
3
4
5
6
7

type CommentNode struct {
	NodeType
	Pos

	Text string // Comment text. 注释文本。
	// contains filtered or unexported fields
}

1

func (c *CommentNode) Copy() Node

1

func (c *CommentNode) String() string

1
2
3
4
5
6

type ContinueNode struct {
	NodeType
	Pos
	Line int
	// contains filtered or unexported fields
}

1

func (c *ContinueNode) Copy() Node

1

func (c *ContinueNode) String() string

1
2
3
4
5

type DotNode struct {
	NodeType
	Pos
	// contains filtered or unexported fields
}

1

func (d *DotNode) Copy() Node

1

func (d *DotNode) String() string

1

func (d *DotNode) Type() NodeType

1
2
3
4
5
6
7

type FieldNode struct {
	NodeType
	Pos

	Ident []string // The identifiers in lexical order. 以词法顺序的标识符。
	// contains filtered or unexported fields
}

1

func (f *FieldNode) Copy() Node

1

func (f *FieldNode) String() string

1
2
3
4
5
6
7

type IdentifierNode struct {
	NodeType
	Pos

	Ident string // The identifier's name. 标识符的名称。
	// contains filtered or unexported fields
}

1

func NewIdentifier(ident string) *IdentifierNode

1

func (i *IdentifierNode) Copy() Node

1

func (i *IdentifierNode) SetPos(pos Pos) *IdentifierNode

1

func (i *IdentifierNode) SetTree(t *Tree) *IdentifierNode

1

func (i *IdentifierNode) String() string

1
2
3

type IfNode struct {
	BranchNode
}

1

func (i *IfNode) Copy() Node

1
2
3
4
5
6
7

type ListNode struct {
	NodeType
	Pos

	Nodes []Node // The element nodes in lexical order. 以词法顺序的元素节点。
	// contains filtered or unexported fields
}

1

func (l *ListNode) Copy() Node

1

func (l *ListNode) CopyList() *ListNode

1

func (l *ListNode) String() string

1

type Mode uint

1
2
3
4

const (
	ParseComments Mode = 1 << iota // parse comments and add them to AST 解析注释并将其添加到AST
	SkipFuncCheck                  // do not check that functions are defined 不检查函数是否被定义
)

1
2
3
4
5

type NilNode struct {
	NodeType
	Pos
	// contains filtered or unexported fields
}

1

func (n *NilNode) Copy() Node

1

func (n *NilNode) String() string

1

func (n *NilNode) Type() NodeType

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

type Node interface {
	Type() NodeType
	String() string
	// Copy does a deep copy of the Node and all its components.
	// To avoid type assertions, some XxxNodes also have specialized
	// CopyXxx methods that return *XxxNode.
    // Copy方法对Node及其所有组件进行深拷贝。 为了避免类型断言，某些XxxNodes还具有专门的CopyXxx方法，返回*XxxNode。
	Copy() Node
	Position() Pos // byte position of start of node in full original input string 在完整原始输入字符串中节点起始位置的字节位置
	// contains filtered or unexported methods
}

1

type NodeType int

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

const (
	NodeText    NodeType = iota // Plain text. 纯文本。
	NodeAction                  // A non-control action such as a field evaluation. 非控制操作，如字段评估。
	NodeBool                    // A boolean constant. 布尔常量。
	NodeChain                   // A sequence of field accesses. 字段访问的序列。
	NodeCommand                 // An element of a pipeline. 管道中的元素。
	NodeDot                     // The cursor, dot. 光标，点。

	NodeField      // A field or method name. 字段或方法名。
	NodeIdentifier // An identifier; always a function name. 标识符；始终为函数名。
	NodeIf         // An if action. if操作。
	NodeList       // A list of Nodes. 节点列表。
	NodeNil        // An untyped nil constant. 未类型化的nil常量。
	NodeNumber     // A numerical constant. 数值常量。
	NodePipe       // A pipeline of commands. 命令管道。
	NodeRange      // A range action.  range操作。
	NodeString     // A string constant. 字符串常量。
	NodeTemplate   // A template invocation action. 模板调用操作。
	NodeVariable   // A $ variable. $变量。
	NodeWith       // A with action. with操作。
	NodeComment    // A comment. 注释。
	NodeBreak      // A break action. break操作。
	NodeContinue   // A continue action. continue操作。
)

1

func (t NodeType) Type() NodeType

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

type NumberNode struct {
	NodeType
	Pos
 
	IsInt      bool       // Number has an integral value. 数字具有整数值。
	IsUint     bool       // Number has an unsigned integral value. 数字具有无符号整数值。
	IsFloat    bool       // Number has a floating-point value. 数字具有浮点数值。
	IsComplex  bool       // Number is complex.  数字是复数。
	Int64      int64      // The signed integer value. 有符号整数值。
	Uint64     uint64     // The unsigned integer value. 无符号整数值。
	Float64    float64    // The floating-point value. 浮点数值。
	Complex128 complex128 // The complex value. 复数值。
	Text       string     // The original textual representation from the input. 输入中的原始文本表示。
	// contains filtered or unexported fields
}

1

func (n *NumberNode) Copy() Node

1

func (n *NumberNode) String() string

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

type PipeNode struct {
	NodeType
	Pos

	Line     int             // The line number in the input. Deprecated: Kept for compatibility. 输入中的行号。已弃用：为了兼容性而保留。
	IsAssign bool            // The variables are being assigned, not declared. 变量正在被赋值，而不是声明。
	Decl     []*VariableNode // Variables in lexical order. 按词法顺序的变量。
	Cmds     []*CommandNode  // The commands in lexical order. 按词法顺序的命令。
	// contains filtered or unexported fields
}

1

func (p *PipeNode) Copy() Node

1

func (p *PipeNode) CopyPipe() *PipeNode

1

func (p *PipeNode) String() string

1

type Pos int

1

func (p Pos) Position() Pos

1
2
3

type RangeNode struct {
	BranchNode
}

1

func (r *RangeNode) Copy() Node

1
2
3
4
5
6
7
8

type StringNode struct {
	NodeType
	Pos

	Quoted string // The original text of the string, with quotes. 带引号的字符串的原始文本。
	Text   string // The string, after quote processing. 经过引号处理后的字符串。
	// contains filtered or unexported fields
}

1

func (s *StringNode) Copy() Node

1

func (s *StringNode) String() string

1
2
3
4
5
6
7
8
9

type TemplateNode struct {
	NodeType
	Pos

	Line int       // The line number in the input. Deprecated: Kept for compatibility. 输入中的行号。已弃用：为了兼容性而保留。
	Name string    // The name of the template (unquoted). 模板的名称（未引号化）。
	Pipe *PipeNode // The command to evaluate as dot for the template. 模板的名称（未引号化）。
	// contains filtered or unexported fields
}

1

func (t *TemplateNode) Copy() Node

1

func (t *TemplateNode) String() string

1
2
3
4
5
6
7

type TextNode struct {
	NodeType
	Pos

	Text []byte // The text; may span newlines. 文本；可能跨越多行。
	// contains filtered or unexported fields
}

1

func (t *TextNode) Copy() Node

1

func (t *TextNode) String() string

1
2
3
4
5
6
7

type Tree struct {
	Name      string    // name of the template represented by the tree. 树表示的模板名称。
	ParseName string    // name of the top-level template during parsing, for error messages. 解析过程中顶级模板的名称，用于错误消息。
	Root      *ListNode // top-level root of the tree. 树的顶级根节点。
	Mode      Mode      // parsing mode. 解析模式。
	// contains filtered or unexported fields
}

1

func New(name string, funcs ...map[string]any) *Tree

1

func (t *Tree) Copy() *Tree

1

func (t *Tree) ErrorContext(n Node) (location, context string)

1

func (t *Tree) Parse(text, leftDelim, rightDelim string, treeSet map[string]*Tree, funcs ...map[string]any) (tree *Tree, err error)

1
2
3
4
5
6
7

type VariableNode struct {
	NodeType
	Pos

	Ident []string // Variable name and fields in lexical order. 按词法顺序的变量名和字段。
	// contains filtered or unexported fields
}

1

func (v *VariableNode) Copy() Node

1

func (v *VariableNode) String() string

1
2
3

type WithNode struct {
	BranchNode
}

1

func (w *WithNode) Copy() Node