====== ACOS() ======




===== Версии сервера =====
^                       ^ 0.9 ^ 1.0 ^ 1.5.3 ^ 1.5.4 ^ 1.5.5 ^ 2.0 ^ 2.1 ^ 2.5 ^ 3.0 ^
^Как [[UDF]]            |  Да  |  Да  |  Да  |  Да  |  Да  |  Да  |  -  |  -  |  -  |
^Как встроенная функция |  -  |  -  |  -  |  -  |  -  |  -  |  Да  |  Да  |  Да  |


===== Доступно в =====
[[raznovidnosti_jazyka_sql|DSQL]],   [[raznovidnosti_jazyka_sql|ISQL]],   [[raznovidnosti_jazyka_sql|PSQL]]


===== Формат =====
<code>ACOS( < аргумент > )</code>
^ Аргумент ^ Описание ^
| < аргумент >  | Любой тип данных, приводимый к [[tipy_dannyx|DOUBLE PRECISION]] в интервале от -1..+1  |
| Возвращает | [[tipy_dannyx|DOUBLE PRECISION]] арккосинус числа в радианах |

===== Описание =====
Функция ACOS возвращает(в радинах) арккосинус числа, переданного в качестве параметра < аргумент >, значение которого должно находиться в интервале -1..1.

:!: В Firebird версии младше 2.1 для того, чтобы пользоваться этой функцией, ее небходимо подключить к базе данных как [[UDF]].


===== Объявление =====
1. В Firebird версии младше 2.1 функция объявляется как [[UDF]] в внешнем модуле "ib_udf".
<code sql>
DECLARE EXTERNAL FUNCTION ACOS
  DOUBLE PRECISION
RETURNS
  DOUBLE PRECISION BY VALUE
ENTRY_POINT "IB_UDF_acos" MODULE_NAME "ib_udf";
</code>

2. В Firebird версии 2.1 и старше является встроенной функцией при соглашении объявления ее как:
<code sql>
DECLARE EXTERNAL FUNCTION ACOS
  DOUBLE PRECISION
RETURNS
  DOUBLE PRECISION BY VALUE
ENTRY_POINT "acos" MODULE_NAME SYSTEM;
</code>





===== Пример =====
Допустим, существует таблица WND_PARAMS с доменами ID [[tipy_dannyx|INTEGER]], DIAG  [[tipy_dannyx|DOUBLE PRECISION]] - диагональ прямоугольника и  COS_DIAG [[tipy_dannyx|DOUBLE PRECISION]], который хранит отношение ширины прямоугольника к его диагонали (математически - косинус угла наклона диагонали). 

Требуется выбрать из таблицы все записи, указав ширину прямоугольника.

1) [[raznovidnosti_jazyka_sql|DSQL]],   [[raznovidnosti_jazyka_sql|ISQL]]
<code sql>
SELECT W.ID, (W.DIAG * ACOS(W.COS_DIAG)) AS WIDTH
FROM   WND W
</code>

2) [[raznovidnosti_jazyka_sql|PSQL]]
<code sql>
SET TERM !!!;

CREATE OR ALTER PROCEDURE WND_WIDTHS RETURNS (
   W_ID     INTEGER
  ,W_WIDTH  DOUBLE PRECISION
)AS
  DECLARE VARIABLE P_DIAG     DOUBLE PRECISION;
  DECLARE VARIABLE P_COS_DIAG DOUBLE PRECISION;
BEGIN
  FOR
    SELECT W.ID, W.DIAG, W.COS_DIAG
    FROM   WND W
    INTO   :W_ID, :P_DIAG, :P_COS_DIAG
  DO
  BEGIN
    W_WIDTH = :W_DIAG * ACOS(:P_COS_DIAG);
    SUSPEND;
  END
END !!!

SET TERM ; !!!
</code>


===== См. также =====
[[UDF]], [[vstroennye_funkcii|Встроенные функции]]

===== Источник =====
langref.pdf