mod()

整数除算の余りを返します。

構文

mod(NUM_EXPR, DIVISOR)

パラメーター

NUM_EXPR
除算の被除数。32ビット整数または64ビット整数型である必要があります。
DIVISOR
除数。32ビット整数または64ビット整数型である必要があります。

説明

mod() 関数は、NUM_EXPR を DIVISOR で割った余りを64ビット整数で返します。

以下の場合に null を返します。

  • NUM_EXPR または DIVISOR が null の場合
  • NUM_EXPR または DIVISOR が整数型（32ビット整数、64ビット整数）でない場合
  • DIVISOR が0の場合（ゼロ除算の防止）

エラーコード

エラーコード説明
invalid-mod-args引数の数がちょうど2つでない場合

使用例

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

  1. HTTPステータスコードから百の位を除いた余りを計算します。

    table limit=5 WEB_APACHE_SAMPLE | eval result = mod(status, 100)
| fields status, result

  2. 0で割ると null を返します。

    json "{}" | eval r = mod(5, 0)
| # r: null

  3. NULL入力

    json "{}" | eval r = mod(null, 3)
| # r: null

互換性

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