JPath 式の関数

照会の一部として関数を使用するなど、いくつかの基本的な関数を JPath 式で使用できます。

以下の表では、JPath 式で使用できる基本的な関数を示しています。
表 1. 関数
関数 説明
カウント (パス) 特定のパス式の項目の数を返します。
  • オブジェクトの場合は、メンバーの数を返します。
  • 配列の場合は、配列エレメントの数を返します。
  • ストリングの場合は、ストリングの長さを返します。
base64_encode(expr) 特定の式の Base64 エンコード値を返します。
base64_decode(expr) 特定の式の Base64 デコード値を返します。
url_encode (式) 特定の式の URL エンコード値を返します。
url_decode (式) 特定の式の URL デコード値を返します。
最小 (パス) 特定のパス式における配列の最小値を返します。
最大 (パス) 特定のパス式における配列の最大値を返します。
time() エポック以降の時間 (ミリ秒) を返します。
V2 の新機能 Trunc (式) 特定の数値式の切り捨てられた値を返します。
V2 の新機能 ラウンド (expr) 特定の数値式の値を丸めたものを返します。
V2 の新機能 フロア (式) 特定の数値式の値を切り捨てたものを返します。
V2 の新機能 セイル (式) 特定の数値式の値を切り上げたものを返します。
V2 の新機能 ランダム番号 () 0.0 から 1.0 までの浮動小数点乱数を返します。
V2 の新機能 サブストリング (expr、begin、end) 特定の式のサブストリングを返します。
V2 の新機能 左 (式、長さ) 特定の式の左部分を返します。
V2 の新機能 右 (式、長さ) 特定の式の右部分を返します。
V2 の新機能 上限 (式) 特定の式の値を大文字にしたものを返します。
V2 の新機能 下限 (expr) 特定の式の値を小文字にしたものを返します。
V2 の新機能 random_string (長さ) 英字 (a から z、A から Z) をランダムに組み合わせたストリングを返します。
V2 の新機能 空 (パス) 特定のパス式の値が空の場合に true を返します。
V2 pad_left (expr, length, padValue) 特定の式の値を左詰めしたものを返します。
V2 pad_right (expr, length, padValue) 特定の式の値を右詰めしたものを返します。
V2 の新機能 範囲 (開始、終了) 数値の範囲を配列として返します。
V2 の新機能 鍵 (パス) 特定のパス式にあるオブジェクトのキーを返します。
V2 の新機能 値 (パス) 特定のパス式にあるオブジェクトの値を返します。
V2 の新機能 項目 (パス) 特定のパス式にあるオブジェクトの項目を返します。

JPath 式で使用できる基本的な関数の例を以下の表に示します。

表 2. 関数の例
説明 状態 結果
照会における関数 照会の一部として関数を使用します。 { "array": [ { "id": 1, "timestamp": 1186978597 }, { "id": 2, "timestamp": 1286978597 }, { "id": 3, "timestamp": 17586978597 } ] } /array[@timestamp > time()] [ { "id": 3, "timestamp": 17586978597 } ]
最大のタイム・スタンプを持つイベントの検出 生成された数値の配列と組み合わせて max() 関数を使用します。 { "array": [ { "id": 1, "timestamp": 1186978597 }, { "id": 2, "timestamp": 1286978597 }, { "id": 3, "timestamp": 17586978597 } ] } max(/array/timestamp) 17586978597