メインコンテンツにスキップ

length 関数

length は、指定されたリスト、マップ、または文字列の長さを決定します。

リストまたはマップが指定された場合、結果はコレクション内の要素の数です。文字列が指定された場合、結果は文字列内の文字数です。

コードブロック
> length([])
0
> length(["a", "b"])
2
> length({"a" = "b"})
1
> length("hello")
5

文字列が指定された場合、結果はバイト数やUnicodeシーケンスの数ではなく、文字数です。

コードブロック
> length("👾🕹️")
2

「文字」とは、Unicode標準付属書#29で定義されている*書記素クラスタ*です。リモートAPIは、文字列引数の長さ制限のために「文字」を異なる定義をしている場合があります。 OpenTofuプロバイダーは、OpenTofuの文字列表現をそれぞれの対応するリモートシステムで使用される表現に変換し、追加の検証ルールを適用する必要があります。