This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content. For information on migrating to InterSystems IRIS , see How to Migrate to InterSystems IRIS, available on the WRC Distributions page (login required).

# COS

Returns the cosine of an angle.

## Synopsis

```COS(number)
```

### Arguments

 number An expression that resolves to a number that expresses an angle in degrees.

## Description

The COS function takes an angle in degrees and returns the ratio of two sides of a right triangle. The ratio is the length of the side adjacent to the angle divided by the length of the hypotenuse. This ratio is in the range of 1 to -1 (inclusive).

## Examples

The following example uses the COS function to return the cosine of an angle:

```Dim MyAngle
MyAngle = 1.3;         ! Define angle in degrees.
PRINT COS(MyAngle);    ! Returns cosine ratio.```

The following example uses the COS function to return the secant of an angle:

```Dim MyAngle, MySecant
MyAngle = 1.3;                ! Define angle in degrees.
MySecant = 1 / Cos(MyAngle);  ! Calculate secant.
Print MySecant;               ! Secant in radians.```