No MariaDB,
ASIN()
é uma função numérica interna que retorna o arco-seno (seno inverso) de seu argumento. Em outras palavras, ele retorna o valor cujo seno é o argumento.
Sintaxe
A sintaxe fica assim:
ASIN(X)
Onde
X
é uma expressão válida que resolve para um número entre -1
e 1
. Exemplo
Aqui está um exemplo:
SELECT ASIN(0.317);
Resultado:
+--------------------+ | ASIN(0.317) | +--------------------+ | 0.3225646710420111 | +--------------------+
Aqui estão mais alguns exemplos:
SELECT
ASIN(0),
ASIN(-1),
ASIN(1);
Resultado:
+---------+---------------------+--------------------+ | ASIN(0) | ASIN(-1) | ASIN(1) | +---------+---------------------+--------------------+ | 0 | -1.5707963267948966 | 1.5707963267948966 | +---------+---------------------+--------------------+
Argumento fora do intervalo
O argumento deve estar entre
-1
e 1
. Caso contrário, null
é devolvido. Exemplo:
SELECT ASIN(2);
Resultado:
+---------+ | ASIN(2) | +---------+ | NULL | +---------+
Argumento não numérico
Veja o que acontece quando fornecemos um argumento não numérico:
SELECT ASIN('One');
Resultado:
+-------------+ | ASIN('One') | +-------------+ | 0 | +-------------+ 1 row in set, 1 warning (0.000 sec)
Vamos verificar o aviso:
SHOW WARNINGS;
Resultado:
+---------+------+-----------------------------------------+ | Level | Code | Message | +---------+------+-----------------------------------------+ | Warning | 1292 | Truncated incorrect DOUBLE value: 'One' | +---------+------+-----------------------------------------+
Argumento ausente
Chamando
ASIN()
sem um argumento resulta em um erro:SELECT ASIN();
Resultado:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'ASIN'