跳至主要内容

length 函数

length 用于确定给定列表、映射或字符串的长度。

如果给定一个列表或映射,结果是该集合中的元素数量。如果给定一个字符串,结果是字符串中的字符数量。

示例

代码块
> length([])
0
> length(["a", "b"])
2
> length({"a" = "b"})
1
> length("hello")
5

当给定一个字符串时,结果是字符的数量,而不是形成它们的字节或 Unicode 序列的数量

代码块
> length("👾🕹️")
2

“字符”是指根据 Unicode 标准附件 #29 定义的 *音位群*。请注意,远程 API 可能会为字符串参数的长度限制目的而对“字符”有不同的定义;OpenTofu 提供程序负责将 OpenTofu 的字符串表示形式转换为其各自的远程系统使用的字符串表示形式,并对其应用任何其他验证规则。