基础函数

    使用括号

    1. {{printf "nums is %s %d" (printf "%d %d" 1 2) 3}}
    1. {{and .X .Y .Z}}

    and会逐一判断每个参数,将返回第一个为空的参数,否则就返回最后一个非空参数

    call

    1. {{call .Field.Func .Arg1 .Arg2}}

    call可以调用函数,并传入参数

    调用的函数需要返回 1 个值 或者 2 个值,返回两个值时,第二个值用于返回error类型的错误。返回的错误不等于nil时,执行将终止。

    index

    index支持map, slice, array, string,读取指定类型对应下标的值。

    1. {{index .Maps "name"}}
    1. {{printf "The content length is %d" (.Content|len)}}

    返回对应类型的长度,支持类型:map, slice, array, string, chan

    not

    not返回输入参数的否定值。

    or

    1. {{or .X .Y .Z}}

    or会逐一判断每个参数,将返回第一个非空的参数,否则就返回最后一个参数。

    fmt.Sprint

    printf

    fmt.Sprintf

    println

    fmt.Sprintln

    1. {{urlquery "http://johng.cn"}}

    将返回

    eq / ne / lt / le / gt / ge

    这类函数一般配合在if中使用

    1. `ne`: arg1 != arg2
    2. `lt`: arg1 < arg2
    3. `le`: arg1 <= arg2
    4. `gt`: arg1 > arg2
    5. `ge`: arg1 >= arg2

    eq和其他函数不一样的地方是,支持多个参数。

    1. {{eq arg1 arg2 arg3 arg4}}

    if一起使用

    1. {{if eq true .Var1 .Var2 .Var3}}...{{end}}
    1. {{if lt 100 200}}...{{end}}

    例如,判断变量不为空时执行:

    1. {{if .Var}}
    2. // 执行非空操作(.Var不为空)
    3. {{else}}
    4. // 执行为空操作(.Var为空, 如: nil, 0, "", 长度为0的slice/map)
    5. {{end}}

    GF框架模板引擎对标准库自带的对比模板函数eq/ne/lt/le/gt/ge做了必要的改进,以便支持任意数据类型的比较。例如,在标准库模板中的以下比较:

    1. {{eq 1 "1"}}

    将会引发错误:

    1. panic: template: at <eq 1 "1">: error calling eq: incompatible types for comparison

    由于比较的两个参数不是同一数据类型,因此引发了panic错误。

    GF框架的模板引擎中,将会自动将两个参数进行数据转换,转换为同一类型后再进行比较,这样的开发体验更好、灵活性更高。如果两个参数均为整型变量(或者整型字符串),那么将会转换为整型进行比较,否则转换为字符串变量进行比较(区分大小写)。

    改进运行示例

    我们来看一个GF框架的模板引擎中的对比模板函数运行示例。

    1. eq:
    2. eq "a" "a": true
    3. eq 1 "1": true
    4. ne:
    5. ne "a" "a": false
    6. ne "a" "b": true
    7. lt:
    8. lt 1 "2": true
    9. lt 2 2 : false
    10. lt "a" "b": true
    11. le:
    12. le 1 "2": true
    13. le 2 1 : false
    14. le "a" "a": true
    15. gt:
    16. gt 1 "2": false
    17. gt 2 1 : true
    18. gt "a" "a": false
    19. ge:
    20. ge 1 "2": false
    21. ge 2 1 : true