基础函数
变量可以使用符号 |
在函数间传递
{{.value | Func1 | Func2}}
...
{{printf "nums is %s %d" (printf "%d %d" 1 2) 3}}
and
{{and .X .Y .Z}}
and
会逐一判断每个参数,将返回第一个为空的参数,否则就返回最后一个非空参数
call
{{call .Field.Func .Arg1 .Arg2}}
...
调用的函数需要返回 1 个值 或者 2 个值,返回两个值时,第二个值用于返回error
类型的错误。返回的错误不等于nil
时,执行将终止。
index
index
支持map
, slice
, array
, string
,读取指定类型对应下标的值。
{{index .Maps "name"}}
len
{{printf "The content length is %d" (.Content|len)}}
返回对应类型的长度,支持类型:map
, slice
, array
, string
, chan
。
not
not
返回输入参数的否定值。
例如,判断是否变量是否为空:
{{if not .Var}}
// 执行为空操作(.Var为空, 如: nil, 0, "", 长度为0的slice/map)
{{else}}
// 执行非空操作(.Var不为空)
{{end}}
or
{{or .X .Y .Z}}
or
会逐一判断每个参数,将返回第一个非空的参数,否则就返回最后一个参数。
同fmt.Sprint
。
printf
同fmt.Sprintf
。
println
同fmt.Sprintln
。
urlquery
{{urlquery "http://johng.cn"}}
将返回
http%3A%2F%2Fjohng.cn
eq / ne / lt / le / gt / ge
这类函数一般配合在if
中使用
`eq`: arg1 == arg2
`ne`: arg1 != arg2
`lt`: arg1 < arg2
`le`: arg1 <= arg2
`gt`: arg1 > arg2
`ge`: arg1 >= arg2
...
{{if .Var}}
// 执行非空操作(.Var不为空)
{{else}}
// 执行为空操作(.Var为空, 如: nil, 0, "", 长度为0的slice/map)
{{end}}
对比函数改进
GF
框架模板引擎对标准库自带的对比模板函数eq/ne/lt/le/gt/ge
做了必要的改进,以便支持任意数据类型的比较。例如,在标准库模板中的以下比较:
...
在GF
框架的模板引擎中,将会自动将两个参数进行数据转换,转换为同一类型后再进行比较,这样的开发体验更好、灵活性更高。如果两个参数均为整型变量(或者整型字符串),那么将会转换为整型进行比较,否则转换为字符串变量进行比较(区分大小写)。
改进运行示例
我们来看一个GF
框架的模板引擎中的对比模板函数运行示例。
...