数字操作函数和操作符

数字操作符

描述：加

示例：

openGauss=# SELECT 2+3 AS RESULT;
 result 
--------
      5
(1 row)

描述：减

示例：

openGauss=# SELECT 2-3 AS RESULT;
 result 
--------
     -1
(1 row)

描述：乘

示例：

openGauss=# SELECT 2*3 AS RESULT;
 result 
--------
      6
(1 row)

描述：除（除法操作符不会取整）

示例：

openGauss=# SELECT 4/2 AS RESULT;
 result 
--------
      2
(1 row)

openGauss=# SELECT 4/3 AS RESULT;
      result      
------------------
 1.33333333333333
(1 row)

+/-

描述：正/负

示例：

openGauss=# SELECT -2 AS RESULT;
 result 
--------
     -2
(1 row)

描述：模（求余）

示例：

openGauss=# SELECT 5%4 AS RESULT;
 result 
--------
      1
(1 row)

描述：绝对值

示例：

openGauss=# SELECT @ -5.0 AS RESULT;
 result 
--------
    5.0
(1 row)

描述：幂（指数运算）

示例：

openGauss=# SELECT 2.0^3.0 AS RESULT;
       result       
--------------------
 8.0000000000000000
(1 row)

描述：平方根

示例：

openGauss=# SELECT |/ 25.0 AS RESULT;
 result 
--------
      5
(1 row)

||/

描述：立方根

示例：

openGauss=# SELECT ||/ 27.0 AS RESULT;
 result 
--------
      3
(1 row)

描述：阶乘

示例：

openGauss=# SELECT 5! AS RESULT;
 result 
--------
    120
(1 row)

描述：阶乘（前缀操作符）

示例：

openGauss=# SELECT !!5 AS RESULT;
 result 
--------
    120
(1 row)

描述：二进制AND

示例：

openGauss=# SELECT 91&15  AS RESULT;
 result 
--------
     11
(1 row)

描述：二进制OR

示例：

openGauss=# SELECT 32|3  AS RESULT;
 result 
--------
     35
(1 row)

描述：二进制XOR

示例：

openGauss=# SELECT 17#5  AS RESULT;
 result 
--------
     20
(1 row)

描述：二进制NOT

示例：

openGauss=# SELECT ~1 AS RESULT;
 result 
--------
     -2
(1 row)

描述：二进制左移

示例：

openGauss=# SELECT 1<<4 AS RESULT;
 result 
--------
     16
(1 row)

描述：二进制右移

示例：

openGauss=# SELECT 8>>2 AS RESULT;
 result 
--------
      2
(1 row)

数字操作函数

abs(x)
描述：绝对值。
返回值类型：和输入相同。
示例：
```
openGauss=# SELECT abs(-17.4);
 abs
------
 17.4
(1 row)
```

acos(x)

描述：反余弦。

返回值类型：double precision

示例：

openGauss=# SELECT acos(-1);
       acos       
------------------
 3.14159265358979
(1 row)

asin(x)

描述：反正弦。

返回值类型：double precision

示例：

openGauss=# SELECT asin(0.5);
       asin       
------------------
 .523598775598299
(1 row)

atan(x)

描述：反正切。

返回值类型：double precision

示例：

openGauss=# SELECT atan(1);
       atan       
------------------
 .785398163397448
(1 row)

atan2(y, x)

描述：y/x的反正切。

返回值类型：double precision

示例：

openGauss=# SELECT atan2(2, 1);
      atan2
------------------
 1.10714871779409
(1 row)

bitand(integer, integer)
描述：计算两个数字与运算(&)的结果。
返回值类型：bigint类型数字。
示例：
```
openGauss=# SELECT bitand(127, 63);
 bitand 
--------
     63
(1 row)
```
cbrt(dp)
描述：立方根。
返回值类型：double precision
示例：
```
openGauss=# SELECT cbrt(27.0);
 cbrt
------
    3
(1 row)
```
ceil(x)
描述：不小于参数的最小的整数。
返回值类型：整数。
示例：
```
openGauss=# SELECT ceil(-42.8);
 ceil 
------
  -42
(1 row)
```
ceiling(dp or numeric)
描述：不小于参数的最小整数（ceil的别名）。
返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。
示例：
```
openGauss=# SELECT ceiling(-95.3);
 ceiling
---------
     -95
(1 row)
```

cos(x)

描述：余弦。

返回值类型：double precision

示例：

openGauss=# SELECT cos(-3.1415927);
        cos        
-------------------
 -.999999999999999
(1 row)

cot(x)

描述：余切。

返回值类型：double precision

示例：

openGauss=# SELECT cot(1);
       cot
------------------
 .642092615934331
(1 row)

degrees(dp)

描述：把弧度转为角度。

返回值类型：double precision

示例：

openGauss=# SELECT degrees(0.5);
     degrees
------------------
 28.6478897565412
(1 row)

div(y numeric, x numeric)
描述：y除以x的商的整数部分。
返回值类型：numeric
示例：
```
openGauss=# SELECT div(9,4);
 div
-----
   2
(1 row)
```
exp(x)
描述：自然指数。
返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。
示例：
```
openGauss=# SELECT exp(1.0);
        exp         
--------------------
 2.7182818284590452
(1 row)
```
floor(x)
描述：不大于参数的最大整数。
返回值类型：与输入相同。
示例：
```
openGauss=# SELECT floor(-42.8);
 floor 
-------
   -43
(1 row)
```

int1(in)

描述：将传入的text参数转换为int1类型值并返回。

返回值类型：int1

示例：

openGauss=# select int1('123');
 int1
------
 123
(1 row)
openGauss=# select int1('a');
 int1
------
   0
(1 row)

int2(in)
描述：将传入参数转换为int2类型值并返回。
支持的入参类型包括float4、float8、int16、numeric、text。
返回值类型：int2
示例：
```
openGauss=# select int2('1234');
 int2
------
 1234
(1 row)
openGauss=# select int2(25.3);
 int2
------
   25
(1 row)
```
int4(in)
描述：将传入参数转换为int4类型值并返回。
支持的入参类型包括bit、boolean、char、duoble precision、int16、numeric、real、smallint、text。
返回值类型：int4
示例：
```
openGauss=# select int4('789');
 int4
------
 789
(1 row)
openGauss=# select int4(99.9);
 int4
------
   99
(1 row)
```
float4(in)
描述：将传入参数转换为float4类型值并返回。支持的入参类型包括：bigint，duoble precision，int16, integer, numeric，smallint，text。
返回值类型：float4
示例：
```
openGauss=# select float4('789');
 float4
--------
    789
(1 row)

openGauss=# select float4(99.9);
 float4
--------
   99.9
(1 row)
```
float8(in)
描述：将传入参数转换为float8类型值并返回。支持的入参类型包括：bigint，int16, integer, numeric，real，smallint，text。
返回值类型：float8
示例：
```
openGauss=# select float8('789');
 float8
--------
    789
(1 row)

openGauss=# select float8(99.9);
 float8
--------
   99.9
(1 row)
```
int16(in)
描述：将传入参数转换为int16类型值并返回。支持的入参类型包括：bigint，boolean，double precision，integer，numeric，oid，real，smallint，tinyint。
返回值类型：int16
示例：
```
openGauss=# select int16('789');
 int16
--------
    789
(1 row)

openGauss=# select int16(99.9);
 int16
--------
   99
(1 row)
```
numeric(in)
描述：将传入参数转换为numeric类型值并返回。支持的入参类型包括：bigint，boolean，double precision，int16，integer，money，real，smallint。
返回值类型：numeric
示例：
```
openGauss=# select "numeric"('789');
 numeric
---------
     789
(1 row)

openGauss=# select "numeric"(99.9);
 numeric
---------
    99.9
(1 row)
```
oid(in)
描述：将传入参数转换为oid类型值并返回。支持的入参类型包括：bigint，int16。
返回值类型：oid

radians(dp)

描述：把角度转为弧度。

返回值类型：double precision

示例：

openGauss=# SELECT radians(45.0);
     radians
------------------
 .785398163397448
(1 row)

random()
描述：0.0到1.0之间的随机数。
返回值类型：double precision
示例：
```
openGauss=# SELECT random();
      random
------------------
 .824823560658842
(1 row)
```
multiply(x double precision or text, y double precision or text)
描述：x和y的乘积。仅支持multiply(x double precision, y text)和multiply(x text, y double precision)的两种场景。
返回值类型：double precision
示例：
```
openGauss=# SELECT multiply(9.0, '3.0');
     multiply         
-------------------
               27
(1 row)
openGauss=# SELECT multiply('9.0', 3.0);
     multiply         
-------------------
               27
(1 row)
```
ln(x)
描述：自然对数。
返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。
示例：
```
openGauss=# SELECT ln(2.0);
        ln         
-------------------
 .6931471805599453
(1 row)
```

log(x)

描述：以10为底的对数。

返回值类型：与输入相同。

示例：

openGauss=# SELECT log(100.0);
        log         
--------------------
 2.0000000000000000
(1 row)

log(b numeric, x numeric)

描述：以b为底的对数。

返回值类型：numeric

示例：

openGauss=# SELECT log(2.0, 64.0);
        log         
--------------------
 6.0000000000000000
(1 row)

mod(x,y)
描述：x/y的余数（模）。如果x是0，则返回0。
返回值类型：与参数类型相同。
示例：
```
openGauss=# SELECT mod(9,4);
 mod 
-----
   1
(1 row)
```
```
openGauss=# SELECT mod(9,0);
 mod 
-----
   9
(1 row)
```

pi()

描述：“π”常量。

返回值类型：double precision

示例：

openGauss=# SELECT pi();
        pi
------------------
 3.14159265358979
(1 row)

power(a double precision, b double precision)

描述：a的b次幂。

返回值类型：double precision

示例：

openGauss=# SELECT power(9.0, 3.0);
        power         
----------------------
 729.0000000000000000
(1 row)

round(x)
描述：离输入参数最近的整数。
返回值类型：与输入相同（double precision或者numeric类型）。
示例：
```
openGauss=# SELECT round(42.4);
 round 
-------
    42
(1 row)

openGauss=# SELECT round(42.6);
 round 
-------
    43
(1 row)
```
round(v numeric, s int)
描述：保留小数点后s位，s后一位进行四舍五入。
返回值类型：numeric
示例：
```
openGauss=# SELECT round(42.4382, 2);
 round
-------
 42.44
(1 row)
```
setseed(dp)
描述：为随后的random()调用设置种子(-1.0到1.0之间，包含)。
返回值类型：void
示例：
```
openGauss=# SELECT setseed(0.54823);
 setseed
---------

(1 row)
```
sign(x)
描述：输出此参数的符号。
返回值类型：-1表示负数，0表示0，1表示正数。
示例：
```
openGauss=# SELECT sign(-8.4);
 sign 
------
   -1
(1 row)
```

sin(x)

描述：正弦。

返回值类型：double precision

示例：

openGauss=# SELECT sin(1.57079);
       sin        
------------------
 .999999999979986
(1 row)

sqrt(x)
描述：平方根。
返回值类型：dp or numeric，不考虑隐式类型转换的情况下与输入相同。
示例：
```
openGauss=# SELECT sqrt(2.0);
       sqrt        
-------------------
 1.414213562373095
(1 row)
```

tan(x)

描述：正切。

返回值类型：double precision

示例：

openGauss=# SELECT tan(20);
       tan        
------------------
 2.23716094422474
(1 row)

trunc(x)
描述：截断（取整数部分）。
返回值类型：与输入相同。
示例：
```
openGauss=# SELECT trunc(42.8);
 trunc 
-------
    42
(1 row)
```
trunc(v numeric, s int)
描述：截断为s位小数。
返回值类型：numeric
示例：
```
openGauss=# SELECT trunc(42.4382, 2);
 trunc
-------
 42.43
(1 row)
```
smgrne(a smgr, b smgr)
描述：比较两个smgr类型整数是否不相等。
返回值类型：bool
smgreq(a smgr, b smgr)
描述：比较两个smgr类型整数是否相等。
返回值类型：bool
int1abs
描述：返回uint8类型数据的绝对值。
参数：tinyint
返回值类型：tinyint
int1and
描述：返回两个uint8类型数据按位与的结果。
参数：tinyint, tinyint
返回值类型：tinyint
int1cmp
描述：返回两个uint8类型数据比较的结果，若第一个参数大，则返回1；若第二个参数大，则返回-1；若相等，则返回0。
参数：tinyint, tinyint
返回值类型：integer
int1div
描述：返回两个uint8类型数据相除的结果，结果为float8类型。
参数：tinyint, tinyint
返回值类型：tinyint
int1eq
描述：比较两个uint8类型数据是否相等。
参数：tinyint, tinyint
返回值类型：boolean
int1ge
描述：判断两个uint8类型数据是否第一个参数大于等于第二个参数。
参数：tinyint, tinyint
返回值类型：boolean
int1gt
描述：无符号1字节整数做大于运算。
参数：tinyint, tinyint
返回值类型：boolean
int1larger
描述：无符号1字节整数求最大值。
参数：tinyint, tinyint
返回值类型：tinyint
int1le
描述：无符号1字节整数做小于等于运算。
参数：tinyint, tinyint
返回值类型：boolean
int1lt
描述：无符号1字节整数做小于运算。
参数：tinyint, tinyint
返回值类型：boolean
int1smaller
描述：无符号1字节整数求最小算。
参数：tinyint, tinyint
返回值类型：tinyint
int1inc
描述：无符号1字节整数加一。
参数：tinyint
返回值类型：tinyint
int1mi
描述：无符号一字节整数做差运算。
参数：tinyint, tinyint
返回值类型：tinyint
int1mod
描述：无符号一字节整数做取余运算。
参数：tinyint, tinyint
返回值类型：tinyint
int1mul
描述：无符号一字节整数做乘法运算。
参数：tinyint, tinyint
返回值类型：tinyint
int1ne
描述：无符号一字节整数不等于运算。
参数：tinyint, tinyint
返回值类型：boolean
int1pl
描述：无符号一字节整数加法。
参数：tinyint, tinyint
返回值类型：tinyint
int1um
描述：无符号一字节数去相反数并返回有符号二字节整数。
参数：tinyint
返回值类型：smallint
int1xor
描述：无符号一字节整数异或操作。
参数：tinyint, tinyint
返回值类型：tinyint
cash_div_int1
描述：对money类型进行除法运算。
参数：money, tinyint
返回值类型：money
cash_mul_int1
描述：对money类型进行乘法运算。
参数：money, tinyint
返回值类型：money
int1not
描述：无符号一字节整数二进制位翻转。
参数：tinyint
返回值类型：tinyint
int1or
描述：无符号一字节整数或运算。
参数：tinyint, tinyint
返回值类型：tinyint
int1shl
描述：无符号一字节整数左移指定位数。
参数：tinyint, integer
返回值类型：tinyint
width_bucket(op numeric, b1 numeric, b2 numeric, count int)
描述：返回一个桶，这个桶是在一个有count个桶，上界为b1下界为b2的等深柱图中operand将被赋予的那个桶。
返回值类型：int
示例：
```
openGauss=# SELECT width_bucket(5.35, 0.024, 10.06, 5);
 width_bucket
--------------
            3
(1 row)
```
width_bucket(op dp, b1 dp, b2 dp, count int)
描述：返回一个桶，这个桶是在一个有count个桶，上界为b1下界为b2的等深柱图中operand将被赋予的那个桶。
返回值类型：int
示例：
```
openGauss=# SELECT width_bucket(5.35, 0.024, 10.06, 5);
 width_bucket
--------------
            3
(1 row)
```