语法图

代码

tanh

tanh::= TANH  "(" expr ")" 

TANH函数返回其参数的双曲正切，参数大小本身无限制（只受限于其所属数据类型所规定范围）。

本函数的规则如下：

• expr的值为数值型或可以转换为NUMBER类型的字符型（转换失败返回Invalid number错误）。对于其他类型，函数返回类型不支持。

• 当expr的值为NULL时，函数返回NULL。

• 当expr的值为Nan、Inf、-Inf时，函数处理规则受配置参数MATH_FUNC_RETURN_DECIMAL影响：

  • 若MATH_FUNC_RETURN_DECIMAL = FALSE（默认值），处理规则如下：

    expr	TANH(expr)
    Nan	Nan
    Inf	1
    -Inf	-1

  • 若MATH_FUNC_RETURN_DECIMAL = TRUE，处理规则如下：

    expr	TANH(expr)
    Nan、Inf、-Inf	函数返回错误

• 当expr为其他有效值时，函数返回值类型同样受配置参数MATH_FUNC_RETURN_DECIMAL影响：

  • 若MATH_FUNC_RETURN_DECIMAL = TRUE且expr的值不含FLOAT或DOUBLE类型，函数返回NUMBER类型。

  • 否则，函数返回DOUBLE类型。

示例1

SHOW PARAMETER MATH_FUNC_RETURN_DECIMAL

NAME                                           VALUE
---------------------------------------------- --------------------------------
MATH_FUNC_RETURN_DECIMAL                    FALSE

SELECT TANH(1) res FROM DUAL;
RES
-----------
7.616E-001

SELECT TANH('1') res FROM DUAL;
RES
-----------
7.616E-001

SELECT TANH(b'1') res FROM DUAL;
RES
-----------
7.616E-001

示例2

SHOW PARAMETER MATH_FUNC_RETURN_DECIMAL

NAME                                           VALUE
---------------------------------------------- --------------------------------
MATH_FUNC_RETURN_DECIMAL                    TRUE

SELECT TANH(1) res FROM DUAL;
               RES
------------------
.76159415595576485

SELECT TANH('Nan') res FROM DUAL;
YAS-04426 the argument value is out of range