asin()

asin() 関数は入力値のアークサイン(逆サイン)をラジアン単位で返します。

構文

asin(NUM_EXPR)

パラメーター

NUM_EXPR
アークサインを求める数値式。-1以上1以下の値を渡す必要があります。

説明

asin() 関数は入力値にMath.asin()を適用した結果を64ビット浮動小数点(double)で返します。入力値がNumber型の場合、内部的にdoubleValue()で変換して処理します。

入力値がnullまたは数値でない場合はnullを返します。入力値が-1より小さいか1より大きい場合はNaNを返します。

エラーコード

該当なし

使用例

  1. サインが0の角度(0度)を計算する

    json "{'val': 0}" | eval result = asin(val)
    | # result: 0.0
    
  2. サインが1の角度(90度)を計算する

    json "{'val': 1}" | eval result = asin(val)
    | # result: 1.5707963267948966
    
  3. null入力

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

互換性

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