表(也称为哈希表或字典)是键/值对的集合。

表由表头和键值对构成

[table]
a = 1
b = 2

等价 JSON 描述:

{
     "table": {
         "a": 1,
         "b": 2
     }
}

注意 TOML 文件本身就是一个匿名表,因此可以直接书写键值对:

a = 1
b = 2

等价 JSON 描述:

{
    "a": 1,
    "b": 2
}

注意:一个表的范围从表头开始到下一个表头或是文件结尾结束

表头是可以嵌套的

[a.b.c]

等价 JSON 描述:

{
    "a": {
        "b": {
            "c": {
                
            }
        }
    }
}

注意:表可以没有键值对,就如同上一个例子所示

键也是可以嵌套的

[a."b.c"]
d.e = 1

等价 JSON 描述:

{
    "a": {
        "b.c": {
            "d": {
                "e": 1
            }
        }
    }
}

顶部匿名表也是一样的:

a.b.c = 1

等价 JSON 描述

{
    "a": {
        "b": {
            "c": 1
        }
    }
}

重复定义是不合法的

# 下面重复定义了 a 表,是不合法的
[a]
b = 1
[a]
c = 1
# 下面重复定义了同一个表的字段(a.b),是不合法的
[a]
b = 1
[a.b]
c = 1