len()

len() 関数は文字列、配列、リスト、マップ、バイナリの長さまたは要素数を返します。

構文

パラメーター

VALUE

長さを求める値です。文字列、配列、リスト、マップ、バイナリ（byte[]）型をサポートします。

説明

len() 関数は VALUE の型に応じて以下のように動作します。

• 文字列: 文字数を返します。
• 配列またはリスト: 要素の数を返します。
• マップ（オブジェクト）: キーと値のペアの数を返します。
• バイナリ（byte[]）: バイト数を返します。
• その他の型: toString() で変換した後に文字数を返します。

VALUE が null の場合は 0 を返します。返り値の型は 32 ビット整数です。

エラーコード

該当なし

使用例

これらの使用例で参照する WEB_APACHE_SAMPLE テーブルを準備するには、クエリ実習用データを参照してください。

1. URI 文字列の長さを返す

   table limit=5 WEB_APACHE_SAMPLE | eval result = len(uri) | fields uri, result
   

2. User-Agent 文字列の長さを返す

   table limit=5 WEB_APACHE_SAMPLE | eval result = len(agent) | fields agent, result
   

3. null 入力

   json "{'val': null}" | eval result = len(val)
   | # result: 0
   

4. 配列の要素数を返す

   json "{'val': [1, 2, 3]}" | eval result = len(val)
   | # result: 3
   

互換性

len() 関数は Sonar 4.0 以前のバージョンから提供されています。